PHP date_sunrise() Function
Definition and Usage
The date_sunrise() function accepts a timestamp representing the given day and returns the sunrise time on that particular day.
Syntax
date_sunrise($timestamp, [$format, $latitude, $longitude, $zenith, $gmtoffset])
Parameters
| Sr.No | Parameter & Description |
|---|---|
| 1 |
timestamp (Mandatory) This specifies a timestamp. |
| 2 |
format (Optional) This specifies the format in which you need the resultant value in. You can pass three constants as the value of this parameter namely; SUNFUNCS_RET_STRING (string), SUNFUNCS_RET_DOUBLE (float) and, SUNFUNCS_RET_TIMESTAMP integer. |
| 3 |
latitude (Optional) This specifies latitude of a location by default, this specifies the North direction. To specify a latitude value in south you need to pass it as a negative value. |
| 4 |
longitude (Optional) This specifies longitude of a location by default, this specifies the East direction. To specify a latitude value in West you need to pass it as a negative value. |
| 5 |
zenith (Optional) This specifies zenith value. This specifies the angle between the line perpendicular to the earth's surface and the centre of the sun. |
| 6 |
gmtoffset (Optional) This specifies the difference between GMT and local time in hours. |
Return Values
PHP date_sunrise() function returns the time of the sunrise in desired format. Incase of failure, it returns the boolean value false.
PHP Version
This function was first introduced in PHP Version 5.0 and, works with all the later versions.
Example
Following example demonstrates the usage of the date_sunrise() function −
Live Demo
<?php
$sun_info = date_sunrise("02-17-2012");
print_r($sun_info);
?>
This will produce following result −
04:39
Example
Now lets invoke this function by, passing latitude and longitude values. If you want to pass latitude and longitude values it is mandatory to pass the value of required format too −
Live Demo
<?php
$sun_info = date_sunrise("02-03-2020",SUNFUNCS_RET_STRING, 23.4, -25);
print_r("Sunrise Time: ".$sun_info);
?>
This will produce following result −
Sunrise Time: 08:21
Example
Following example verifies the case of no sunrise −
<?php
$sun_info = date_sunrise("25-12-2016",SUNFUNCS_RET_STRING, 69, 41);
print("Sunrise Time: ".$sun_info);
print("\n");
var_dump($sun_info);
?>
This will produce following result −
Sunrise Time: bool(false)
Example
<?php
echo("Date: " . date("D M d Y"));
echo("\n");
echo("Sunrise time: ");
echo(date_sunrise(time(),SUNFUNCS_RET_STRING,38.4,-9,90,1));
?>
This will produce following result −
Date: Thu May 07 2020 Sunrise time: 06:34