date_sun_info()函式—用法及示例

函式： date_sun_info()

適用版本： PHP 5以上

用法： date_sun_info(datetime $time, float $latitude, float $longitude) : array

函式date_sun_info()用於返回指定日期和地理位置的日出和日落資訊。該函式接受三個引數：時間、緯度和經度，並返回一個陣列，包含日出、日落和黃昏（民用）時間的詳細資訊。

引數：

• $time：必需，一個包含日期和時間資訊的DateTime物件。
• $latitude：必需，地理位置的緯度。負數表示南半球。
• $longitude：必需，地理位置的經度。負數表示西半球。

返回值： 一個包含日出、日落和黃昏時間詳細資訊的關聯陣列。陣列包括以下鍵：

• sunrise：日出時間，格式為 "HH:MM:SS"。
• sunset：日落時間，格式為 "HH:MM:SS"。
• transit：太陽近似到達最高位置的時間，格式為 "HH:MM:SS"。
• civil_twilight_begin：黃昏（民用）開始的時間，格式為 "HH:MM:SS"。
• civil_twilight_end：黃昏（民用）結束的時間，格式為 "HH:MM:SS"。

示例：

// 當前日期時間和地理位置的日出和日落資訊
$date = new DateTime('now');
$latitude = 37.7749; // 聖弗朗西斯科的緯度
$longitude = -122.4194; // 聖弗朗西斯科的經度

$sunInfo = date_sun_info($date, $latitude, $longitude);

echo "日出時間：" . $sunInfo['sunrise'] . "<br>";
echo "日落時間：" . $sunInfo['sunset'] . "<br>";
echo "黃昏（民用）開始時間：" . $sunInfo['civil_twilight_begin'] . "<br>";
echo "黃昏（民用）結束時間：" . $sunInfo['civil_twilight_end'] . "<br>";

輸出：

日出時間：06:22:27
日落時間：17:53:18
黃昏（民用）開始時間：05:56:35
黃昏（民用）結束時間：18:18:10

上述示例中，我們獲取了當前日期和聖弗朗西斯科的緯度和經度，然後使用date_sun_info()函式獲取了日出、日落和黃昏開始和結束的時間資訊，並將其列印出來。