Curriculum
Course: PHP Basic
Login

Curriculum

PHP Basic

PHP Install

0/1

PHP Casting

0/1

PHP Constants

0/1

PHP Magic Constants

0/1

PHP Operators

0/1

PHP Reference

0/276
Text lesson

date_sunrise()

Example

Retrieve the sunrise time for Lisbon, Portugal, for 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));
?>

Definition and Usage

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

 

Tip: Use the date_sunset() function to obtain the sunset time for a specific day and location.

Syntax

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

Parameter Values

 

Parameter

Description

timestamp

Required. Specifies the timestamp of the day for which the sunrise time is calculated.

format

Optional. Specifies the format of the returned result:

  • SUNFUNCS_RET_STRING (returns the result as a string, e.g., 16:46) (default)
  • SUNFUNCS_RET_DOUBLE (returns the result as a float, e.g., 16.78243132)
  • SUNFUNCS_RET_TIMESTAMP (returns the result as an integer timestamp, e.g., 1095034606)

latitude

Optional. Specifies the latitude of the location. Defaults to North; for Southern Hemisphere, use a negative value.

longitude

Optional. Specifies the longitude of the location. Defaults to East; for Western Hemisphere, use a negative value.

zenith

Optional. Defaults to date.sunrise_zenith.

gmtoffset

Optional. Specifies the difference in hours between GMT and local time.

Technical Details

Return Value:

Returns the sunrise time in the specified format on success; FALSE on failure.

PHP Version:

5+

PHP Changelog:

In PHP 5.1, this function now triggers E_STRICT and E_NOTICE time zone errors.