PHP中的国际化日历类
在 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 信息。
总结
关于日历类其实还有很多方法函数,但是看得人非常头晕,英文解释不多,资料也不清晰,所以这里就是简单的列举了一些内容。大家还是报以学习的心态了解即可,当需要使用到的时候可以快速地想起还这些功能就可以了。
测试代码:
参考文档:
关注公众号:【硬核项目经理】获取最新文章
添加微信/qq好友:【xiaoyuezigonggong/149844827】免费得php、项目管理学习资料
知乎、公众号、抖音、头条搜索【硬核项目经理】
b站id:482780532
上一篇: 学习英文SEO需要注意的几个要点