如何使用PHP 中的date_sunset() 函數獲取指定日期的日落時間？

M66 2025-06-29

在PHP 中， date_sunset()函數用於獲取指定日期和地點的日落時間。這對於開發天氣預報、日常規劃或地理相關的應用程序非常有用。下面，我們將詳細講解如何使用這個函數，並給出一個實際的例子。

date_sunset()函數的基本用法

date_sunset()函數的基本原型如下：

 date_sunset ( int $timestamp , int $returnFormat = SUNFUNCS_RET_STRING , float $latitude , float $longitude , float $zenith = 90.5 , float $gmt_offset = 0 )

參數說明：

$timestamp : 這個參數表示指定的時間戳。如果你傳入的時間戳是未來的日期，函數將返回未來的日落時間。
$returnFormat : 該參數決定返回的格式。默認值是SUNFUNCS_RET_STRING ，表示返回字符串格式（例如"18:30:00"）。你還可以選擇返回一個Unix 時間戳格式，或者返回一個帶有時間的數組。
$latitude和$longitude : 這兩個參數指定了觀察位置的緯度和經度。通過這些參數，PHP 能夠計算特定位置的日落時間。
$zenith : 該參數表示太陽的天文位置。默認值是90.5，表示天文學上定義的日落角度。你可以根據需要調整這個值。
$gmt_offset : 這個參數表示與GMT 的時差，默認為0。

示例代碼：獲取指定日期的日落時間

下面的示例代碼展示瞭如何使用date_sunset()函數獲取指定日期（例如"2025-04-25"）在特定位置（例如，北京）的日落時間。

 <?php
// 設置時區
date_default_timezone_set('Asia/Shanghai');

// 輸入日期和經緯度（北京的經緯度）
$date = '2025-04-25';
$latitude = 39.9042; // 北京緯度
$longitude = 116.4074; // 北京經度

// 將日期轉換為時間戳
$timestamp = strtotime($date);

// 使用 date_sunset() 獲取日落時間
$sunset = date_sunset($timestamp, SUNFUNCS_RET_STRING, $latitude, $longitude);

// 輸出日落時間
echo "指定日期：$date 的日落時間是：$sunset";
?>

解析代碼：

設置時區：我們通過date_default_timezone_set()函數設置時區為“Asia/Shanghai”，確保時間計算正確。
日期和位置：我們指定了一個日期（2025年4月25日）和北京的經緯度。
轉換時間戳：使用strtotime()函數將日期字符串轉換為時間戳。
調用date_sunset() ：該函數根據給定的時間戳、經緯度和其他參數，計算出日落時間。這裡我們選擇返回字符串格式。
輸出日落時間：最後，輸出計算出的日落時間。

輸出結果：

如果你運行以上代碼，輸出將類似於：

 指定日期：2025-04-25 的日落時間是：18:31:00

注意事項：

date_sunset()函數並非適用於所有日期。如果給定的日期無法計算日落時間（如極地地區的夏季或冬季），則可能返回false 。
經緯度的選擇非常重要，因為日落時間取決於你所處的地理位置。