在 PHP 的國(guó)際化組件中，還有一個(gè)我們并不是很常用的日期操作類，它就是日歷操作類。說(shuō)是日歷，其實(shí)大部分還是對(duì)日期時(shí)間的操作，一般也是主要用于日期的格式化和比較之類的。但是通常我們直接使用 date 相關(guān)的函數(shù)或者 DateTime 相關(guān)的類操作日期相關(guān)的功能，反而比這套功能更方便靈活。當(dāng)然，本著學(xué)習(xí)的目的，我們還是來(lái)簡(jiǎn)單地了解一下。

格式化時(shí)間

首先還是從格式化時(shí)間說(shuō)起。

$cal = IntlCalendar::createInstance(IntlTimeZone::getGMT()); var_dump(get_class($cal), IntlDateFormatter::formatObject($cal, IntlDateFormatter::FULL)); // string(21) "IntlGregorianCalendar" // string(66) "2020年11月18日星期三 格林尼治標(biāo)準(zhǔn)時(shí)間 上午12:58:14"  $cal1 = IntlCalendar::fromDateTime('2013-02-28 00:01:02 Europe/Berlin'); var_dump(get_class($cal1), IntlDateFormatter::formatObject($cal1, 'yyyy MMMM d HH:mm:ss VVVV', 'de_DE')); // string(21) "IntlGregorianCalendar" // string(41) "2013 Februar 28 00:01:02 Deutschland Zeit"

IntlCalendar 類的 createInstance() 方法會(huì)返回一個(gè) IntlCalendar 對(duì)象，它的參數(shù)是可選的，不過(guò)必須是 TimeZone 類型的參數(shù)。fromDateTime() 方法同樣也是生成一個(gè) IntlCalendar 對(duì)象，不過(guò)它可以設(shè)置一個(gè) DateTime 對(duì)象或者日期類型的字符串為參數(shù)。

可以看到，我們返回的對(duì)象使用 get_class() 方法后看到實(shí)際返回的是一個(gè) IntlGregorianCalendar 格林格里日歷對(duì)象。這時(shí)，就可以使用 IntlDateFormatter 類的 formatObject() 方法來(lái)格式化輸出內(nèi)容，它是可以指定地區(qū)的，不同的地區(qū)設(shè)置就會(huì)顯示不同的格式化語(yǔ)言結(jié)果。

返回時(shí)間戳

echo IntlCalendar::getNow(), PHP_EOL; // 1605661094417

不多做解釋了，不過(guò)這個(gè)靜態(tài)方法返的是帶毫秒數(shù)的時(shí)間戳。

時(shí)區(qū)相關(guān)設(shè)置

只要是國(guó)際化相關(guān)的功能，都多少和時(shí)區(qū) TimeZone 有關(guān)，日歷類也不例外。

ini_set('intl.default_locale', 'de_DE'); ini_set('date.timezone', 'Europe/Berlin'); $cal = IntlCalendar::createInstance(); print_r($cal->getTimeZone()); // IntlTimeZone Object // ( //     [valid] => 1 //     [id] => Europe/Berlin //     [rawOffset] => 3600000 //     [currentOffset] => 3600000 // )  echo $cal->getLocale(Locale::ACTUAL_LOCALE), PHP_EOL; // de echo $cal->getLocale(Locale::VALID_LOCALE), PHP_EOL; // de_DE

使用 getTimeZone() 就可以獲得當(dāng)前的時(shí)區(qū)信息，getLocale() 和之前我們文章中其它相關(guān)功能類的 getLocale() 方法沒(méi)有什么區(qū)別，大家可以看下之前講過(guò)的內(nèi)容。當(dāng)然，這個(gè) TimeZone 屬性除了通過(guò) ini_set() 之外，也是可以直接通過(guò)對(duì)象的 setTimeZone() 方法進(jìn)行修改的。

ini_set('intl.default_locale', 'zh_CN'); ini_set('date.timezone', 'Asia/Shanghai'); $cal = IntlCalendar::createInstance(); print_r($cal->getTimeZone()); // IntlTimeZone Object // ( //     [valid] => 1 //     [id] => Asia/Shanghai //     [rawOffset] => 28800000 //     [currentOffset] => 28800000 // )  $cal->setTimeZone('UTC'); print_r($cal->getTimeZone()); // IntlTimeZone Object // ( //     [valid] => 1 //     [id] => UTC //     [rawOffset] => 0 //     [currentOffset] => 0 // )  echo $cal->getLocale(Locale::ACTUAL_LOCALE), PHP_EOL; // zh echo $cal->getLocale(Locale::VALID_LOCALE), PHP_EOL; // zh_Hans_CN

日歷相關(guān)操作

時(shí)間字段最大、最小值相關(guān)信息

這是什么意思呢？先看下代碼。

