函數原型
date_sunrise(int $timestamp, int $format = SUNFUNCS_RET_STRING, float $latitude, float $longitude, float $zenith = 90.583333, float $gmt_offset = 0): string|float|int|false
date_sunset (參數相同)
參數說明
| 參數 | 說明 | 預設/備註 |
timestamp | 日期時間戳 | 必填,通常用 time() |
format | 返回格式 | SUNFUNCS_RET_STRING (16:46)、SUNFUNCS_RET_DOUBLE (16.78)、SUNFUNCS_RET_TIMESTAMP (時間戳) |
latitude | 緯度 | 北緯為正,南緯為負 |
longitude | 經度 | 東經為正,西經為負 |
zenith | 天頂角 | 90.583333(官方日出/日落)、96(民用曙光)、102(航海曙光)、108(天文曙光) |
gmt_offset | 時區偏移(小時) | 如台灣 +8,紐約 -5 |
實戰範例:台北 101 日出日落
<?php
date_default_timezone_set('Asia/Taipei');
$lat = 25.033964; // 台北 101 緯度
$lon = 121.564468; // 台北 101 經度
$zenith = 90.583333;
$offset = 8;
$today = time();
echo "日期: " . date('Y-m-d', $today) . "<br>";
echo "日出: " . date_sunrise($today, SUNFUNCS_RET_STRING, $lat, $lon, $zenith, $offset) . "<br>";
echo "日落: " . date_sunset($today, SUNFUNCS_RET_STRING, $lat, $lon, $zenith, $offset) . "<br>";
// 額外:曙光時間
echo "民用曙光: " . date_sunrise($today, SUNFUNCS_RET_STRING, $lat, $lon, 96, $offset) . "<br>";
echo "天文曙光: " . date_sunrise($today, SUNFUNCS_RET_STRING, $lat, $lon, 108, $offset) . "<br>";
?>
輸出範例(2024-03-01 台北)
日期: 2024-03-01
日出: 06:12
日落: 17:48
民用曙光: 05:48
天文曙光: 05:12
注意事項
- 極地地區(緯度 > 66.5°)可能出現極晝/極夜,函數返回
false。
- 精度受大氣折射、海拔影響,天文級應用請用專業天文庫(如
astronomy-engine)。
- PHP 8.1+ 標記此函數為
deprecated,建議改用 date_sun_info() 一次取得所有資訊。
現代替代:date_sun_info()
$info = date_sun_info(time(), $lat, $lon);
print_r($info);
/*
Array
(
[sunrise] => 1709235120 // timestamp
[sunset] => 1709278080
[transit] => 1709256600 // 正午
[civil_twilight_begin] => ...
[civil_twilight_end] => ...
[nautical_twilight_begin] => ...
[nautical_twilight_end] => ...
[astronomical_twilight_begin] => ...
[astronomical_twilight_end] => ...
)
*/