(PHP 5, PHP 7, PHP 8)
date_sunrise — 返回特定日期和位置的日出时间
该函数自 PHP 8.1.0 起已 弃用。强烈建议不要使用该函数。请改用 date_sun_info()。
$timestamp,$returnFormat = SUNFUNCS_RET_STRING,$latitude = null,$longitude = null,$zenith = null,$utcOffset = null
date_sunrise() 返回特定日期（以 timestamp 指定）和位置的日出时间。
timestamp获取日出时间的日期的 timestamp。
returnFormat
| 常量 | 描述 | 示例 |
|---|---|---|
| SUNFUNCS_RET_STRING | 返回 string 类型的结果 | 16:46 |
| SUNFUNCS_RET_DOUBLE | 返回 float 类型的结果 | 16.78243132 |
| SUNFUNCS_RET_TIMESTAMP | 返回 int（时间戳）类型的结果 | 1095034606 |
latitude默认为北纬，南纬则传入负值。另请参阅：date.default_latitude
longitude默认为东经，西经则传入负值。另请参阅：date.default_longitude
zenith
zenith 是太阳中心与地球表面垂直线之间的夹角。默认为 date.sunrise_zenith
| 角度 | 描述 |
|---|---|
| 90°50' | 日出：太阳开始可见的点。 |
| 96° | 民用曙暮光：传统上用于表示黎明开始的时刻。 |
| 102° | 航海曙暮光：地平线开始在海面上可见的点。 |
| 108° | 天文曙暮光：太阳开始成为任何照明的来源的点。 |
utcOffset以小时指定。如果 returnFormat 为 SUNFUNCS_RET_TIMESTAMP，则忽略 utcOffset。
成功时返回以指定 returnFormat 格式的日出时间，失败时返回 false。失败的一个可能原因是太阳根本没有升起，这种情况在极圈内一年中的部分时间内发生。
如果时区无效，则对日期/时间函数的每次调用都会生成一个 E_WARNING。另请参阅 date_default_timezone_set()
| 版本 | 描述 |
|---|---|
| 8.1.0 | 该函数已被弃用，请使用 date_sun_info() 代替。 |
| 8.0.0 |
latitude、longitude、zenith 和 utcOffset 现在可以为空。 |
示例 #1 date_sunrise() 示例
<?php
/* 计算葡萄牙里斯本的日出时间
纬度：北纬 38.4 度
经度：西经 9 度
天顶角 ~= 90
偏移量：+1 GMT
*/
echo date("D M d Y"). ', sunrise time : ' .date_sunrise(time(), SUNFUNCS_RET_STRING, 38.4, -9, 90, 1);
?>上述示例将输出类似以下内容
Mon Dec 20 2004, sunrise time : 08:54
示例 #2 没有日出
<?php
$solstice = strtotime('2017-12-21');
var_dump(date_sunrise($solstice, SUNFUNCS_RET_STRING, 69.245833, -53.537222));
?>上述示例将输出
bool(false)