萬盛學電腦網

您现在的位置: 萬盛學電腦網 >> 程式設計 >  >> 網路程式設計 >> PHP 程式設計

PHP 計算日出日落時間:date_sunrise() 與 date_sunset() 參數詳解與實戰

函數原型

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]   => ...
)
*/
copyright © 萬盛學電腦網 all rights reserved