date_sunset(3) [php man page]

DATE_SUNSET(3)								 1							    DATE_SUNSET(3)

date_sunset - Returns time of sunset for a given day and location

SYNOPSIS

       mixed  date_sunset  (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.sunset_zenith")], [float  $gmt_offset])

DESCRIPTION

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

PARAMETERS

	      o $timestamp
		- The $timestamp of the day from which the sunset 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.sunset_zenith

	      o $gmtoffset
		- Specified in hours.

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.					    |
       |	|						    |
       +--------+---------------------------------------------------+
RETURN VALUES

	Returns the sunset time in a specified $format on success or FALSE on failure.

EXAMPLES

       Example #1

	      date_sunset(3) example

	      <?php

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

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

	      ?>

	      The above example will output something similar to:

	      Mon Dec 20 2004, sunset time : 18:13

SEE ALSO

       date_sunrise(3).

PHP Documentation Group 													    DATE_SUNSET(3)

Check Out this Related Man Page

LOCALTIME(3)								 1							      LOCALTIME(3)

localtime - Get the local time

SYNOPSIS

       array localtime ([int  $timestamp = time()], [bool  $is_associative = false])

DESCRIPTION

	The localtime(3) function returns an array identical to that of the structure returned by the C function call.

PARAMETERS

	      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).

	      o $is_associative
		- If set to FALSE or not supplied then the array is returned as a regular, numerically indexed array. If the argument  is  set	to
		TRUE then localtime(3) returns an associative array containing all the different elements of the structure returned by the C func-
		tion call to localtime. The names of the different keys of the associative array are as follows:

		     o "tm_sec" - seconds,
		       0 to 59

		     o "tm_min" - minutes,
		       0 to 59

		     o "tm_hour" - hours,
		       0 to 23

		     o "tm_mday" - day of the month,
		       1 to 31

		     o "tm_mon" - month of the year,
		       0 (Jan) to 11 (Dec)

		     o "tm_year" - years since 1900

		     o "tm_wday" - day of the week,
		       0 (Sun) to 6 (Sat)

		     o "tm_yday" - day of the year,
		       0 to 365

		     o "tm_isdst" - is daylight savings time in effect?  Positive if yes,
		       0 if not, negative if unknown.

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

	      localtime(3) example

	      <?php
	      $localtime = localtime();
	      $localtime_assoc = localtime(time(), true);
	      print_r($localtime);
	      print_r($localtime_assoc);
	      ?>

	      The above example will output something similar to:

	      Array
	      (
		  [0] => 24
		  [1] => 3
		  [2] => 19
		  [3] => 3
		  [4] => 3
		  [5] => 105
		  [6] => 0
		  [7] => 92
		  [8] => 1
	      )

	      Array
	      (
		  [tm_sec] => 24
		  [tm_min] => 3
		  [tm_hour] => 19
		  [tm_mday] => 3
		  [tm_mon] => 3
		  [tm_year] => 105
		  [tm_wday] => 0
		  [tm_yday] => 92
		  [tm_isdst] => 1
	      )

SEE ALSO

       getdate(3).

PHP Documentation Group 													      LOCALTIME(3)

Linux and UNIX Man Pages

date_sunset(3) [php man page]

Check Out this Related Man Page