(PHP 5 >= 5.1.2, PHP 7, PHP 8)
date_sun_info — 返回一个包含日出/日落和晨昏蒙影开始/结束信息的数组
timestampUnix 时间戳。
latitude纬度（度）。
longitude经度（度）。
返回一个数组，其结构在下面的列表中详细说明
sunrisesunsettransitcivil_twilight_beginsunrise结束。
civil_twilight_endsunset开始。
nautical_twilight_begincivil_twilight_begin结束。
nautical_twilight_endcivil_twilight_end开始。
astronomical_twilight_beginnautical_twilight_begin结束。
astronomical_twilight_endnautical_twilight_end开始。
数组元素的值要么是UNIX时间戳，如果太阳整天都在相应的天顶角以下，则为false，如果太阳整天都在相应的天顶角以上，则为true。
| 版本 | 描述 |
|---|---|
| 7.2.0 | 计算已针对当地午夜而不是当地正午进行了修正，这会略微改变结果。 |
示例 #1 一个date_sun_info()示例
<?php
$sun_info = date_sun_info(strtotime("2006-12-12"), 31.7667, 35.2333);
foreach ($sun_info as $key => $val) {
echo "$key: " . date("H:i:s", $val) . "\n";
}
?>以上示例将输出
sunrise: 05:52:11 sunset: 15:41:21 transit: 10:46:46 civil_twilight_begin: 05:24:08 civil_twilight_end: 16:09:24 nautical_twilight_begin: 04:52:25 nautical_twilight_end: 16:41:06 astronomical_twilight_begin: 04:21:32 astronomical_twilight_end: 17:12:00
示例 #2 极夜，带一些处理
<?php
$tz = new \DateTimeZone('America/Anchorage');
$si = date_sun_info(strtotime("2022-12-21"), 70.21, -148.51);
foreach ($si as $key => $value) {
echo
match ($value) {
true => 'always',
false => 'never',
default => date_create("@{$value}")->setTimeZone($tz)->format( 'H:i:s T' ),
},
": {$key}",
"\n";
}
?>以上示例将输出
never: sunrise never: sunset 12:52:18 AKST: transit 10:53:19 AKST: civil_twilight_begin 14:51:17 AKST: civil_twilight_end 09:01:47 AKST: nautical_twilight_begin 16:42:48 AKST: nautical_twilight_end 07:40:47 AKST: astronomical_twilight_begin 18:03:49 AKST: astronomical_twilight_end
示例 #3 极昼（挪威特罗姆瑟）
<?php
$si = date_sun_info(strtotime("2022-06-26"), 69.68, 18.94);
print_r($si);
?>以上示例将输出
Array
(
[sunrise] => 1
[sunset] => 1
[transit] => 1656240426
[civil_twilight_begin] => 1
[civil_twilight_end] => 1
[nautical_twilight_begin] => 1
[nautical_twilight_end] => 1
[astronomical_twilight_begin] => 1
[astronomical_twilight_end] => 1
)
示例 #4 计算日长（基辅）
<?php
$si = date_sun_info(strtotime('2022-08-26'), 50.45, 30.52);
$diff = $si['sunset'] - $si['sunrise'];
echo "日长: ",
floor($diff / 3600), "小时 ",
floor(($diff % 3600) / 60), "秒\n";
?>以上示例将输出
Length of day: 13h 56s
