Calendar是一套關(guān)於日期曆法的擴(kuò)展，在PHP中要如何使用該Calendar擴(kuò)展？這篇文章為大家介紹Calendar 擴(kuò)充安裝和使用方法。

Calendar是一套關(guān)於日期曆法的擴(kuò)展，但是對(duì)於我們來(lái)說(shuō)，它沒(méi)有農(nóng)曆的相關(guān)操作，所以對(duì)於我們中國(guó)人來(lái)說(shuō)這個(gè)擴(kuò)展並沒(méi)有什麼實(shí)際的作用。不過(guò)這並不妨礙我們?nèi)チ私鈱W(xué)習(xí)它。

日期曆法類型

對(duì)於正常情況下的日期操作來(lái)說(shuō)，PHP 預(yù)設(shè)使用的是UTC 時(shí)間，也就是國(guó)際標(biāo)準(zhǔn)時(shí)間，對(duì)於我們國(guó)家來(lái)說(shuō)，需要在標(biāo)準(zhǔn)UTC 的時(shí)間上加8 來(lái)表示北京時(shí)間東八區(qū)。當(dāng)然，也可以直接修改 php.ini 或資料庫(kù)中的時(shí)區(qū)相關(guān)參數(shù)來(lái)定義好日期時(shí)區(qū)。

標(biāo)準(zhǔn)時(shí)區(qū)對(duì)應(yīng)的其實(shí)就是格里高利時(shí)間曆法 Gregorian 。也就是我們現(xiàn)在最常用的公曆、陽(yáng)曆日期。 Calendar 擴(kuò)展中除了這個(gè)標(biāo)準(zhǔn)的公曆法之外，還支持 猶太曆法 Jewish 、 法曆 French 以及另一個(gè)非常出名的 儒略曆 Julian 。我們的Gregorian 曆法就是從Julian 曆中演化而來(lái)的，它們的差距並不大，但猶太曆和法歷的差距就比較大了，一會(huì)在下面的程式碼中我們將看到各種曆法之間的差別。

關(guān)於這些曆法的具體內(nèi)容大家可以自行查詢一下相關(guān)的資料，也能夠?qū)W習(xí)到一些有趣的歷史知識(shí)，比如為什麼廢棄了 儒略曆 而將公曆定為了 格里曆 。還有 法歷 為什麼只有短短的那些年，猶太曆 為什麼年份記得這麼大了。法歷 和 猶太曆 月份名字的來(lái)源等，都是很有趣的故事。

Calendar 擴(kuò)充安裝及曆法資訊檢視

#Calendar 擴(kuò)充功能已經(jīng)整合在 PHP 安裝套件中了，不需要特別的單獨(dú)去安裝。如果你無(wú)法使用 Calendar 相關(guān)的函數(shù)，可以重新編譯 PHP 並加上 --enable-calendar 參數(shù)即可。

接下來(lái)我們看下指定曆法的詳細(xì)信息，這裡我們指定的是 猶太曆 。

$info = cal_info(2);
print_r($info);
// Array
// (
//     [months] => Array
//         (
//             [1] => Tishri
//             [2] => Heshvan
//             [3] => Kislev
//             [4] => Tevet
//             [5] => Shevat
//             [6] => Adar I
//             [7] => Adar II
//             [8] => Nisan
//             [9] => Iyyar
//             [10] => Sivan
//             [11] => Tammuz
//             [12] => Av
//             [13] => Elul
//         )
//     [abbrevmonths] => Array
//         (
//             [1] => Tishri
//             [2] => Heshvan
//             [3] => Kislev
//             [4] => Tevet
//             [5] => Shevat
//             [6] => Adar I
//             [7] => Adar II
//             [8] => Nisan
//             [9] => Iyyar
//             [10] => Sivan
//             [11] => Tammuz
//             [12] => Av
//             [13] => Elul
//         )
//     [maxdaysinmonth] => 30
//     [calname] => Jewish
//     [calsymbol] => CAL_JEWISH
// )

cal_info() 函數(shù)接收的參數(shù)是一個(gè)常數(shù)，分別是 CAL_GREGORIAN ，CAL_JULIAN ，CAL_JEWISH ，CAL_FRENCH ，它們對(duì)應(yīng)的數(shù)字就是 0，1，2，3 。在這段程式碼中，我們回傳的就是 CAL_JEWISH 的訊息?？梢钥闯?，猶太曆 中的月份名稱與公曆中的英文名稱都不一樣，例如這裡有 尼撒月 Nisan 、提市黎月 Tishri 。具體的內(nèi)容就不深究了，畢竟我們?cè)谌粘Ｉ钪惺峭耆佑|不到這種曆法的。