$cal = IntlCalendar::fromDateTime('2020-02-15'); var_dump($cal->getActualMaximum(IntlCalendar::FIELD_DAY_OF_MONTH)); //29 var_dump($cal->getMaximum(IntlCalendar::FIELD_DAY_OF_MONTH)); //31 var_dump($cal->getActualMinimum(IntlCalendar::FIELD_DAY_OF_MONTH)); //1 var_dump($cal->getMinimum(IntlCalendar::FIELD_DAY_OF_MONTH)); //1 var_dump($cal->getLeastMaximum(IntlCalendar::FIELD_DAY_OF_MONTH));// 28   $cal->add(IntlCalendar::FIELD_EXTENDED_YEAR, -1); var_dump($cal->getActualMaximum(IntlCalendar::FIELD_DAY_OF_MONTH)); //28 var_dump($cal->getMaximum(IntlCalendar::FIELD_DAY_OF_MONTH)); //31 var_dump($cal->getActualMinimum(IntlCalendar::FIELD_DAY_OF_MONTH)); //1 var_dump($cal->getMinimum(IntlCalendar::FIELD_DAY_OF_MONTH)); //1 var_dump($cal->getLeastMaximum(IntlCalendar::FIELD_DAY_OF_MONTH));// 28

樓上這一堆是什么鬼？其實(shí)這幾個(gè)方法就是返回的指定參數(shù)字段內(nèi)容的最大、最小值，比如我們查看的是 FIELD_DAY_OF_MONTH ，也就是月份有多少天。getActualMaximum() 返回的是實(shí)際值，比如 2020 年的 2 月份是有 29 天的 。getMaximum() 返回的是正常月份的最大值，都是 31 。getActualMinimum() 、getMinimum() 返回的是實(shí)際最小值和正常最小值，這個(gè)對(duì)于月份來(lái)說(shuō)都是 1 ，每個(gè)月都肯定會(huì)有 1 天。getLeastMaximum() 方法是獲取字段的最小局部最大值，怎么理解呢？2月份最小天數(shù)是28天，它的局部最大值也就是28天，其它月份則分 30 和 31 天。

一周的起始日期

這個(gè)功能主要是可以設(shè)置一周的起始日期是周幾。比如對(duì)于歐美的國(guó)際標(biāo)準(zhǔn)時(shí)間來(lái)說(shuō)，周一并不是一周的開(kāi)始，周日才是這一周的第一天。大家從各種日歷應(yīng)用中就能發(fā)現(xiàn)這個(gè)問(wèn)題。

$cal = IntlCalendar::createInstance(); $cal->set(2020, 5, 30); var_dump($cal->getFirstDayOfWeek()); // 1 echo IntlDateFormatter::formatObject($cal, <<<EOD 'local day of week: 'cc' week of month    : 'W' week of year     : 'ww EOD ), PHP_EOL; // local day of week: 3 // week of month    : 5 // week of year     : 27

在當(dāng)前的時(shí)區(qū)中，我們 getFirstDayOfWeek() 返回的結(jié)果是 1 ，也就是周一為一周的起點(diǎn)，周幾是從 0 開(kāi)始計(jì)算的。set() 方法可以設(shè)置具體的日期，需要注意月份也是從 0 開(kāi)始的。我們?cè)偈褂?IntlDateFormatter::formatObject() 輸出當(dāng)前日期在周幾、在月中的第幾周以及當(dāng)前周是今年的第幾周。在這里我們?cè)O(shè)置的是 2020年的 6 月 30 號(hào)，'cc' 表示的當(dāng)前日期在周中是周四，是一周中的第四天（不是指定的6月30號(hào)，是我們運(yùn)行代碼時(shí)的時(shí)間，方便我們修改后查看），當(dāng)前周是在當(dāng)前月是第五周，當(dāng)前周在整年里的是第 27 周。如果我們改變這個(gè)每周開(kāi)始的時(shí)間呢？

$cal->setFirstDayOfWeek(3); var_dump($cal->getFirstDayOfWeek());  // int(5) echo IntlDateFormatter::formatObject($cal, <<<EOD 'local day of week: 'cc' week of month    : 'W' week of year     : 'ww EOD ), PHP_EOL; // local day of week: 1 // week of month    : 6 // week of year     : 27

嗯，'cc' 變?yōu)?1 了，當(dāng)前成為了周一。現(xiàn)在是在當(dāng)前月份的第 6 周了，因?yàn)槲覀儸F(xiàn)在一周的開(kāi)始是從周四開(kāi)始算的啦。

日歷比較

日歷對(duì)象比較

$cal1 = IntlCalendar::createInstance(); $cal2 = IntlCalendar::createInstance(); var_dump($cal1->equals($cal2)); // bool(true) $cal2->setTime($cal1->getTime() + 1); var_dump($cal1->equals($cal2)); // bool(false)

這個(gè)比較簡(jiǎn)單，日歷對(duì)象內(nèi)部的屬性不同，當(dāng)然 equals() 方法返回的結(jié)果就是 false 了。

日歷對(duì)象差值

除了比較日歷對(duì)象外，還可以獲取兩個(gè)日歷時(shí)間之前的差值信息。

