gmdate(3) [php man page]

GMDATE(3)								 1								 GMDATE(3)

gmdate - Format a GMT/UTC date/time

SYNOPSIS

       string gmdate (string  $format, [int  $timestamp = time()])

DESCRIPTION

	Identical to the date(3) function except that the time returned is Greenwich Mean Time (GMT).

PARAMETERS

	      o $format
		- The format of the outputted date string. See the formatting options for the date(3) function.

	      o $timestamp
		-  The	optional  $timestamp parameter is an integer Unix timestamp that defaults to the current local time if a $timestamp is not
		given. In other words, it defaults to the value of time(3).

RETURN VALUES

	Returns a formatted date string. If a non-numeric value is used for $timestamp, FALSE is returned and an E_WARNING level error is emitted.

CHANGELOG

       +--------+---------------------------------------------------+
       |Version |						    |
       |	|						    |
       |	|		     Description		    |
       |	|						    |
       +--------+---------------------------------------------------+
       | 5.1.0	|						    |
       |	|						    |
       |	|  The valid range of a timestamp is typically from |
       |	| Fri, 13 Dec 1901 20:45:54 GMT to Tue, 19 Jan 2038 |
       |	| 03:14:07 GMT. (These are the	dates  that  corre- |
       |	| spond  to  the  minimum  and maximum values for a |
       |	| 32-bit signed integer). However, before PHP 5.1.0 |
       |	| this	 range	 was  limited  from  01-01-1970  to |
       |	| 19-01-2038 on some systems (e.g. Windows).	    |
       |	|						    |
       | 5.1.1	|						    |
       |	|						    |
       |	|  There are useful constants of standard date/time |
       |	| formats  that  can be used to specify the $format |
       |	| parameter.					    |
       |	|						    |
       +--------+---------------------------------------------------+
EXAMPLES

       Example #1

	      gmdate(3) example

	       When run in Finland (GMT +0200), the first line below prints "Jan  01  1998  00:00:00",	while  the  second  prints  "Dec  31  1997
	      22:00:00".

	      <?php
	      echo date("M d Y H:i:s", mktime(0, 0, 0, 1, 1, 1998));
	      echo gmdate("M d Y H:i:s", mktime(0, 0, 0, 1, 1, 1998));
	      ?>

SEE ALSO

       date(3), mktime(3), gmmktime(3), strftime(3).

PHP Documentation Group 														 GMDATE(3)

DATETIME.__CONSTRUCT(3) 						 1						   DATETIME.__CONSTRUCT(3)

DateTime::__construct - Returns new DateTime object

       Object oriented style

SYNOPSIS

       public DateTime::__construct NULL ([string  $time = "now"], [DateTimeZone  $timezone])

DESCRIPTION

       Procedural style
       DateTime date_create NULL ([string  $time = "now"], [DateTimeZone  $timezone])

	Returns new DateTime object.

PARAMETERS

	      o $time
		-A  date/time  string. Valid formats are explained in Date and Time Formats. Enter NULL here to obtain the current time when using
		the $timezone parameter.

	      o $timezone
		- A DateTimeZone object representing the timezone of $time.  If $timezone is omitted, the current timezone will be used.

	      Note

		      The $timezone parameter and the current timezone are ignored when the $time parameter  either  is  a  UNIX  timestamp  (e.g.
		     @946684800) or specifies a timezone (e.g.	2010-01-28T15:00:00+02:00).

RETURN VALUES

	Returns a new DateTime instance. Procedural style returns FALSE on failure.

ERRORS
/EXCEPTIONS
	Emits Exception in case of an error.

CHANGELOG

       +--------+---------------------------------------------------+
       |Version |						    |
       |	|						    |
       |	|		     Description		    |
       |	|						    |
       +--------+---------------------------------------------------+
       | 5.3.0	|						    |
       |	|						    |
       |	|  If  $time  contains an invalid date/time format, |
       |	| then an exception is now  thrown.  Previously  an |
       |	| error was emitted.				    |
       |	|						    |
       +--------+---------------------------------------------------+
EXAMPLES

       Example #1

	      DateTime.__construct(3) example

	      Object oriented style

	      <?php
	      try {
		  $date = new DateTime('2000-01-01');
	      } catch (Exception $e) {
		  echo $e->getMessage();
		  exit(1);
	      }

	      echo $date->format('Y-m-d');
	      ?>

	      Procedural style

	      <?php
	      $date = date_create('2000-01-01');
	      if (!$date) {
		  $e = date_get_last_errors();
		  foreach ($e['errors'] as $error) {
		      echo "$error
";
		  }
		  exit(1);
	      }

	      echo date_format($date, 'Y-m-d');
	      ?>

	      The above examples will output:

	      2000-01-01

       Example #2

	      Intricacies of DateTime.__construct(3)

	      <?php
	      // Specified date/time in your computer's time zone.
	      $date = new DateTime('2000-01-01');
	      echo $date->format('Y-m-d H:i:sP') . "
";

	      // Specified date/time in the specified time zone.
	      $date = new DateTime('2000-01-01', new DateTimeZone('Pacific/Nauru'));
	      echo $date->format('Y-m-d H:i:sP') . "
";

	      // Current date/time in your computer's time zone.
	      $date = new DateTime();
	      echo $date->format('Y-m-d H:i:sP') . "
";

	      // Current date/time in the specified time zone.
	      $date = new DateTime(null, new DateTimeZone('Pacific/Nauru'));
	      echo $date->format('Y-m-d H:i:sP') . "
";

	      // Using a UNIX timestamp.  Notice the result is in the UTC time zone.
	      $date = new DateTime('@946684800');
	      echo $date->format('Y-m-d H:i:sP') . "
";

	      // Non-existent values roll over.
	      $date = new DateTime('2000-02-30');
	      echo $date->format('Y-m-d H:i:sP') . "
";
	      ?>

	      The above example will output something similar to:

	      2000-01-01 00:00:00-05:00
	      2000-01-01 00:00:00+12:00
	      2010-04-24 10:24:16-04:00
	      2010-04-25 02:24:16+12:00
	      2000-01-01 00:00:00+00:00
	      2000-03-01 00:00:00-05:00

SEE  ALSO  
DateTime.createFromFormat(3),  DateTimeZone.__construct(3),	Date  and  Time  Formats,  date.timezone  ini  setting, date_default_time-
       zone_set(3), DateTime.getLastErrors(3), checkdate(3).
PHP Documentation Group 												   DATETIME.__CONSTRUCT(3)