大家可以自己試試其它曆法返回的資訊內(nèi)容，公曆和儒略曆是一樣的，法曆中的月份名字就又不一樣了，而且這些名字還都很有意思。

日期曆法轉(zhuǎn)換

首先，要進(jìn)行曆法轉(zhuǎn)換的話，我們要將指定的日期轉(zhuǎn)換成 Julian Days 計(jì)數(shù)。這個(gè) jd 計(jì)數(shù)可以看作是 Calendar 擴(kuò)展的一個(gè)中間變量，用於各種曆法之間的換算。

//  轉(zhuǎn)變Unix時(shí)間戳為Julian Day計(jì)數(shù)
$today = unixtojd(mktime(0, 0, 0, 9, 23, 2020));
echo $today, PHP_EOL; // 2459116

使用 unixtojd() 函數(shù)就可以將一個(gè) unix 時(shí)間戳記轉(zhuǎn)換成 jd 計(jì)數(shù)。接下來(lái)，我們來(lái)看看 2020 年 9 月 23 號(hào)對(duì)應(yīng)的 猶太曆 是哪一天。

// 獲取當(dāng)前猶太歷時(shí)間
print_r(cal_from_jd($today, CAL_JEWISH));
// Array
// (
//     [date] => 1/5/5781
//     [month] => 1
//     [day] => 5
//     [year] => 5781
//     [dow] => 3
//     [abbrevdayname] => Wed
//     [dayname] => Wednesday
//     [abbrevmonth] => Tishri
//     [monthname] => Tishri
// )

返回的訊息中已經(jīng)很明確了吧，我們這一天是 猶太曆 的 5781 年 1 月 5 號(hào) 星期三 。目前的月份是 Tishri 提市黎月 ，對(duì)應(yīng)著公曆年的第一個(gè)月，猶太曆中教會(huì)年的第七個(gè)月，代表著秋天的到來(lái)。

cal_from_jd() 函數(shù)的作用就是根據(jù) jd計(jì)數(shù) 傳回指定曆法的詳細(xì)資料。而另外一個(gè) cal_to_jd() 函數(shù)則是從一個(gè)支援的曆法資料轉(zhuǎn)換為 jd計(jì)數(shù) 。

echo cal_to_jd(CAL_JEWISH, 1, 5, 5781), PHP_EOL; // 2459116
echo cal_to_jd(CAL_GREGORIAN,9, 23, 2020), PHP_EOL; // 2459116

可以看到上面 猶太曆 回傳的 jd計(jì)數(shù) 和我們公曆回傳的 jd計(jì)數(shù) 是一致的。

當(dāng)然，我們也可以將 jd計(jì)數(shù) 的日期轉(zhuǎn)換成 unix 時(shí)間。

echo date("Y-m-d", jdtounix($today)), PHP_EOL;
// 2020-09-23

除了cal_from_jd() 和cal_to_jd() 之外，Calendar 擴(kuò)展還為我們提供了一些快捷的函數(shù)進(jìn)行日期的轉(zhuǎn)換，只不過(guò)它們是直接返回的字符串類型的日期信息，不是像cal_from_jd() 函數(shù)一樣傳回日期的詳細(xì)資料。

// 轉(zhuǎn)變一個(gè)Gregorian歷法日期到Julian Day計(jì)數(shù)
$jd = GregorianToJD(9, 23, 2020);

// 轉(zhuǎn)變一個(gè)Julian Day計(jì)數(shù)為Gregorian歷法日期
echo jdtogregorian($jd), PHP_EOL; // 9/23/2020
// 轉(zhuǎn)變一個(gè)Julian Day計(jì)數(shù)為Julian歷法日期
echo jdtojulian($jd), PHP_EOL; // 9/10/2020
// 轉(zhuǎn)變一個(gè)Julian Day計(jì)數(shù)為猶太歷法日期
echo jdtojewish($jd), PHP_EOL; // 1/5/5781
// 轉(zhuǎn)變一個(gè)Julian Day計(jì)數(shù)為unix時(shí)間戳
echo jdtounix($jd), PHP_EOL; // 1600819200

