日历代码phpPHP中的国际化日历类

$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; // deecho $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; // zhecho $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)); //29var_dump($cal->getMaximum(IntlCalendar::FIELD_DAY_OF_MONTH)); //31var_dump($cal->getActualMinimum(IntlCalendar::FIELD_DAY_OF_MONTH)); //1var_dump($cal->getMinimum(IntlCalendar::FIELD_DAY_OF_MONTH)); //1var_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)); //28var_dump($cal->getMaximum(IntlCalendar::FIELD_DAY_OF_MONTH)); //31var_dump($cal->getActualMinimum(IntlCalendar::FIELD_DAY_OF_MONTH)); //1var_dump($cal->getMinimum(IntlCalendar::FIELD_DAY_OF_MONTH)); //1var_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()); // 1echo IntlDateFormatter::formatObject($cal, <<<EOD'local day of week: 'cc'week of month : 'W'week of year : 'wwEOD), 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 : 'wwEOD), 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:11printf( "两个韶光的差别： %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() 方法可以滚动或者说是卷动日历，在这里我们将日历滚动一天，也便是加了一天的韶光。

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://github.com/zhangyue0503/dev-blog/blob/master/php/202011/source/7.PHP中的国际化日历类.php

参考文档：

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