使用date_sunset() 和mktime() 手動構建時間戳

M66 2025-05-31

在PHP 中， date_sunset()函數可以用來計算特定日期、經緯度下的日落時間。而有時候，我們還需要用mktime()來手動構建一個時間戳，以便更靈活地處理時區差異或進行進一步的時間計算。本文將通過一個實際的例子，講解如何正確使用這兩個函數。

第一步：使用mktime()手動生成時間戳

通常， mktime()可以幫助我們快速生成某一天某個時間的Unix 時間戳。例如，如果你想生成2025 年4 月26 日的12:00 中午的時間戳，可以這樣做：

 <?php
$timestamp = mktime(12, 0, 0, 4, 26, 2025);
echo "手動生成的時間戳是: " . $timestamp;
?>

這樣生成的$timestamp可以作為後續date_sunset()的輸入。

第二步：使用date_sunset()計算日落時間

date_sunset()接受一個時間戳，並根據指定的緯度和經度，計算出那一天的日落時間。基本用法如下：

 <?php
$latitude = 34.0522;  // 例如洛杉磯的緯程度
$longitude = -118.2437; // 洛杉磯的經程度

$sunset = date_sunset(
    $timestamp,
    SUNFUNCS_RET_STRING, // 返回格式，這裡是返回字符串格式
    $latitude,
    $longitude,
    90, // 海拔角程度，默認是90程度
    0 // GMT偏移量，這裡先設置為0
);

echo "日落時間（UTC）是: " . $sunset;
?>

注意：此時得到的時間是UTC 時間，並沒有根據你的本地時區調整。

第三步：處理時區差異

如果想要得到本地時區的日落時間，可以在date_sunset()中設置正確的GMT 偏移，或者手動換算。例如，北京時間（東八區）對應的是GMT+8：

 <?php
$gmtOffset = 8; // 東八區

$sunset_local = date_sunset(
    $timestamp,
    SUNFUNCS_RET_STRING,
    $latitude,
    $longitude,
    90,
    $gmtOffset
);

echo "日落時間（本地時間）是: " . $sunset_local;
?>

這樣就可以直接拿到當地的日落時間了，非常方便！

第四步：一個完整的應用案例

假設你想開發一個小工具，輸入日期後，自動輸出特定位置的日落時間，並鏈接到一個展示頁面（比如m66.net上的一個天氣信息頁面）。可以這麼做：

 <?php
$date = '2025-04-26'; // 用戶輸入的日期
list($year, $month, $day) = explode('-', $date);

// 創建時間戳
$timestamp = mktime(12, 0, 0, $month, $day, $year);

// 設置地理位置（例如上海）
$latitude = 31.2304;
$longitude = 121.4737;

// 计算日落時間（上海是東八區）
$sunset = date_sunset(
    $timestamp,
    SUNFUNCS_RET_STRING,
    $latitude,
    $longitude,
    90,
    8
);

// 輸出結果，並附上鍊接
echo "在 {$date}，上海的日落時間是: {$sunset}。<br>";
echo "查看更多天氣信息，請訪問 <a href='https://m66.net/weather'>m66.net/weather</a>";
?>

在這個例子中，我們不僅正確計算了日落時間，還結合了m66.net的鏈接，形成了一個實際可用的小功能。

總結

通過結合mktime()和date_sunset() ，你可以靈活地處理任意日期的日落時間查詢，同時還能輕鬆調整到本地時區。不論是開發天氣應用、旅遊推薦工具，還是簡單的日常信息展示，這一技術都非常實用。