(PHP 5 >= 5.3.0, PHP 7, PHP 8, PECL intl >= 1.0.0)
IntlDateFormatter::localtime -- datefmt_localtime — 将字符串解析为基于字段的时间值
面向对象风格
过程化风格
将字符串 $value 转换为基于字段的时间值（一个包含各种字段的数组），从 $parse_pos 开始，并尽可能多地使用输入值。
formatter格式化程序资源
string要转换为时间的字符串
offset在 $value 中开始解析的位置（从 0 开始）。如果在 $value 被消耗之前没有发生错误，则 $parse_pos 将包含 -1，否则它将包含解析结束的位置。如果 $parse_pos > strlen($value)，则解析立即失败。
与 localtime 兼容的整数数组：在 tm_hour 字段中包含 24 小时制时钟值，或在失败时返回 false。
示例 #1 datefmt_localtime() 示例
<?php
$fmt = datefmt_create(
'en_US',
IntlDateFormatter::FULL,
IntlDateFormatter::FULL,
'America/Los_Angeles',
IntlDateFormatter::GREGORIAN
);
$arr = datefmt_localtime($fmt, 'Wednesday, December 31, 1969 4:00:00 PM PT', 0);
echo 'First parsed output is ';
if ($arr) {
foreach ($arr as $key => $value) {
echo "$key : $value , ";
}
}
?>示例 #2 OO 示例
<?php
$fmt = new IntlDateFormatter(
'en_US',
IntlDateFormatter::FULL,
IntlDateFormatter::FULL,
'America/Los_Angeles',
IntlDateFormatter::GREGORIAN
);
$arr = $fmt->localtime('Wednesday, December 31, 1969 4:00:00 PM PT', 0);
echo 'First parsed output is ';
if ($arr) {
foreach ($arr as $key => $value) {
echo "$key : $value , ";
}
}
?>以上示例将输出
First parsed output is tm_sec : 0 , tm_min : 0 , tm_hour : 16 , tm_year : 1969 , tm_mday : 31 , tm_wday : 4 , tm_yday : 365 , tm_mon : 11 , tm_isdst : 0 ,
这里吸取的教训：永远不要相信 PHP 文档。测试一切！
$position 的工作原理与描述不符，至少在 PHP 7 中是这样。解析完成后没有错误，它不包含 -1。
您仍然可以使用它来设置解析起始字符位置，但不一定能判断是否有任何错误发生。
要测试错误，请将另一个注释中的我的 $nPosition 测试代码替换为
<?php
// 检查是否有错误
$bError = intl_is_failure(datefmt_get_error_code(oIDF));
// 如果没有错误
if(!$bError){
// 使用 $aTime 数组中的“tm_hour”和“tm_min”与其他时间值进行比较
...
}else{
// 无效字符串
...
}
?>您可以使用 datefmt_localtime 将用户使用其区域设置脚本输入的时间字符串转换为标准数字以进行检查，方法是使用简单的 HTML 输入元素。
这避免了使用使用区域设置脚本格式化的笨拙的 HTML 选择元素来捕获用户输入的小时和分钟选项。
<?php
// 指定用户的区域设置
$sLocale = 'en-us'; // 美国英语用户
$sLocale = 'ar-ye'; // 也门阿拉伯用户
// 为用户的区域设置创建一个日期格式化器
$oIDF = datefmt_create($sLocale, IntlDateFormatter::NONE, IntlDateFormatter::SHORT);
// 模拟用户的时间输入字符串
$sTime = datefmt_format($oIDF, ['tm_hour'=>15, 'tm_min'=>25]);
// 对于美国英语用户，$sTime = '3:25 PM'
// 对于也门阿拉伯用户，$sTime = '٣:٢٥ م'
// 指定 datefmt_locale 解析从用户输入的开头开始
$nPosition = 0;
// 将输入的时间字符串转换为标准数值数组，根据 localtime() 的输出 (https://php.net/manual/en/function.localtime.php)
$aTime = datefmt_localtime($oIDF, $sTime, $nPosition);
// 如果没有错误，解析后 $nPosition 设置为 -1，否则为错误的字符位置
// 如果是有效的字符串
if($nPosition = -1){
// 使用 $aTime 数组中的 'tm_hour' 和 'tm_min' 来检查其他时间值
...
}else{
// 无效的字符串
...
}
?>