$jd = GregorianToJD(9, 23, 1799);
// 轉(zhuǎn)變一個(gè)Julian Day計(jì)數(shù)為French歷法日期
echo jdtofrench($jd), PHP_EOL; // 1/1/8

GregorianToJD() 方法就是快速轉(zhuǎn)換一個(gè)公曆日期為 jd計(jì)數(shù) 。而 jdtoxxxxx 為一些函數(shù)就是快速地傳回 jd計(jì)數(shù) 對(duì)??應(yīng)的日期曆法的字串資訊。

大家可以注意下，法曆日期只能是公曆1792年9月22日到1806年9月22日這段日期以內(nèi)的日期，也就是法蘭西第一共和國(guó)成立後推出的法歷，並在1806年結(jié)束使用，因?yàn)?804年拿破崙成立了法蘭西第一帝國(guó)。帝國(guó)廢止了 法歷（共和曆）並全面推行 公曆 。

某個(gè)月份的天數(shù)

上面的歷史知識(shí)學(xué)習(xí)的怎麼樣？接下來(lái)還是回歸到 Calendar 擴(kuò)展中的學(xué)習(xí)。

$num = cal_days_in_month(CAL_GREGORIAN, 2, 2020);
echo $num, PHP_EOL; // 29

cal_days_in_month() 函數(shù)是返回指定歷法月份的天數(shù)，比如我們看看 2020 年的 2月 是不是 閏月 就可以用這個(gè)函數(shù)來(lái)實(shí)現(xiàn)。

復(fù)活節(jié)彩蛋

復(fù)活節(jié)是西方非常重要的一個(gè)節(jié)日，所以在 Calendar 擴(kuò)展中就有函數(shù)可以直接獲得指定年份的復(fù)活節(jié)日期。關(guān)于復(fù)活節(jié)的計(jì)算方式其實(shí)還是比較復(fù)雜的，手工推算是比較麻煩的，而程序計(jì)算就非常方便了。

// 指定年份的復(fù)活節(jié)時(shí)間戳
echo date("M-d-Y", easter_date(2019)), PHP_EOL;        // Apr-21-2019
echo date("M-d-Y", easter_date(2020)), PHP_EOL;        // Apr-12-2020
echo date("M-d-Y", easter_date(2021)), PHP_EOL;        // Apr-04-2021

// 3月21日到復(fù)活節(jié)之間的天數(shù)
echo easter_days(2019), PHP_EOL;        // 31
echo easter_days(2020), PHP_EOL;        // 22
echo easter_days(2021), PHP_EOL;        // 14

easter_date() 函數(shù)就是返回指定年份的復(fù)活節(jié)日期。而 easter_days() 函數(shù)則是返回從當(dāng)年公歷的 3月21日 到復(fù)活節(jié)之間的天數(shù)。

復(fù)活節(jié)是每年春分月圓后的第一個(gè)星期日，而春分一般是在3月21日，這就簡(jiǎn)化為只要計(jì)算滿月的日期和緊挨的星期日的日期就可以得到每年復(fù)活節(jié)的具體日期了。這種函數(shù)在西方世界的軟件開(kāi)發(fā)中會(huì)非常常用，其實(shí)就像我們需要獲取每年春節(jié)的具體公歷日期一樣。

總結(jié)

是不是很有意思的一套擴(kuò)展函數(shù)。不過(guò)對(duì)于我們主要面向國(guó)內(nèi)開(kāi)發(fā)的開(kāi)發(fā)者來(lái)說(shuō)用處確實(shí)不大，但筆者在學(xué)習(xí)這個(gè)擴(kuò)展的時(shí)候另外收獲了不少歷史方面的知識(shí)，也算是開(kāi)了眼界，也不失為一大收獲，大家也自己試著玩玩并且查查相關(guān)的歷史知識(shí)吧，說(shuō)不定你的收獲會(huì)更多！

測(cè)試代碼：

https://github.com/zhangyue0503/dev-blog/blob/master/php/202009/source/10.PHP中非常好玩的Calendar擴(kuò)展學(xué)習(xí).php

參考文檔：https://www.php.net/manual/zh/book.calendar.php

推薦學(xué)習(xí)：《PHP視頻教程》

以上是PHP中什麼是Calendar擴(kuò)充？如何使用？的詳細(xì)內(nèi)容。更多資訊請(qǐng)關(guān)注PHP中文網(wǎng)其他相關(guān)文章！