【PHP8.x】date_sun_info関数の使い方

date_sun_info関数は、指定した日時と地理的位置における太陽に関する詳細な情報を計算し、取得する関数です。この関数は、基準となる日時を示すUNIXタイムスタンプ、観測地点の緯度、そして経度の3つを引数として受け取ります。処理が成功すると、日の出や日の入りなど、太陽に関連する様々な情報が格納された連想配列を返します。この配列には、日の出時刻を示すsunrise、日の入り時刻を示すsunset、太陽が真南に来て最も高くなる南中時刻を示すtransitといったキーが含まれています。他にも、市民薄明や航海薄明、天文薄明の始まりと終わりの時刻なども取得可能です。各時刻はUNIXタイムスタンプ形式で返されるため、人間が読める形式で表示するにはdate()関数などを用いてフォーマットを変換する必要があります。この関数は、天文学的な計算や、特定の場所での最適な写真撮影時間を知るためのアプリケーションなどで活用できます。

// date_sun_info(タイムスタンプ, 緯度, 経度): array

$sun_info = date_sun_info(time(), 35.6895, 139.6917);

int $timestamp, float $latitude, float $longitude

• int $timestamp: 太陽の情報を取得したい日時を指定するUNIXタイムスタンプ
• float $latitude: 緯度を指定する浮動小数点数
• float $longitude: 経度を指定する浮動小数点数

array

日没、日の出、そして昼の長さに関する情報が連想配列で返されます。