PHP Calendar 函数手册

日历扩展提供了一系列功能,以简化不同日历格式之间的转换。

PHP Calendar 简介

日历扩展包含了简化不同日历格式间的转换的函数。

它是基于 Julian Day Count(儒略日计数),是从公元前 4713 年 1 月 1 日开始计算的。

注释:如需在日历格式之间转换,必须首先转换为 Julian Day Count,然后再转换为您需要的日历格式。

注释:Julian Day Count(儒略日计数)与 Julian Calendar(儒略历法) 不是一回事!

安装

为了让这些函数能够工作,您必须通过 --enable-calendar 编译 PHP。

PHP 的 Windows 版本已内建了对日历扩展的支持。因此,Calendar 函数会自动工作。

PHP Calendar 函数

函数描述
cal_days_in_month()针对指定的年份和历法,返回一个月中的天数。
cal_from_jd()把儒略日计数转换为指定历法的日期。
cal_info()返回有关指定历法的信息。
cal_to_jd()把指定历法的日期转换为儒略日计数。
easter_date()返回指定年份的复活节午夜的 Unix 时间戳。
easter_days()返回指定年份的复活节与 3 月 21 日之间的天数。
frenchtojd()把法国共和历法的日期转换成为儒略日计数。
gregoriantojd()把格利高里历法的日期转换成为儒略日计数。
jddayofweek()返回日期在周几。
jdmonthname()返回月的名称。
jdtofrench()把儒略日计数转换为法国共和历法的日期。
jdtogregorian()把儒略日计数转换为格利高里历法的日期。
jdtojewish()把儒略日计数转换为犹太历法的日期。
jdtojulian()把儒略日计数转换为儒略历法的日期。
jdtounix()把儒略日计数转换为 Unix 时间戳。
jewishtojd()把犹太历法的日期转换为儒略日计数。
juliantojd()把儒略历法的日期转换为儒略日计数。
unixtojd()把 Unix 时间戳转换为儒略日计数。

PHP 预定义的 Calendar 常量

常量类型PHP 版本
CAL_GREGORIANIntegerPHP 4
CAL_JULIANIntegerPHP 4
CAL_JEWISHIntegerPHP 4
CAL_FRENCHIntegerPHP 4
CAL_NUM_CALSIntegerPHP 4
CAL_DOW_DAYNOIntegerPHP 4
CAL_DOW_SHORTIntegerPHP 4
CAL_DOW_LONGIntegerPHP 4
CAL_MONTH_GREGORIAN_SHORTIntegerPHP 4
CAL_MONTH_GREGORIAN_LONGIntegerPHP 4
CAL_MONTH_JULIAN_SHORTIntegerPHP 4
CAL_MONTH_JULIAN_LONGIntegerPHP 4
CAL_MONTH_JEWISHIntegerPHP 4
CAL_MONTH_FRENCHIntegerPHP 4
CAL_EASTER_DEFAULTIntegerPHP 4.3
CAL_EASTER_ROMANIntegerPHP 4.3
CAL_EASTER_ALWAYS_GREGORIANIntegerPHP 4.3
CAL_EASTER_ALWAYS_JULIANIntegerPHP 4.3
CAL_JEWISH_ADD_ALAFIM_GERESHIntegerPHP 5.0
CAL_JEWISH_ADD_ALAFIMIntegerPHP 5.0
CAL_JEWISH_ADD_GERESHAYIMIntegerPHP 5.0