想要使用历法函数库,需要先编译好 dl/calendar 函数库。PHP 中的历法函数库提供不同的公元历法转换。转换的基准是凯撒日计数 (Julian Day Count)。所有的历法计算都必需先转换成凯撒日计数,再转成您所需要的历法,更多的资料可以参考这个网址找到 http://genealogy.org/~scottlee/cal-overview.html 。不过对于使用黄帝纪元的中国,这个函数库就还需要扩充才适合了。 |
JDToGregorian : | 将凯撒日计数 (Julian Day Count) 转换成为格里高里历法 (Gregorian date)。 |
GregorianToJD : | 将格里高里历法转换成为凯撒日计数。 |
JDToJulian : | 将凯撒日计数转换成为凯撒历法。 |
JulianToJD : | 将凯撒历法转换成为凯撒日计数。 |
JDToJewish : | 将凯撒日计数转换成为犹太历法。 |
JewishToJD : | 将犹太历法转换成为凯撒日计数。 |
JDToFrench : | 将凯撒日计数转换成为法国共和历法。 |
FrenchToJD : | 将法国共和历法转换成为凯撒日计数。 |
JDMonthName : | 返回月份名。 |
JDDayOfWeek : | 返回日期在周几。 |
JDToGregorian
将凯撒日计数 (Julian Day Count) 转换成为格里高里历法 (Gregorian date)。
语法: string jdtogregorian(int julianday);
返回值: 字符串
函数种类: 时间日期
内容说明 将凯撒历法的日期计数转换成为格里高里历法字符串,并以"月份/日期/年" (month/day/year) 的字符串返回。格里高里历为教皇格梩高里十三世在公元 1582 年颁行的历法。
GregorianToJD
将格里高里历法转换成为凯撒日计数。
语法: int gregoriantojd(int month, int day, int year);
返回值: 整数
函数种类: 时间日期
内容说明 有效的范围为格里高里历法公元前 4714 年至公元 9999 年。这套软件能计算到公元前 4714 年,但这是不太有意义的。格里高里历在 1582 年 10 月 15 日施行,但一些欧洲国家到很久后才实行,如英国在 1752 年实行、苏联在 1918 年施行、希腊在 1923 年实行。大部份的欧洲国家优先使用凯撒历法,再次才是格里高里历法。
使用范例
<?php
$jd = GregorianToJD(10,11,1970);
echo("$jd\n");
$gregorian = JDToGregorian($jd);
echo("$gregorian\n");
?>
JDToJulian
将凯撒日计数转换成为凯撒历法。
语法: string jdtojulian(int julianday);
返回值: 字符串
函数种类: 时间日期
内容说明
将凯撒历法的日期计数转换成为凯撒历法字符串,并以"月份/日期/年" (month/day/year) 的字符串返回。
JulianToJD
将凯撒历法转换成为凯撒日计数。
语法: int juliantojd(int month, int day, int year);
返回值: 整数
函数种类: 时间日期
内容说明 有效的范围为凯撒历法公元前 4713 年至公元 9999 年。这套软件能计算到公元前 4713 年,但这是不太有意义的。凯撒历法是在公元前 46 年建立的,但一些细节等到公元 8 年才稳定下来。
JDToJewish
将凯撒日计数转换成为犹太历法。
语法: string jdtojewish(int julianday);
返回值: 字符串
函数种类: 时间日期
内容说明 将凯撒历法的日期计数转换成为犹太历法字符串,并以"月份/日期/年" (month/day/year) 的字符串返回。
JewishToJD
将犹太历法转换成为凯撒日计数。
语法: int jewishtojd(int month, int day, int year);
返回值: 整数
函数种类: 时间日期
内容说明 有效的范围为犹太历法公元前 3761 年起。犹太历法存在了数千年,但早期并没有公式化的开始月份计算法。每年的第一个月为首次观测到的新月。
JDToFrench
将凯撒日计数转换成为法国共和历法。
语法: string jdtofrench(int month, int day, int year);
返回值: 字符串
函数种类: 时间日期
内容说明 将凯撒历法的日期计数转换成为法国共和历法字符串,并以 "月份/日期/年" (month/day/year) 的字符串返回。
FrenchToJD
将法国共和历法转换成为凯撒日计数。
语法: int frenchtojd(int month, int day, int year);
返回值: 整数
函数种类: 时间日期
内容说明 函数只能转换法国共和历元年到十四年,也就是格里高里历的 1792 年 9 月 22 日至 1806 年 9 月 22 日。
JDMonthName
返回月份名。
语法: string jdmonthname(int julianday, int mode);
返回值: 字符串
函数种类: 时间日期
内容说明 本函数返回指定历法的月份字符串。参数 mode 为历法名称,详见下表。
Mode | 代表义意 |
---|---|
0 | 格里高里历 (缩写) |
1 | 格里高里历 |
2 | 凯撒历 (缩写) |
3 | 凯撒历 |
4 | 犹太历 |
5 | 法国共和历 |
JDDayOfWeek
返回日期在周几。
语法: mixed jddayofweek(int julianday, int mode);
返回值: 混合类型
函数种类: 时间日期
内容说明 本函数返回日期在当周的天数,返回值依 mode 值决定,详见下表
Mode | 代表义意 |
---|---|
0 | 返回周几为整数值 (0 为周日, 1 为周一... 余类推) |
1 | 返回字符串为周几 (英文-格里高里历) |
2 | 返回字符串为周几的缩写 (英文-格里高里历) |
文章来源于领测软件测试网 https://www.ltesting.net/