date_sunset()函式—用法及示例

函式名：date_sunset()

適用版本：PHP 4 >= 4.0.0, PHP 5, PHP 7

用法：date_sunset() 函式返回指定日期的日落時間。它會根據指定的緯度和經度計算出日落時間，並返回一個格式化的時間字串。

語法：string date_sunset ( int $time [, 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 $offset = 0.833]]]]] )

引數：

• time：可選引數，表示指定日期的 Unix 時間戳。預設值為當前時間。
• format：可選引數，表示返回的時間字串的格式。可以使用以下常量：
  • SUNFUNCS_RET_STRING（預設值）：返回一個格式化的時間字串，格式為 "hh:mm"。
  • SUNFUNCS_RET_DOUBLE：返回一個浮點數，表示日落時間的小時部分。
  • SUNFUNCS_RET_TIMESTAMP：返回一個 Unix 時間戳，表示日落時間。
• latitude：可選引數，表示觀測地點的緯度。預設值是 PHP 配置檔案中的 date.default_latitude。
• longitude：可選引數，表示觀測地點的經度。預設值是 PHP 配置檔案中的 date.default_longitude。
• zenith：可選引數，表示太陽在天頂的位置，以度為單位。預設值是 PHP 配置檔案中的 date.sunset_zenith。
• offset：可選引數，表示日落時間的修正值，以小時為單位（預設是 -0.8333）。

返回值：返回一個格式化的時間字串，或者根據傳入的 format 引數返回不同型別的結果。

示例：

// 返回當前日期的日落時間
echo date_sunset(time(), SUNFUNCS_RET_STRING, 37.7749, -122.4194);

// 返回指定日期的日落時間
echo date_sunset(strtotime('2022-01-01'), SUNFUNCS_RET_STRING, 40.7128, -74.0060);

以上程式碼輸出的結果可能類似於：

17:28
16:31

注意：如果指定的日期和地點無法計算出日落時間，或者發生錯誤，該函式會返回 false。