共计 7036 个字符，预计需要花费 18 分钟才能阅读完成。
在 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
各自媒体平台均可搜寻【硬核项目经理】