對于國際化功能來說，日期相關的格式化操作也是一塊重頭戲，畢竟不同的時區，不同的國家對于日期的表示方式都會有些不同，今天我們主要來學習的就是國際化地表示日期相關的資訊內容，
日期格式化
首先就是最直接的格式化能力，
$fmt = new IntlDateFormatter( "en_US" ,IntlDateFormatter::FULL, IntlDateFormatter::FULL,
'America/Los_Angeles',IntlDateFormatter::GREGORIAN );
echo "en_US 格式化結果為： ".$fmt->format(time()), PHP_EOL;
// en_US 格式化結果為： Friday, November 20, 2020 at 4:45:06 PM Pacific Standard Time
$fmt = new IntlDateFormatter( "de-DE" ,IntlDateFormatter::FULL, IntlDateFormatter::FULL,
'America/Los_Angeles',IntlDateFormatter::GREGORIAN );
echo "de_DE 格式化結果為： ".$fmt->format(IntlCalendar::createInstance()), PHP_EOL;
// de_DE 格式化結果為： Freitag, 20. November 2020 um 16:45:06 Nordamerikanische Westküsten-Normalzeit
$fmt = new IntlDateFormatter( "zh-CN" ,IntlDateFormatter::FULL, IntlDateFormatter::FULL,
'Asia/Shanghai',IntlDateFormatter::GREGORIAN );
echo "zh-CN 格式化結果為： ".$fmt->format(time()), PHP_EOL;
// zh-CN 格式化結果為： 2020年11月21日星期六 中國標準時間 上午8:45:06
IntlDateFormatter 物件就是國際化組件中對于日期格式化的操作類，它的構造引數很多，不過其實非常簡單，第一個引數是國家區域設定，第二和第三個引數分別是日期和日間的顯示格式，這個我們下段代碼將演示，第四個引數是時區設定，第五個引數是時間規范，這里指定的是格里高利時間，
使用 format() 方法就可以對時間戳或者日歷物件進行日期時間的格式化，它只能接收這兩種型別的引數并進行格式化，它會根據 IntlDateFormatter 物件所設定的各種引數進行輸出，比如輸出的語言是英語、德語、中文等，輸出的時間是按時區（中國8點，美國下午4點），
對于日期和時間的顯示格式，我們可以使用幾個 IntlDateFormatter 類的常量來表示，主要有 FULL 、 SHORT 、MEDIUM、 LONG 這些型別，
$fmt = new IntlDateFormatter( "zh-CN" ,IntlDateFormatter::SHORT, IntlDateFormatter::LONG,
'Asia/Shanghai',IntlDateFormatter::GREGORIAN );
echo "zh-CN 格式化結果為： ".$fmt->format(time()), PHP_EOL;
// zh-CN 格式化結果為： 2020/11/21 GMT+8 上午8:45:06
另外，建構式的第六個引數是可以指定格式化的格式規則的，
$fmt = new IntlDateFormatter( "zh-CN" ,IntlDateFormatter::FULL, IntlDateFormatter::FULL,
'Asia/Shanghai',IntlDateFormatter::GREGORIAN, 'yyyy/MM/dd' );
echo "zh-CN 格式化結果為： ".$fmt->format(time()), PHP_EOL;
// zh-CN 格式化結果為： 2020/11/21
根據指定物件格式化日期
上文中的 format() 方法我們看到只能使用時間戳和日歷物件型別，其實還有另一種更強大的格式化方法，它就是 formatObject() 方法，從名字可以推斷出，它是根據指定的物件來格式化日期資料，
$cal = IntlCalendar::createInstance(new DateTimeZone('Asia/Shanghai'));
echo IntlDateFormatter::formatObject($cal),PHP_EOL;
// Nov 21, 2020, 8:45:06 AM
echo IntlDateFormatter::formatObject($cal, IntlDateFormatter::FULL),PHP_EOL;
// Saturday, November 21, 2020 at 8:45:06 AM China Standard Time
echo IntlDateFormatter::formatObject($cal, IntlDateFormatter::NONE, IntlDateFormatter::FULL),PHP_EOL;
// 20201121 08:45 AM
echo IntlDateFormatter::formatObject($cal, IntlDateFormatter::FULL, 'zh-CN'),PHP_EOL;
// 2020年11月21日星期六 中國標準時間 上午8:45:06
echo IntlDateFormatter::formatObject($cal, "d 'of' MMMM y", 'zh-CN'), PHP_EOL;
// 21 of 十一月 2020
最常用的依然是對日歷物件的格式化，可以看到 formatObject() 方法的引數更多一些，它也可以直接指定日期和時間的格式形式以及相關的語言設定，另外，它還可以指定豐富的輸出規則，比如我們最后一段代碼輸出的是當天在這個月中是第幾天，在 PHP中的國際化日歷類 這篇文章中，我們也使用過這個方法來進行測驗，自定義的語法規則非常多，大家可以自己查閱 ICU 相關的檔案，
除了對于日歷類的格式化之外，formatObject() 方法還可以對 DateTime 物件進行日期格式化地輸出，
$dt = new DateTime();
echo IntlDateFormatter::formatObject($dt),PHP_EOL;
// Nov 21, 2020, 8:45:06 AM
不過需要注意的是，從官方檔案的 Note 來看，formatObject() 的速度非常慢，在 PHP5 下面與 format() 方法有 10 倍左右的差距，在 PHP7 下也有 3 倍左右的差距，所以說，如果不是有特別的需求的話，盡量還是不要使用 formatObject() 這個方法來格式化日期時間，
反決議日期字串
和之前我們在 學習PHP中國際化地數字格式處理 中講過的一樣，我們可以將物件或者時間戳格式化為標準的字串格式顯示，那么能不能將這種標準的字串格式資料再反轉回來呢？
$fmt = new IntlDateFormatter( "en_US" ,IntlDateFormatter::FULL, IntlDateFormatter::FULL,
'America/Los_Angeles',IntlDateFormatter::GREGORIAN );
$arr = $fmt->localtime($fmt->format(time()));
print_r($arr);
// Array
// (
// [tm_sec] => 1
// [tm_min] => 59
// [tm_hour] => 16
// [tm_year] => 120
// [tm_mday] => 20
// [tm_wday] => 5
// [tm_yday] => 325
// [tm_mon] => 10
// [tm_isdst] => 0
// )
echo $fmt->parse("Thursday, November 19, 2020 at 5:05:41 PM Pacific Standard Time"), PHP_EOL;
// 1605834341
localtime() 方法就是用于決議給定的標準日期內容的，根據 IntlDateFormatter 初始化時的規則，將字串的內容反向輸出為一個陣列，其中包含了年、月、日、時、分、秒等資訊，而 parse() 方法則是直接將給定的內容轉換為對應的時間戳，
$fmt = new IntlDateFormatter( "zh-CN" ,IntlDateFormatter::FULL, IntlDateFormatter::FULL,
'Asia/Shanghai',IntlDateFormatter::GREGORIAN );
$arr = $fmt->localtime("2020年11月20日星期五 中國標準時間 上午8:54:08");
print_r($arr);
// Array
// (
// [tm_sec] => 8
// [tm_min] => 54
// [tm_hour] => 8
// [tm_year] => 120
// [tm_mday] => 20
// [tm_wday] => 5
// [tm_yday] => 325
// [tm_mon] => 10
// [tm_isdst] => 0
// )
echo $fmt->parse("2020年11月20日星期五 中國標準時間 上午8:54:08"), PHP_EOL;
// 1605833648
不管是中英文都是良好支持的，
相關屬性獲取及設定
日歷型別資訊
對于日歷型別來說，只有兩種型別的日歷，GREGORIAN 和 TRADITIONAL，分別對應的是格里高利和傳統日歷，在構造引數中我們可以通過第五個引數指定，也可以在物件使用的程序中使用 setCalendar() 方法來設定，getCalendar() 方法用于獲取當前設置的日期型別資訊，
$fmt = new IntlDateFormatter( "en_US" ,IntlDateFormatter::FULL, IntlDateFormatter::FULL,
'America/Los_Angeles',IntlDateFormatter::GREGORIAN );
echo $fmt->getCalendar(), PHP_EOL; // 1
$fmt->setCalendar(IntlDateFormatter::TRADITIONAL);
echo $fmt->getCalendar(), PHP_EOL; // 0
日期和時間型別
// 日期型別獲取及設定
$fmt = new IntlDateFormatter( "en_US" ,IntlDateFormatter::FULL, IntlDateFormatter::FULL,
'America/Los_Angeles',IntlDateFormatter::GREGORIAN );
echo $fmt->getDateType(), PHP_EOL; // 0
$fmt = new IntlDateFormatter( "en_US" ,IntlDateFormatter::SHORT, IntlDateFormatter::FULL,
'America/Los_Angeles',IntlDateFormatter::GREGORIAN );
echo $fmt->getDateType(), PHP_EOL; // 3
// 時間型別獲取及設定
echo $fmt->getTimeType(), PHP_EOL; // 0
$fmt = new IntlDateFormatter( "en_US" ,IntlDateFormatter::SHORT, IntlDateFormatter::MEDIUM,
'America/Los_Angeles',IntlDateFormatter::GREGORIAN );
echo $fmt->getTimeType(), PHP_EOL; // 2
對于日期和時間型別來說，我們只能通過建構式的引數進行指定，獲取到的也是對應常量的值，
區域語言資訊
echo $fmt->getLocale(), PHP_EOL; // en
echo $fmt->getLocale(Locale::VALID_LOCALE), PHP_EOL; // en_US
這個就不多做解釋了，之前的文章中都有，似乎國際化相關組件的類中都會包含這兩個方法，
格式規則獲取及設定
我們可以在建構式的第六個引數中指定格式化的規則，同時也可以對物件進行動態的設定，
echo $fmt->getPattern(), PHP_EOL; // M/d/yy, h:mm:ss a
$fmt->setPattern('yyyyMMdd hh:mm:ss z');
echo $fmt->getPattern(), PHP_EOL; // yyyyMMdd hh:mm:ss z
echo $fmt->format(time()), PHP_EOL; // 20201120 04:59:01 PST
使用 setPattern() 設定格式規則之后，再次進行 formar() 就是以新的格式規則進行格式化了，
時區設定
首先我們來看一個 getTimezoneId() 方法，它是直接獲取時區內容的，也就是一個字串，
echo $fmt->getTimezoneId(), PHP_EOL; // America/Los_Angeles
// $fmt->setTimeZoneId('CN'); // PHP7 已洗掉
// echo $fmt->getTimezoneId(), PHP_EOL;
不過在 PHP7 中已經洗掉了 setTimezoneId() 方法，現在推薦是使用 setTimezone() 方法來設定時區資訊，我們馬上來看看，
var_dump($fmt->getTimezone());
// object(IntlTimeZone)#4 (4) {
// ["valid"]=>
// bool(true)
// ["id"]=>
// string(19) "America/Los_Angeles"
// ["rawOffset"]=>
// int(-28800000)
// ["currentOffset"]=>
// int(-28800000)
// }
$fmt->setTimeZone('Asia/Shanghai');
var_dump($fmt->getTimezone());
// object(IntlTimeZone)#4 (4) {
// ["valid"]=>
// bool(true)
// ["id"]=>
// string(13) "Asia/Shanghai"
// ["rawOffset"]=>
// int(28800000)
// ["currentOffset"]=>
// int(28800000)
// }
$fmt->setTimeZone('GMT+00:30');
var_dump($fmt->getTimezone());
// object(IntlTimeZone)#4 (4) {
// ["valid"]=>
// bool(true)
// ["id"]=>
// string(9) "GMT+00:30"
// ["rawOffset"]=>
// int(1800000)
// ["currentOffset"]=>
// int(1800000)
// }
與 getTimezoneId() 方法不同的是，getTimezone() 方法回傳的是一個 IntlTimeZone 物件，關于這個物件的內容官方檔案不全，很多方法引數都沒有寫，我也不好猜測，所以不會寫這個物件的文章，大家可以自己查閱相關的資料，不過對于簡單的設定時區來說，setTimezone() 方法可以直接使用字串做為引數，比如我們在上面的代碼分別將美國洛杉磯的時區修改為中國上海以及GMT+00:30這兩種時區，對應地，如果我們再 format() 輸出時間的話，就是以當前時區的標準時間為準進行輸出了，
獲取日歷物件
本身在格式化資料的時候，我們就與日歷物件打了很多交道，當然通過 IntlDateFormatter 物件我們也是可以獲得日歷資訊的，
$cal = $fmt->getCalendarObject();
var_dump(
$cal->getType(),
$cal->getTimeZone(),
$cal->getLocale(Locale::VALID_LOCALE)
);
// string(9) "gregorian"
// object(IntlTimeZone)#3 (4) {
// ["valid"]=>
// bool(true)
// ["id"]=>
// string(9) "GMT+00:30"
// ["rawOffset"]=>
// int(1800000)
// ["currentOffset"]=>
// int(1800000)
// }
// string(5) "en_US"
寬容能力
最后我們再看一下寬容能力，其實也就是一種嚴格模式的操作，比如我們如果定義一個錯誤的時間，IntlDateFormatter 中的操作并不會報錯，因為它默認是寬容處理的，
$fmt->setPattern('dd/mm/yyyy');
var_dump($fmt->isLenient()); // bool(true)
echo $fmt->parse('35/13/1955'), PHP_EOL;
// -470449020
很明顯，這個日期是一個錯誤的日期，通過 isLenient() 方法我們可以獲取當前是否是寬容處理的狀態，我們現在將寬容處理的能力取消掉，再看看會是什么結果，
$fmt->setLenient(FALSE);
echo $fmt->parse('35/13/1955'), PHP_EOL;
//
echo $fmt->getErrorCode(), PHP_EOL; // 9
echo $fmt->getErrorMessage(), PHP_EOL; // Date parsing failed: U_PARSE_ERROR
parse() 方法沒有任何輸出了，同時通過 getErrorCode() 和 getErrorMessage() 也看到了錯誤資訊，這就是 IntlDateFormatter 物件中寬容處理的主要能力，
總結
今天學習的內容比較多和零散，不過主要都是 IntlDateFormatter 這個物件的內容，數字和日期格式是國際化相關功能中最主要的功能，也能夠隨時應用到我們的日常業務開發中，大家可以多多地學習了解相關的知識，
測驗代碼：
https://github.com/zhangyue0503/dev-blog/blob/master/php/202011/source/8.學習PHP中的國際化日期格式化操作.php
參考檔案：
https://www.php.net/manual/zh/class.intldateformatter.php
===============
關注公眾號：【硬核專案經理】獲取最新文章
添加微信/QQ好友：【xiaoyuezigonggong/149844827】免費得PHP、專案管理學習資料
知乎、公眾號、抖音、頭條搜索【硬核專案經理】
B站ID：482780532
轉載請註明出處，本文鏈接：https://www.uj5u.com/houduan/295996.html
標籤：PHP
上一篇：PHP中的國際化日歷類