中文(繁體)
中文(繁體)
在PHP 中， date_sunset()函數用於計算給定日期和地點的日落時間。默認情況下，這個函數返回的是基於服務器默認時區的時間。如果服務器時區設置與目標地點時區不同，就可能導致獲取的日落時間不准確。本文將詳細介紹如何調整date_sunset()函數的時區參數，確保獲取正確的日落時間。
date_sunset()函數的基本語法如下：
date_sunset(
int $timestamp,
int $format = SUNFUNCS_RET_STRING,
float $latitude = ini_get("date.default_latitude"),
float $longitude = ini_get("date.default_longitude"),
float $zenith = ini_get("date.sunset_zenith"),
float $gmt_offset = 0
): string|int|float|false
$timestamp ：日期時間的Unix 時間戳
$format ：返回值格式，常用字符串格式（ SUNFUNCS_RET_STRING ）或時間戳格式（ SUNFUNCS_RET_TIMESTAMP ）
$latitude 、 $longitude ：地理坐標
$zenith ：太陽高度角，默認即可
$gmt_offset ：時區偏移（相對於GMT 的小時數）
date_sunset()最後一個參數$gmt_offset是調整時區的關鍵。它是相對於格林尼治標準時間的小時數，比如：
北京時間（UTC+8）傳入8
紐約時間（UTC-5）傳入-5
正確傳入$gmt_offset可以讓函數返回該時區的準確日落時間。
以下示例展示如何用date_sunset()獲取北京時間的日落時間：
<?php
// 設置時區，影響 date() 等函數的輸出，但不影響 date_sunset 的計算
date_default_timezone_set('Asia/Shanghai');
// 獲取今天的時間戳
$timestamp = time();
// 設置地理坐標（北京）
$latitude = 39.9042;
$longitude = 116.4074;
// 設置時區偏移，北京時間是 +8
$gmt_offset = 8;
// 獲取日落時間，返回格式為字符串 "HH:MM"
$sunset_time = date_sunset($timestamp, SUNFUNCS_RET_STRING, $latitude, $longitude, 90, $gmt_offset);
echo "北京時間的日落時間是：$sunset_time";
?>
這段代碼輸出類似：
北京時間的日落時間是：18:45
$gmt_offset需要和$latitude 、 $longitude對應的時區一致。
PHP 服務器時區不影響date_sunset的時區計算，但會影響date()和其他時間函數的輸出。
如果要處理夏令時，需要根據日期動態調整$gmt_offset ，或者使用更複雜的日期時間庫（如DateTime配合DateTimeZone ）計算更準確的時刻。
date_sunset()不支持自動識別夏令時，如果需要更精準處理時區，可以先用DateTime獲取帶時區的時間戳，再傳入date_sunset() 。
示例：
<?php
// 目標時區
$timezone = new DateTimeZone('America/New_York');
// 指定日期時間
$date = new DateTime('now', $timezone);
// 獲取時間戳
$timestamp = $date->getTimestamp();
// 地理坐標（紐約）
$latitude = 40.7128;
$longitude = -74.0060;
// 獲取時區偏移（小時）
$gmt_offset = $timezone->getOffset($date) / 3600;
// 獲取日落時間
$sunset_time = date_sunset($timestamp, SUNFUNCS_RET_STRING, $latitude, $longitude, 90, $gmt_offset);
echo "紐約时间的日落时间是：$sunset_time";
?>
這樣可以根據目標時區自動調整偏移，避免手動計算錯誤。
date_sunset()的$gmt_offset參數決定了返回的日落時間的時區。
手動傳入正確的時區偏移，可以保證結果準確。
結合DateTime和DateTimeZone可以更靈活地處理複雜時區和夏令時。
