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

Calendar是一套關(guān)于日期歷法的擴(kuò)展，但是對于我們來說，它沒有農(nóng)歷的相關(guān)操作，所以對于我們中國人來說這個擴(kuò)展并沒有什么實(shí)際的作用。不過這并不妨礙我們?nèi)チ私鈱W(xué)習(xí)它。

日期歷法類型

對于正常情況下的日期操作來說，PHP 默認(rèn)使用的是 UTC 時(shí)間，也就是國際標(biāo)準(zhǔn)時(shí)間，對于我們國家來說，需要在標(biāo)準(zhǔn) UTC 的時(shí)間上加 8 來表示北京時(shí)間東八區(qū)。當(dāng)然，也可以直接修改 php.ini 或者數(shù)據(jù)庫中的時(shí)區(qū)相關(guān)參數(shù)來定義好日期時(shí)區(qū)。

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

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

Calendar 擴(kuò)展安裝及歷法信息查看

Calendar 擴(kuò)展已經(jīng)集成在 PHP 安裝包中了，不需要特別的單獨(dú)去安裝。如果你無法使用 Calendar 相關(guān)的函數(shù)，可以重新編譯 PHP 并加上 –enable-calendar 參數(shù)即可。

接下來我們看下指定歷法的詳細(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ù)是一個常量，分別是 CAL_GREGORIAN ，CAL_JULIAN ，CAL_JEWISH ，CAL_FRENCH ，它們對應(yīng)的數(shù)字就是 0，1，2，3 。在這段代碼中，我們返回的就是 CAL_JEWISH 的信息。可以看出，猶太歷 中的月份名稱與公歷中的英文名稱都不一樣，比如這里有 尼撒月 Nisan 、提市黎月 Tishri 。具體的內(nèi)容就不深究了，畢竟我們在日常生活中是完全接觸不到這種歷法的。

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

日期歷法轉(zhuǎn)換

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

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

使用 unixtojd() 函數(shù)就可以將一個 unix 時(shí)間戳轉(zhuǎn)換成 jd 計(jì)數(shù)。接下來，我們看看 2020 年 9 月 23 號對應(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 號 星期三 。當(dāng)前的月份是 Tishri 提市黎月 ，對應(yīng)著公歷年的第一個月，猶太歷中教會年的第七個月，代表著秋天的到來。

cal_from_jd() 函數(shù)的作用就是根據(jù) jd計(jì)數(shù) 返回指定歷法的詳細(xì)信息。而另外一個 cal_to_jd() 函數(shù)則是從一個支持的歷法數(shù)據(jù)轉(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)換，只不過它們是直接返回的字符串類型的日期信息，不是像 cal_from_jd() 函數(shù)一樣返回日期的詳細(xì)信息。

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

GregorianToJD() 方法就是快捷地轉(zhuǎn)換一個公歷日期為 jd計(jì)數(shù) 。而 jdtoxxxxx 為些函數(shù)就是快速地返回 jd計(jì)數(shù) 對應(yīng)的日期歷法的字符串信息。

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

某個月份的天數(shù)

上面的歷史知識學(xué)習(xí)的怎么樣？接下來還是回歸到 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月 是不是 閏月 就可以用這個函數(shù)來實(shí)現(xiàn)。

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

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

總結(jié)

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