easter_days

(PHP 4, PHP 5, PHP 7, PHP 8)

easter_days — 指定した年において、3 月 21 日から復活祭までの日数を得る

説明

easter_days(?int $year = null, int $mode = CAL_EASTER_DEFAULT): int

指定した年 year において、3 月 21 日から復活祭までの日数を返します。 year が指定されない場合、現在の年が仮定されます。

この関数は、Unix 時の範囲外(すなわち 1970 年以前または 2037 年以降)の復活祭を計算するために easter_date() の代わりに使用することができます。

復活祭の日付は、西暦 325 年の Nicaea の会議で春分の日以降の最初の満月の後の日曜日として定義されました。満月とその次の日曜日の日付の計算を簡単にするために春分の日は常に 3 月 21 日になるとして計算されます。ここで用いるアルゴリズムは、532 年頃に Dionysius Exiguus により導出されたものです。(1753 年より前の年に関して)ユリウス暦のもとでは月の周期を追うために簡単な 19 年周期が用いられます。グレゴリオ暦 (1753 年以降。この暦は Clavius と Lilius により考案され、教皇グレゴリウス 13 世により 1582 年 10 月に導入、イギリス及びその植民地に 1752 年 9 月に導入された) のもとで、二つの補正係数が周期をより正確に作成するために追加されました。

パラメータ

year: 正の数値で表した年。省略した場合、もしくは null の場合は、ローカルタイムにおける現在の年を使います。
mode: CAL_EASTER_ROMAN に設定すると 1582 年から 1752 年までの復活祭の日付をグレゴリオ暦にもとづいて計算します。それ以外に使用可能な定数についてはカレンダー定数を参照ください。

戻り値

指定した年 year において、3 月 21 日から復活祭までの日数を返します。

変更履歴

バージョン	説明
8.0.0	`year` は、nullable になりました。

例

例1 easter_days() の例

<?php

echo easter_days(1999);        // 14, i.e. April 4
echo easter_days(1492);        // 32, i.e. April 22
echo easter_days(1913);        //  2, i.e. March 23

?>

参考

easter_date() - 指定した年におけるローカルの復活祭の真夜中のUnix時を得る