介紹PHP國際化組件中的一個國際化日曆類

藏色散人
發布: 2023-04-10 10:54:01
轉載
3417 人瀏覽過

在PHP 的國際化元件中,還有一個我們並不是很常用的日期操作類,它就是日曆操作類。說是日曆,其實大部分還是對日期時間的操作,一般也是主要用於日期的格式化比較之類的。但通常我們直接使用 date 相關的函數或是 DateTime 相關的類別操作日期相關的功能,反而比這套功能更方便靈活。當然,本著學習的目的,我們還是來簡單地了解一下。

格式化時間

首先還是從格式化時間說起。

$cal = IntlCalendar::createInstance(IntlTimeZone::getGMT()); var_dump(get_class($cal), IntlDateFormatter::formatObject($cal, IntlDateFormatter::FULL)); // string(21) "IntlGregorianCalendar" // string(66) "2020年11月18日星期三 格林尼治标准时间 上午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() 方法會傳回一個 IntlCalendar 對象,它的參數是可選的,不過必須是 TimeZone 類型的參數。 fromDateTime() 方法同樣也是產生一個 IntlCalendar 對象,不過它可以設定一個 DateTime 物件或日期類型的字串為參數。

可以看到,我們傳回的物件使用 get_class() 方法後看到實際回傳的是一個 IntlGregorianCalendar 格林格里日曆物件。這時,就可以使用 IntlDateFormatter 類別的 formatObject() 方法來格式化輸出內容,它是可以指定地區的,不同的地區設定就會顯示不同的格式化語言結果。

返回時間戳記

echo IntlCalendar::getNow(), PHP_EOL; // 1605661094417
登入後複製

不多做解釋了,不過這個靜態方法返的是毫秒數的時間戳記。

時區相關設定

只要是國際化相關的功能,都多少和時區 TimeZone 有關,日曆類別也不例外。

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() 就可以獲得當前的時區信息,getLocale() 和之前我們文章中其它相關功能類的 getLocale() 方法沒有什麼區別,大家可以看下之前講過的內容。當然,這個 TimeZone 屬性除了透過 ini_set() 之外,也是可以直接透過物件的 setTimeZone() 方法進行修改的。

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
登入後複製

日曆相關操作

時間欄位最大、最小值相關資訊

這是什麼意思呢?先看下程式碼。

$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
登入後複製

樓上這一堆是什麼鬼?其實這幾個方法就是回傳的指定參數欄位內容的最大、最小值,例如我們看的是 FIELD_DAY_OF_MONTH ,也就是月份有多少天。 getActualMaximum() 回傳的是實際值,例如 2020 年的 2 月是有 29 天的 。 getMaximum() 回傳的是正常月份的最大值,都是 31 。 getActualMinimum() 、getMinimum() 回傳的是實際最小值和正常最小值,這個對於月份來說都是 1 ,每個月都一定會有 1 天。 getLeastMaximum() 方法是取得欄位的最小局部最大值,該怎麼理解呢? 2月份最小天數是28天,它的局部最大值也就是28天,其它月份則分為 30 和 31 天。

一週的起始日期

這個功能主要是可以設定一週的起始日期是週幾。例如對歐美的國際標準時間來說,週一並不是一週的開始,週日才是這一週的第一天。大家從各種日曆應用程式就能發現這個問題。

$cal = IntlCalendar::createInstance(); $cal->set(2020, 5, 30); var_dump($cal->getFirstDayOfWeek()); // 1 echo IntlDateFormatter::formatObject($cal, <<
         
登入後複製

在目前的時區中,我們 getFirstDayOfWeek() 回傳的結果是 1 ,也就是週一為一週的起點,週幾是從 0 開始計算的。 set() 方法可以設定具體的日期,需要注意月份也是從 0 開始的。我們再使用 IntlDateFormatter::formatObject() 輸出當前日期在周幾、在月中的第幾週以及當前周是今年的第幾週。這裡我們設定的是2020年的6 月30 號,'cc' 表示的當前日期在周中是周四,是一周中的第四天(不是指定的6月30號,是我們運行代碼時的時間,方便我們修改後查看),當前月是在當前月是第五週,當前週在整年裡的是第27 週。如果我們改變這個每週開始的時間呢?

$cal->setFirstDayOfWeek(3); var_dump($cal->getFirstDayOfWeek()); // int(5) echo IntlDateFormatter::formatObject($cal, <<
         
登入後複製

嗯,'cc' 變成 1 了,目前成為了星期一。現在是在目前月份的第 6 週了,因為我們現在一週的開始是從週四開始算的啦。

日曆比較

日曆物件比較

$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)
登入後複製

這個比較簡單,日曆物件內部的屬性不同,當然 equals() 方法回傳的結果就是 false 了。

日曆物件差值

除了比較日曆物件外,還可以取得兩個日曆時間之前的差值資訊。

$cal1 = IntlCalendar::fromDateTime('2019-1-29 09:00:11'); $cal2 = IntlCalendar::fromDateTime('2020-03-01 09:19:29'); $time = $cal2->getTime(); echo "之前的时间: ", IntlDateFormatter::formatObject($cal1), "\n"; // 之前的时间: 2019年1月29日 上午9:00:11 printf( "两个时间的差别: %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) ); // 两个时间的差别: 1 year(s), 1 month(s), 1 day(s), 0 hour(s) and 19 minute(s) echo "之后的时间: ", IntlDateFormatter::formatObject($cal1), "\n"; // 之后的时间: 2020年3月1日 上午9:19:11
登入後複製

可以看到使用 fieldDifference() 方法就可以取得日曆物件和比較日期之間相關的資訊。要注意的是,使用 fieldDifference() 之後,原來的日曆物件全變成新的日期資訊。

其它資訊

查看區域設定關鍵字值集

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() 方法的第一個參數只能固定寫calendar ,後面是填入相關的區域,傳回的內容就是當前語言環境下所支援的相關字值資訊。

區域語言類型

$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() 方法傳回的就是指定語言區域資訊的類型。

滚动日历

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() 方法可以滚动或者说是卷动日历,在这里我们将日历滚动一天,也就是加了一天的时间。

转换为 DateTime 对象

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() 方法就可以将当前的 IntlCalendar 对象转换成 DateTime 对象。

当前系统中支持的所有区域信息

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() 返回的是当前系统中所有支持可用的 Locale 信息。

总结

关于日历类其实还有很多方法函数,但是看得人非常头晕,英文解释不多,资料也不清晰,所以这里就是简单的列举了一些内容。大家还是报以学习的心态了解即可,当需要使用到的时候可以快速地想起还这些功能就可以了。

推荐学习:《PHP视频教程

以上是介紹PHP國際化組件中的一個國際化日曆類的詳細內容。更多資訊請關注PHP中文網其他相關文章!

相關標籤:
php
來源:segmentfault.com
本網站聲明
本文內容由網友自願投稿,版權歸原作者所有。本站不承擔相應的法律責任。如發現涉嫌抄襲或侵權的內容,請聯絡admin@php.cn
最新下載
更多>
網站特效
網站源碼
網站素材
前端模板
關於我們 免責聲明 Sitemap
PHP中文網:公益線上PHP培訓,幫助PHP學習者快速成長!