PHP Tutorial - PHP date_sunrise() Function






Definition

The date_sunrise() function returns the sunrise time for a specified day and location.

date_sunset() function returns the sunset time for a specified day and location.

Syntax

PHP date_sunrise() Function has the following syntax.

date_sunrise(timestamp,format,latitude,longitude,zenith,gmtoffset);

Parameter

ParameterIs RequiredDescription
timestampRequired.timestamp of the day from which the sunrise time is taken
formatOptional.returned value format
latitudeOptional.Latitude of the location. Defaults to North. To specify a value for South, pass in a negative value
longitudeOptional.Longitude of the location. Defaults to East. To specify a value for West, pass in a negative value
zenithOptional.Defaults to date.sunrise_zenith
gmtoffsetOptional.Difference between GMT and local time in hours

Format available values.

ValueDescription
SUNFUNCS_RET_STRINGreturns the result as string. e.g. 15:46) (This is default)
SUNFUNCS_RET_DOUBLEreturns the result as float. e.g. 12.123456)
SUNFUNCS_RET_TIMESTAMPreturns the result as integer (timestamp). e.g. 1211233211)




Return

PHP date_sunrise() Function returns the time of the sunrise, in the specified format, on success. FALSE on failure.

Example

Return the sunrise time for Lisbon, Portugal today:


    // Lisbon, Portugal:
    // Latitude: 38.4 North, Longitude: 9 West
    // Zenith ~= 90, offset: +1 GMT
<?php
echo("Lisbon, Portugal: Date: " . date("D M d Y"));
echo("Sunrise time: ");
echo(date_sunrise(time(),SUNFUNCS_RET_STRING,18.1,-9,80,1));
?>

The code above generates the following result.