【PHP入門】cal_from_jd()関数でユリウス日からカレンダー情報を取得する方法

cal_from_jd()関数は、指定したユリウス日（Julian Day）をもとに、対応する暦の日付情報を配列として返すPHPの組み込み関数です。グレゴリオ暦をはじめ、ユリウス暦やユダヤ暦など、複数の暦体系に柔軟に対応できるのが特徴です。

構文

cal_from_jd(julian_day, calendar)

パラメータ

• julian_day − 変換元となるユリウス日を整数で指定します。

• calendar − 取得したい暦の種類を指定します。指定できる定数は以下のとおりです。

  • CAL_GREGORIAN：グレゴリオ暦（現在一般的に使われている暦）

  • CAL_JULIAN：ユリウス暦

  • CAL_JEWISH：ユダヤ暦

  • CAL_FRENCH：フランス革命暦（共和暦）

戻り値

cal_from_jd()関数は、次の情報を含む連想配列を返します。

• date：日付（月/日/年の形式）
• month：月
• day：日
• year：年
• dow：曜日を表す数値（0＝日曜日〜6＝土曜日）
• dayname／abbrevdayname：曜日名とその省略形
• monthname／abbrevmonth：月名とその省略形

使用例

以下は、2018年10月5日の日付情報を取得するサンプルコードです。まずunixtojd()を使ってUnixタイムスタンプをユリウス日に変換し、その結果をcal_from_jd()に渡してグレゴリオ暦の詳細情報を取得しています。

<?php
$res = unixtojd(mktime(0, 0, 0, 10, 05, 2018));
print_r(cal_from_jd($res, CAL_GREGORIAN));
?>

出力結果

Array
(
[date] => 10/5/2018
[month] => 10
[day] => 5
[year] => 2018
[dow] => 5
[abbrevdayname] => Fri
[dayname] => Friday
[abbrevmonth] => Oct
[monthname] => October
)

このように、dowには「5」（金曜日を表す数値）、daynameには「Friday」というように、日付に関する詳しい情報がひとつの配列にまとめて格納されます。ユリウス日さえわかれば、曜日や月名まで含めた詳細なカレンダー情報を簡単に取得できるため、日付変換処理の実装に非常に便利な関数です。