使用date_sunset() 獲取指定城市的日落時間

M66 2025-05-31

在PHP 中， date_sunset()是一個非常實用的函數，可以幫助我們獲取特定城市的日落時間。這個函數通過地理位置（經緯度）來計算太陽的日落時間，適用於需要動態展示日落時間的場景。

1. 什麼是date_sunset()函數？

date_sunset()函數接受一些參數來計算日落時間。它的語法如下：

 int date_sunset ( int $timestamp , int $format , float $latitude , float $longitude [, float $zenith [, float $gmt_offset ]] )

$timestamp ：指定日期和時間戳，默認是當前時間。
$format ：輸出的格式，常用的值有：
- SUNFUNCS_RET_TIMESTAMP ：返回Unix 時間戳。
- SUNFUNCS_RET_STRING ：返回日期時間的字符串。
- SUNFUNCS_RET_DOUBLE ：返回日落時間的小時數（24小時制）。
$latitude和$longitude ：指定地理位置的緯度和經度（單位：度）。
$zenith ：太陽的天頂角（默認是90.5，即日落時的太陽角度）。
$gmt_offset ：時區偏移量。

2. 示例代碼：獲取某個城市的日落時間

以下是一個使用date_sunset()獲取某個城市（例如紐約）日落時間的代碼示例：

 <?php
// 設置紐約的經緯度
$latitude = 40.7128;  // 緯度
$longitude = -74.0060; // 經度

// 獲取當前時間戳
$timestamp = time();

// 獲取日落時間，格式為時間戳
$sunset = date_sunset($timestamp, SUNFUNCS_RET_TIMESTAMP, $latitude, $longitude);

// 將日落時間格式化為易讀的字符串（例如：Y-m-d H:i:s）
echo "紐約的日落時間是：" . date("Y-m-d H:i:s", $sunset);
?>

3. 解析代碼

通過設定紐約的經緯度（ 40.7128和-74.0060 ），我們可以計算出紐約的日落時間。
使用time()函數獲取當前時間戳，傳遞給date_sunset()來獲取當天的日落時間。
SUNFUNCS_RET_TIMESTAMP參數讓返回值是Unix 時間戳，然後使用date()函數將其格式化為標準的日期和時間格式。

4. 使用URL 與date_sunset()結合

假設您希望將這個日落時間與城市的相關信息進行展示，可以通過調用一個API 獲取城市信息。以下是一個結合了date_sunset()和外部API 的例子。在此例中，假設我們訪問的API 域名為m66.net ：

 <?php
// API 地址
$api_url = "https://api.m66.net/city_info?city=New+York";

// 獲取城市信息
$response = file_get_contents($api_url);
$data = json_decode($response, true);

// 假设城市的经緯度在 API 返回的數據中
$latitude = $data['latitude'];
$longitude = $data['longitude'];

// 獲取當前時間戳
$timestamp = time();

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

// 將日落時間格式化為易讀的字符串
echo "紐約的日落時間是：" . date("Y-m-d H:i:s", $sunset);
?>

5. 總結

通過使用date_sunset()函數，我們可以輕鬆地計算出任何給定城市的日落時間。只需提供該城市的經緯度，就能夠得到準確的日落時間，並將其格式化為便於閱讀的格式。如果需要獲取多個城市的日落時間，可以通過API 動態獲取城市信息，並結合date_sunset()函數進行處理。