easter_date

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

easter_date获取给定年份复活节午夜的 Unix 时间戳

描述

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

返回给定年份复活节午夜对应的 Unix 时间戳。

复活节的日期由公元 325 年的尼西亚公会议定义为春分日或之后第一个满月的下一个星期日。春分日假定始终为 3 月 21 日,因此计算简化为确定满月日期和下一个星期日日期。此处使用的算法由狄奥尼修斯·埃克西古斯在公元 532 年左右引入。在儒略历下(1753 年之前的年份),使用一个简单的 19 年周期来跟踪月相。在格里高利历下(1753 年之后的年份——由克劳维斯和利利乌斯设计,并由教皇格里高利十三世于 1582 年 10 月引入,并在 1752 年 9 月引入英国及其当时的殖民地),添加了两个校正因子以使周期更准确。

参数

year

年份必须是 32 位系统上的 1970 到 2037 之间的数字,或者 64 位系统上的 1970 到 2,000,000,000 之间的数字。如果省略或为 null,则默认为本地时间中的当前年份。

mode

当设置为 CAL_EASTER_ALWAYS_JULIAN 时,允许根据儒略历计算复活节日期。另请参见 日历常量

返回值

复活节日期作为 Unix 时间戳。

错误/异常

如果年份早于 1970 或晚于 2037(在 32 位系统上运行时),或晚于 64 位系统上的 2,000,000,000,则会抛出 ValueError

变更日志

版本 描述
8.3.0 在 64 位系统上,year 参数现在接受 1970 到 2,000,000,000 范围内的值。
8.0.0 year 现在可以为空。
8.0.0 year 超出允许范围时,现在会抛出 ValueError。以前,会引发 E_WARNING,并且函数返回 false

示例

示例 #1 easter_date() 示例

<?php

echo date("M-d-Y", easter_date(1999)); // Apr-04-1999
echo date("M-d-Y", easter_date(2000)); // Apr-23-2000
echo date("M-d-Y", easter_date(2001)); // Apr-15-2001

?>

示例 #2 使用 easter_date()DateTime

<?php

$timestamp
= easter_date(2023);

$datetime = new \DateTime();
$datetime->setTimestamp($timestamp);

echo
$datetime->format('M-d-Y'); // Apr-09-2023

?>

注释

注意:

easter_date() 依赖于系统的 C 库时间函数,而不是使用 PHP 的内部日期和时间函数。因此,easter_date() 使用 TZ 环境变量来确定它应该运行的时区,而不是使用 PHP 的 默认时区,这可能导致在将此函数与 PHP 中的其他日期函数结合使用时出现意外行为。

作为解决方法,您可以使用 easter_days()DateTimeDateInterval 来计算 PHP 时区中的复活节开始,如下所示

<?php
function get_easter_datetime($year) {
$base = new DateTime("$year-03-21");
$days = easter_days($year);

return
$base->add(new DateInterval("P{$days}D"));
}

foreach (
range(2012, 2015) as $year) {
printf("Easter in %d is on %s\n",
$year,
get_easter_datetime($year)->format('F j'));
}
?>

上面的例子将输出

Easter in 2012 is on April 8
Easter in 2013 is on March 31
Easter in 2014 is on April 20
Easter in 2015 is on April 5

参见

  • easter_days() - 获取给定年份复活节在 3 月 21 日之后的天数 用于计算 1970 年之前的或 2037 年之后的复活节

添加注释

用户贡献注释 6 个注释

29
maxie
16 年前
为了计算东正教教会正确的复活节日期,我根据 Meeus 儒略算法创建了一个函数

<?php
function orthodox_eastern($year) {
$a = $year % 4;
$b = $year % 7;
$c = $year % 19;
$d = (19 * $c + 15) % 30;
$e = (2 * $a + 4 * $b - $d + 34) % 7;
$month = floor(($d + $e + 114) / 31);
$day = (($d + $e + 114) % 31) + 1;

$de = mktime(0, 0, 0, $month, $day + 13, $year);

return
$de;
}
?>
9
Alexander Bliznyuk
6 年前
感谢 @Maxie 提供的计算东正教复活节日期的算法。
不过,它可以改进。您添加了 13 天来将儒略历映射到格里高利历。但 13 天不是一个常数。它是格里高利历中修正的累积误差,应该用以下公式计算:(int)($year / 100) - (int)($year / 400) - 2
11
py dot lebecq at gmail dot com
14 年前
我最近需要编写一个函数,让我知道今天是否是节假日。

在法国,我们有一些取决于复活节日期的节假日。也许这对某人会有用。

只需在 $holidays 数组中修改您国家/地区的实际节假日日期。

