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)