Calendar 日历函数
简介
日历扩展是由一系列简单的日历格式转换函数组成。媒介或标准是基于儒略日计数(Julian Day Count)。儒略日计数是从公元前 4713 年 1 月 1 日开始计算的。在不同的日历系统中转换,必须先将其转换为儒略日计数,然后转换为目标日历格式。儒略日计数与罗马儒略历(Julian Calendar)完全不同!更多关于儒略日计数的信息,请访问 » https://www.hermetic.ch/cal_stud/jdn.htm。更多关于日历系统的信息,请访问 » https://www.fourmilab.ch/documents/calendar/。从此页面引用的信息包含了这些介绍,在引号之内。
安装
要使用本类函数,需要在编译 PHP 时加上 --enable-calendar。
PHP 的 Windows 版本已经内置该扩展模块的支持。无需加载任何附加扩展库即可使用这些函数。
运行时配置
本扩展模块在 php.ini 中未定义任何配置选项。
资源类型
本扩展模块未定义任何资源类型。
预定义常量
以下常量由本扩展模块定义,因此只有在本扩展模块被编译到 PHP 中,或者在运行时被动态加载后才有效。
- CAL_GREGORIAN (integer)
- CAL_JULIAN (integer)
- CAL_JEWISH (integer)
- CAL_FRENCH (integer)
- CAL_NUM_CALS (integer)
- CAL_DOW_DAYNO (integer)
- CAL_DOW_SHORT (integer)
- CAL_DOW_LONG (integer)
- CAL_MONTH_GREGORIAN_SHORT (integer)
- CAL_MONTH_GREGORIAN_LONG (integer)
- CAL_MONTH_JULIAN_SHORT (integer)
- CAL_MONTH_JULIAN_LONG (integer)
- CAL_MONTH_JEWISH (integer)
- CAL_MONTH_FRENCH (integer)
以下常量自 PHP 4.3.0 起可用:
- CAL_EASTER_DEFAULT (integer)
- CAL_EASTER_ROMAN (integer)
- CAL_EASTER_ALWAYS_GREGORIAN (integer)
- CAL_EASTER_ALWAYS_JULIAN (integer)
以下常量自 PHP 5.0.0 起可用:
Table of Contents
- cal_days_in_month — Return the number of days in a month for a given year and calendar
- cal_from_jd — Converts from Julian Day Count to a supported calendar
- cal_info — Returns information about a particular calendar
- cal_to_jd — Converts from a supported calendar to Julian Day Count
- easter_date — Get Unix timestamp for midnight on Easter of a given year
- easter_days — Get number of days after March 21 on which Easter falls for a given year
- FrenchToJD — Converts a date from the French Republican Calendar to a Julian Day Count
- GregorianToJD — Converts a Gregorian date to Julian Day Count
- JDDayOfWeek — Returns the day of the week
- JDMonthName — Returns a month name
- JDToFrench — Converts a Julian Day Count to the French Republican Calendar
- JDToGregorian — Converts Julian Day Count to Gregorian date
- jdtojewish — Converts a Julian day count to a Jewish calendar date
- JDToJulian — Converts a Julian Day Count to a Julian Calendar Date
- jdtounix — Convert Julian Day to Unix timestamp
- JewishToJD — Converts a date in the Jewish Calendar to Julian Day Count
- JulianToJD — Converts a Julian Calendar date to Julian Day Count
- unixtojd — Convert Unix timestamp to Julian Day