<?php
/**
* 此函数返回一个包含对应法国节假日的日期戳的数组
*/
protected static function getHolidays($year = null)
{
if (
$year === null)
{
$year = intval(date('Y'));
}

$easterDate = easter_date($year);
$easterDay = date('j', $easterDate);
$easterMonth = date('n', $easterDate);
$easterYear = date('Y', $easterDate);

$holidays = array(
// 这些日期是固定的
mktime(0, 0, 0, 1, 1, $year), // 1 月 1 日
mktime(0, 0, 0, 5, 1, $year), // 劳动节
mktime(0, 0, 0, 5, 8, $year), // 盟军胜利日
mktime(0, 0, 0, 7, 14, $year), // 国庆节
mktime(0, 0, 0, 8, 15, $year), // 圣母升天节
mktime(0, 0, 0, 11, 1, $year), // 万圣节
mktime(0, 0, 0, 11, 11, $year), // 停战纪念日
mktime(0, 0, 0, 12, 25, $year), // 圣诞节

// 这些日期取决于复活节
mktime(0, 0, 0, $easterMonth, $easterDay + 2, $easterYear),
mktime(0, 0, 0, $easterMonth, $easterDay + 40, $easterYear),
mktime(0, 0, 0, $easterMonth, $easterDay + 50, $easterYear),
);

sort($holidays);

return
$holidays;
}
?>
1
Guillaume Dufrene
11 年前
我发现节假日时间戳计算和夏令时存在问题。
一篇关于它的文章,网址为 http://goo.gl/76t31(仅法语,抱歉)。

总之,今年(2013 年)复活节开始于添加夏令时(在星期日 3:00 发生)之前。这意味着,如果您执行 $easter + X,其中 x 是相当于一天、39 天或 50 天的秒数,结果将不等于午夜时间戳……

这是一个用于检查午夜时间戳是否等于节假日的函数

function isHoliday( $ts ) {
// 许可证:知识共享署名 (BY)
// 作者:Webpulser - http://goo.gl/76t31
$fixed_holidays = array( ’01-01′, ’01-05′, ’08-05′, ’14-07′, ’15-08′, ’11-11′, ’25-12′ );
$format = ‘d-m’;

$dm = date($format, $ts);
if ( in_array($dm, $fixed_holidays) ) return true;

$easter = easter_date( date(‘Y’, $ts) );
if ( date($format, $easter + 86400) == $dm ) return true;
if ( date($format, $easter + 3369600) == $dm ) return true;
if ( date($format, $easter + 4320000) == $dm ) return true;

return false;
}

随意使用/修改。
-1
phpuser
19 年前
Bigtree 的算法是正确的,如果你添加一些 (int) 强制类型转换
<?php
function easter_date ($Year) {

/*
G 是金数减 1
H 是 23 减去朔日 (模 30)
I 是从 3 月 21 日到逾越节满月的日子数
J 是逾越节满月的星期几 (0=星期日,
1=星期一,等等)
L 是从 3 月 21 日到逾越节满月前或当天的星期日的天数 (介于 -6 到 28 之间)
*/


$G = $Year % 19;
$C = (int)($Year / 100);
$H = (int)($C - (int)($C / 4) - (int)((8*$C+13) / 25) + 19*$G + 15) % 30;
$I = (int)$H - (int)($H / 28)*(1 - (int)($H / 28)*(int)(29 / ($H + 1))*((int)(21 - $G) / 11));
$J = ($Year + (int)($Year/4) + $I + 2 - $C + (int)($C/4)) % 7;
$L = $I - $J;
$m = 3 + (int)(($L + 40) / 44);
$d = $L + 28 - 31 * ((int)($m / 4));
$y = $Year;
$E = mktime(0,0,0, $m, $d, $y);

return
$E;

}
?>
-3
adwil at live dot com
10 年前
嗨,最近我需要一个函数来获取网上商店的实现日期,所以这里有它(准备好为波兰用户使用,请为任何其他国家调整您的日期)

<?php
function getWorkday($date1,$workDays) {
$workDays = (int)$workDays;
if (
$workDays <= 0)
return
null;

$date1=strtotime('-1 day',strtotime($date1));

$lastYear = null;
$hol=array('01-01','01-06','05-01','05-03','08-15','11-01','11-11','12-25','12-26'); // 静态假日的月-日数组 (这些来自波兰)
$i = 0;
while (
$i<=$workDays) {
$year = date('Y', $date1);
if (
$year !== $lastYear){
$lastYear = $year;
$easter = date('m-d', easter_date($year));
$date = strtotime($year . '-' . $easter); // 复活节
$easterSec = date('m-d', strtotime('+1 day', $date)); // 复活节星期一
$greens = date('m-d', strtotime('+49 days', $date)); // 五旬节
$cc = date('m-d', strtotime('+60 days', $date)); // 圣体节
$hol[] = $easter;
$hol[] = $easterSec;
$hol[] = $greens;
$hol[] = $cc;
}
$weekDay=date('w',$date1);
if (!(
$weekDay==0 || $weekDay==6 || in_array(date('m-d',$date1),$hol)))
$i++;

$date1=strtotime('+1 day',$date1);
}
return
date('Y-m-d',$date1);
}
?>
To Top