Latest web development tutorials
 

PHP date_sunrise() Function

< PHP Date/Time Reference

Example

Return the sunrise time for Lisbon, Portugal today:

<?php
// Lisbon, Portugal:
// Latitude: 38.4 North, Longitude: 9 West
// Zenith ~= 90, offset: +1 GMT

echo("Lisbon, Portugal: Date: " . date("D M d Y"));
echo("<br>Sunrise time: ");
echo(date_sunrise(time() ,SUNFUNCS_RET_STRING,38.4,-9,90,1));
?>
Run example »

Definition and Usage

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

Tip: Look at the date_sunset() function to return the sunset time for a specified day and location.


Syntax

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

Parameter Description
timestamp Required. Specifies the timestamp of the day from which the sunrise time is taken
format

Optional. Specifies how to return the result:

  • SUNFUNCS_RET_STRING (returns the result as string. e.g. 16:46) (This is default)
  • SUNFUNCS_RET_DOUBLE (returns the result as float. e.g. 16.78243132)
  • SUNFUNCS_RET_TIMESTAMP (returns the result as integer (timestamp). e.g. 1095034606)
latitude Optional. Specifies the latitude of the location. Defaults to North. To specify a value for South, pass in a negative value
longitude Optional. Specifies the longitude of the location. Defaults to East. To specify a value for West, pass in a negative value
zenith Optional. Defaults to date.sunrise_zenith
gmtoffset Optional. Specifies the difference between GMT and local time in hours

Technical Details

Return Value: Returns the time of the sunrise, in the specified format, on success. FALSE on failure
PHP Version: 5+
Changelog: From PHP 5.1.0 this function issues E_STRICT and E_NOTICE time zone errors

< PHP Date/Time Reference