$cal1 = IntlCalendar::fromDateTime('2019-1-29 09:00:11'); $cal2 = IntlCalendar::fromDateTime('2020-03-01 09:19:29'); $time = $cal2->getTime();  echo "之前的時(shí)間: ", IntlDateFormatter::formatObject($cal1), "n"; // 之前的時(shí)間: 2019年1月29日 上午9:00:11  printf(     "兩個(gè)時(shí)間的差別： %d year(s), %d month(s), "   . "%d day(s), %d hour(s) and %d minute(s)n",     $cal1->fieldDifference($time, IntlCalendar::FIELD_YEAR),     $cal1->fieldDifference($time, IntlCalendar::FIELD_MONTH),     $cal1->fieldDifference($time, IntlCalendar::FIELD_DAY_OF_MONTH),     $cal1->fieldDifference($time, IntlCalendar::FIELD_HOUR_OF_DAY),     $cal1->fieldDifference($time, IntlCalendar::FIELD_MINUTE) ); // 兩個(gè)時(shí)間的差別： 1 year(s), 1 month(s), 1 day(s), 0 hour(s) and 19 minute(s)   echo "之后的時(shí)間: ", IntlDateFormatter::formatObject($cal1), "n"; // 之后的時(shí)間: 2020年3月1日 上午9:19:11

可以看到使用 fieldDifference() 方法就可以獲得日歷對(duì)象和比較日期之間相關(guān)的信息。需要注意的是，使用 fieldDifference() 之后，原來(lái)的日歷對(duì)象全變成新的日期信息。

其它信息

查看區(qū)域設(shè)置關(guān)鍵字值集

print_r(iterator_to_array(IntlCalendar::getKeywordValuesForLocale('calendar', 'zh_CN', true))); // Array // ( //     [0] => gregorian //     [1] => chinese // ) print_r(iterator_to_array(IntlCalendar::getKeywordValuesForLocale('calendar', 'zh_CN', false))); // Array // ( //     [0] => gregorian //     [1] => chinese //     [2] => japanese //     [3] => buddhist //     [4] => roc //     [5] => persian //     [6] => islamic-civil //     [7] => islamic //     [8] => hebrew //     [9] => indian //     [10] => coptic //     [11] => ethiopic //     [12] => ethiopic-amete-alem //     [13] => iso8601 //     [14] => dangi //     [15] => islamic-umalqura //     [16] => islamic-tbla //     [17] => islamic-rgsa // )

getKeywordValuesForLocale() 方法的第一個(gè)參數(shù)只能固定寫 calendar ，后面是填寫相關(guān)的區(qū)域，返回的內(nèi)容就是當(dāng)前語(yǔ)言環(huán)境下所支持的相關(guān)字值信息。

區(qū)域語(yǔ)言類型

$cal = IntlCalendar::createInstance(NULL, '@calendar=ethiopic-amete-alem'); var_dump($cal->getType()); // string(19) "ethiopic-amete-alem"  $cal = new IntlGregorianCalendar(); var_dump($cal->getType()); // string(9) "gregorian"

很明顯，getType() 方法返回的就是指定語(yǔ)言區(qū)域信息的類型。

滾動(dòng)日歷

var_dump(IntlDateFormatter::formatObject($cal)); // string(31) "2020年11月18日 上午9:14:59" $cal->roll(IntlCalendar::FIELD_DAY_OF_MONTH, true); var_dump(IntlDateFormatter::formatObject($cal)); // string(31) "2020年11月19日 上午9:14:59"

使用 roll() 方法可以滾動(dòng)或者說(shuō)是卷動(dòng)日歷，在這里我們將日歷滾動(dòng)一天，也就是加了一天的時(shí)間。

轉(zhuǎn)換為 DateTime 對(duì)象

var_dump($cal->toDateTime()); // object(DateTime)#4 (3) { //     ["date"]=> //     string(26) "2020-11-19 09:14:59.000000" //     ["timezone_type"]=> //     int(3) //     ["timezone"]=> //     string(13) "Asia/Shanghai" //   }

使用 toDateTime() 方法就可以將當(dāng)前的 IntlCalendar 對(duì)象轉(zhuǎn)換成 DateTime 對(duì)象。

當(dāng)前系統(tǒng)中支持的所有區(qū)域信息

print_r(IntlCalendar::getAvailableLocales()); // Array // ( //     [0] => af //     [1] => af_NA //     [2] => af_ZA //     [3] => agq //     [4] => agq_CM //     [5] => ak //     [6] => ak_GH //     [7] => am //     [8] => am_ET //     [9] => ar //     …… //     ……

getAvailableLocales() 返回的是當(dāng)前系統(tǒng)中所有支持可用的 Locale 信息。

總結(jié)

關(guān)于日歷類其實(shí)還有很多方法函數(shù)，但是看得人非常頭暈，英文解釋不多，資料也不清晰，所以這里就是簡(jiǎn)單的列舉了一些內(nèi)容。大家還是報(bào)以學(xué)習(xí)的心態(tài)了解即可，當(dāng)需要使用到的時(shí)候可以快速地想起還這些功能就可以了。

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