日历扩展提供了一系列功能来简化不同日历格式之间的转换。
它基于儒略日计数的标准。儒略日计数 是从公元前 4713 年 1 月 1 日开始的天数。要在日历系统之间进行转换，您必须首先转换为 儒略日计数，然后转换为您选择的日历系统。
安装
要让这些函数工作，你必须用 --enable-calendar 编译 PHP。
运行时配置
此扩展没有在 php.ini 中定义的配置指令。
此扩展由 PHP 的 Windows 版本直接支持。您无需加载任何其他扩展即可使用这些功能。
日历常量
下面列出的常量由此扩展定义，并且只有在编译成 PHP 或在运行时动态加载后才可用。
| 常量 | 描述 |
|---|---|
| CAL_GREGORIAN | 阳历 |
| CAL_JULIAN | 儒略历 |
| CAL_JEWISH | 犹太历 |
| CAL_FRENCH | 法国共和历 |
| CAL_EASTER_DEFAULT | 使用 1753 年之前的儒略历和之后的格里高利历计算复活节 |
| CAL_EASTER_ROMAN | 使用 1583 年之前的儒略历和之后的格里高利历计算复活节 |
| CAL_EASTER_ALWAYS_GREGORIAN | 使用公历计算复活节 |
| CAL_EASTER_ALWAYS_JULIAN | 使用儒略历计算复活节 |
| CAL_NUM_CALS | 可用日历数量 |
| CAL_JEWISH_ADD_ALAFIM_GERESH | 在年份编号中添加 geresh 符号作为千位分隔符 |
| CAL_JEWISH_ADD_ALAFIM | 在年份数字中添加单词 “alafim” 作为千位分隔符 |
| CAL_JEWISH_ADD_GERESHAYIM | 在日期和年份数字的最后一个字母之前添加 gershayim 符号 |
| CAL_DOW_DAYNO | 整数形式的星期几，其中 0 表示星期日，6 表示星期六 |
| CAL_DOW_SHORT | 星期几的英文缩写名称 |
| CAL_DOW_LONG | 星期几的英文全名 |
| CAL_MONTH_GREGORIAN_SHORT | 缩写的格里高利月名称 |
| CAL_MONTH_GREGORIAN_LONG | 完整的公历月份名称 |
| CAL_MONTH_JULIAN_SHORT | 儒略月的缩写名称 |
| CAL_MONTH_JULIAN_LONG | 儒略月全名 |
| CAL_MONTH_JEWISH | 犹太月份名称 |
| CAL_MONTH_FRENCH | 法国共和月名称 |
函数列表
PHP − 表示支持该功能的 PHP 的最早版本。
| 函数 | 描述 | PHP |
|---|---|---|
| cal_days_in_month() | 返回指定年份和日历的月份天数 | 4 |
| cal_from_jd() | 将儒略日计数转换为指定日历的日期 | 4 |
| cal_info() | 返回有关给定日历的信息 | 4 |
| cal_to_jd() | 将日期转换为儒略日计数 | 4 |
| easter_date() | 返回指定年份的复活节午夜的 Unix 时间戳 | 4 |
| easter_days() | 返回 3 月 21 日之后的天数，即指定年份的复活节天数 | 4 |
| FrenchToJD() | 将法国共和日期转换为儒略日计数 | 4 |
| GregorianToJD() | 将公历日期转换为儒略日计数 | 4 |
| JDDayOfWeek() | 返回星期几 | 4 |
| JDMonthName() | 返回月份名称 | 4 |
| JDToFrench() | 将儒略日计数转换为法国共和日期 | 4 |
| JDToGregorian() | 将儒略日计数转换为公历日期 | 4 |
| JDToJewish() | 将儒略日计数转换为犹太日期 | 4 |
| JDToJulian() | 将儒略日计数转换为儒略日期 | 4 |
| JDToUnix() | 将儒略日计数转换为 Unix 时间戳 | 4 |
| JewishToJD() | 将犹太日期转换为儒略日计数 | 4 |
| JulianToJD() | 将儒略日期转换为儒略日计数 | 4 |
| UnixToJD() | 将 Unix 时间戳转换为儒略日计数 | 4 |
