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)

DATE_SUNRISE(3) 							 1							   DATE_SUNRISE(3)

date_sunrise - Returns time of sunrise for a given day and location

SYNOPSIS

       mixed  date_sunrise  (int   $timestamp, [int  $format = SUNFUNCS_RET_STRING], [float  $latitude = ini_get("date.default_latitude")], [float
       $longitude = ini_get("date.default_longitude")], [float	$zenith = ini_get("date.sunrise_zenith")], [float  $gmt_offset])

DESCRIPTION

       date_sunrise(3) returns the sunrise time for a given day (specified as a $timestamp) and location.

PARAMETERS

	      o $timestamp
		- The $timestamp of the day from which the sunrise time is taken.

	      o $format
		-

	      $format constants

	      +-----------------------+-------------------------------------------+
	      |       constant	      | 					  |
	      | 		      | 					  |
	      | 		      | 	       description		  |
	      | 		      | 					  |
	      | 		      | 		 example		  |
	      | 		      | 					  |
	      +-----------------------+-------------------------------------------+
	      | SUNFUNCS_RET_STRING   | 					  |
	      | 		      | 					  |
	      | 		      |       returns the result as string	  |
	      | 		      | 					  |
	      | 		      | 		  16:46 		  |
	      | 		      | 					  |
	      | SUNFUNCS_RET_DOUBLE   | 					  |
	      | 		      | 					  |
	      | 		      |        returns the result as float	  |
	      | 		      | 					  |
	      | 		      | 	       16.78243132		  |
	      | 		      | 					  |
	      |SUNFUNCS_RET_TIMESTAMP | 					  |
	      | 		      | 					  |
	      | 		      | returns the result as integer (timestamp) |
	      | 		      | 					  |
	      | 		      | 	       1095034606		  |
	      | 		      | 					  |
	      +-----------------------+-------------------------------------------+
	      o $latitude
		- Defaults to North, pass in a negative value for South. See also: date.default_latitude

	      o $longitude
		- Defaults to East, pass in a negative value for West. See also: date.default_longitude

	      o $zenith
		- Default: date.sunrise_zenith

	      o $gmtoffset
		- Specified in hours.

RETURN VALUES

	Returns the sunrise time in a specified $format on success or FALSE 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.1.0	|						    |
       |	|						    |
       |	|  Now	issues	the E_STRICT and E_NOTICE time zone |
       |	| errors.					    |
       |	|						    |
       +--------+---------------------------------------------------+
EXAMPLES

       Example #1

	      date_sunrise(3) example

	      <?php

	      /* calculate the sunrise time for Lisbon, Portugal
	      Latitude: 38.4 North
	      Longitude: 9 West
	      Zenith ~= 90
	      offset: +1 GMT
	      */

	      echo date("D M d Y"). ', sunrise time : ' .date_sunrise(time(), SUNFUNCS_RET_STRING, 38.4, -9, 90, 1);

	      ?>

	      The above example will output something similar to:

	      Mon Dec 20 2004, sunrise time : 08:54

SEE ALSO

       date_sunset(3).

PHP Documentation Group 													   DATE_SUNRISE(3)