ts(1) [netbsd man page]

TS(1)																	     TS(1)

NAME

       ts - timestamp input

SYNOPSIS

       ts [-r] [format]

DESCRIPTION

       ts adds a timestamp to the beginning of each line of input.

       The optional format parameter controls how the timestamp is formatted, as used by strftime(3). The default format is "%b %d %H:%M:%S". In
       addition to the regular strftime conversion specifications, "%.S" and "%.s" are like "%S" and "%s", but provide subsecond resolution (ie,
       "30.00001" and "1301682593.00001").

       If the -r switch is passed, it instead converts existing timestamps in the input to relative times, such as "15m5s ago". Many common
       timestamp formats are supported. Note that the Time::Duration and Date::Parse perl modules are required for this mode to work.
       Currently,A converting localized dates is not supported.

       If both -r and a format is passed, the existing timestamps are converted to the specified format.

ENVIRONMENT

       The standard TZ environment variable controls what time zone dates are assumed to be in, if a timezone is not specified as part of the
       date.

AUTHOR

       Copyright 2006 by Joey Hess <joey@kitenet.net>

       Licensed under the GNU GPL.

moreutils							    2011-04-01								     TS(1)

STRTOTIME(3)								 1							      STRTOTIME(3)

strtotime - Parse about any English textual datetime description into a Unix timestamp

SYNOPSIS

       int strtotime (string  $time, [int  $now = time()])

DESCRIPTION

	The  function  expects to be given a string containing an English date format and will try to parse that format into a Unix timestamp (the
       number of seconds since January 1 1970 00:00:00 UTC), relative to the timestamp given in $now, or the current time if $now is not supplied.

	Each parameter of this function uses the default time zone unless a time zone is specified in that parameter. Be careful not to  use  dif-
       ferent  time  zones  in	each parameter unless that is intended. See date_default_timezone_get(3) on the various ways to define the default
       time zone.

PARAMETERS

	      o $time
		-A date/time string. Valid formats are explained in Date and Time Formats.

	      o $now
		- The timestamp which is used as a base for the calculation of relative dates.

RETURN VALUES

	Returns a timestamp on success, FALSE otherwise. Previous to PHP 5.1.0, this function would return -1 on failure.

ERRORS
/EXCEPTIONS
	Every call to a date/time function will generate a E_NOTICE if the time zone is not valid, and/or a E_STRICT or E_WARNING message if using
       the system settings or the $TZ environment variable. See also date_default_timezone_set(3)

CHANGELOG

       +--------+---------------------------------------------------+
       |Version |						    |
       |	|						    |
       |	|		     Description		    |
       |	|						    |
       +--------+---------------------------------------------------+
       | 5.3.0	|						    |
       |	|						    |
       |	|  Prior  to  PHP 5.3.0, relative time formats sup- |
       |	| plied to the $time argument of strtotime(3)  such |
       |	| as  this week, previous week, last week, and next |
       |	| week were interpreted to mean a 7 day period rel- |
       |	| ative  to  the  current  date/time, rather than a |
       |	| week period of Monday through Sunday. 	    |
       |	|						    |
       | 5.3.0	|						    |
       |	|						    |
       |	|  Prior to PHP 5.3.0, 24:00 was not a valid format |
       |	| and strtotime(3) returned FALSE.		    |
       |	|						    |
       | 5.2.7	|						    |
       |	|						    |
       |	|  In  PHP  5  prior  to  5.2.7, requesting a given |
       |	| occurrence of a given weekday in  a  month  where |
       |	| that weekday was the first day of the month would |
       |	| incorrectly add one week to  the  returned  time- |
       |	| stamp. This has been corrected in 5.2.7 and later |
       |	| versions.					    |
       |	|						    |
       | 5.1.0	|						    |
       |	|						    |
       |	|    Now returns FALSE on failure, instead of -1.   |
       |	|						    |
       | 5.1.0	|						    |
       |	|						    |
       |	|  Now issues the E_STRICT and E_NOTICE  time  zone |
       |	| errors.					    |
       |	|						    |
       | 5.0.2	|						    |
       |	|						    |
       |	|  In  PHP  5 up to 5.0.2, "now" and other relative |
       |	| times are wrongly computed from today's midnight. |
       |	| This differs from other versions where it is cor- |
       |	| rectly computed from current time.		    |
       |	|						    |
       | 5.0.0	|						    |
       |	|						    |
       |	|  Microseconds began to be allowed, but  they	are |
       |	| ignored.					    |
       |	|						    |
       +--------+---------------------------------------------------+
EXAMPLES

       Example #1

	      A strtotime(3) example

	      <?php
	      echo strtotime("now"), "
";
	      echo strtotime("10 September 2000"), "
";
	      echo strtotime("+1 day"), "
";
	      echo strtotime("+1 week"), "
";
	      echo strtotime("+1 week 2 days 4 hours 2 seconds"), "
";
	      echo strtotime("next Thursday"), "
";
	      echo strtotime("last Monday"), "
";
	      ?>

       Example #2

	      Checking for failure

	      <?php
	      $str = 'Not Good';

	      // previous to PHP 5.1.0 you would compare with -1, instead of false
	      if (($timestamp = strtotime($str)) === false) {
		  echo "The string ($str) is bogus";
	      } else {
		  echo "$str == " . date('l dS of F Y h:i:s A', $timestamp);
	      }
	      ?>

NOTES

       Note

	       If  the	number	of  the  year  is  specified  in a two digit format, the values between 00-69 are mapped to 2000-2069 and 70-99 to
	      1970-1999. See the notes below for possible differences on 32bit systems (possible dates might end on 2038-01-19 03:14:07).

       Note

	       The valid range of a timestamp is typically from Fri, 13 Dec 1901 20:45:54 UTC to Tue, 19 Jan 2038 03:14:07  UTC.  (These  are  the
	      dates that correspond to the minimum and maximum values for a 32-bit signed integer.)

	       Prior  to PHP 5.1.0, not all platforms support negative timestamps, therefore your date range may be limited to no earlier than the
	      Unix epoch. This means that e.g. dates prior to Jan 1, 1970 will not work on Windows, some Linux	distributions,	and  a	few  other
	      operating systems.

	       For 64-bit versions of PHP, the valid range of a timestamp is effectively infinite, as 64 bits can represent approximately 293 bil-
	      lion years in either direction.

       Note

	       Dates in the m/d/y or d-m-y formats are disambiguated by looking at the separator between the various components: if the  separator
	      is  a slash ( /), then the American m/d/y is assumed; whereas if the separator is a dash ( -) or a dot ( .), then the European d-m-y
	      format is assumed.

	       To avoid potential ambiguity, it's best to use ISO 8601 ( YYYY-MM-DD) dates or DateTime::createFromFormat when possible.

       Note

	       Using this function for mathematical operations is not advisable. It is better to use DateTime::add and DateTime::sub  in  PHP  5.3
	      and later, or DateTime::modify in PHP 5.2.

SEE ALSO

       Date and Time Formats, DateTime::createFromFormat, checkdate(3), strptime(3).

PHP Documentation Group 													      STRTOTIME(3)