乐趣区

关于php:PHP中的国际化日历类

jiezi

在 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, <<<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

在以后的时区中，咱们 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, <<<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’ 变为 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 信息。

总结

对于日历类其实还有很多办法函数，然而看得人十分头晕，英文解释不多，材料也不清晰，所以这里就是简略的列举了一些内容。大家还是报以学习的心态理解即可，当须要应用到的时候能够疾速地想起还这些性能就能够了。

测试代码：

参考文档：

https://www.php.net/manual/zh/class.intlcalendar.php

各自媒体平台均可搜寻【硬核项目经理】

退出移动版