解决WordPress中strtotime()的时区偏移问题

理解WordPress中的日期时间处理

在标准的php环境中，strtotime()函数通常会根据服务器的默认时区来解析日期时间字符串。然而，在wordpress生态系统中，情况变得更为复杂。wordpress引入了自己的日期时间管理机制，通过“设置”->“常规”中的“时区”选项，允许用户为站点配置一个特定的时区。这一设置会影响到wp_date()、current_time()等wordpress核心函数，但对原生的strtotime()函数的影响却可能出乎意料，导致其在处理不带时区信息的日期时间字符串时，产生与预期不符的utc时间戳。

问题现象示例：

假设WordPress站点配置的时区为GMT+5。 当我们在一个标准的PHP编译器中执行：

var_dump(strtotime("2021-11-16 00:00:00"));

通常会得到一个表示UTC时间 2021-11-16 00:00:00 的时间戳，例如 1637020800。

然而，在WordPress站点中执行相同的代码：

var_dump(strtotime("2021-11-16 00:00:00"));

结果却可能是 1637002800。这个时间戳比预期少了5小时（1637020800 - 1637002800 = 18000 秒，即5小时），这正是因为WordPress在内部处理strtotime()时，将其输入字符串“2021-11-16 00:00:00”视为站点时区（GMT+5）下的时间，然后将其转换为UTC时间戳。因此，“2021-11-16 00:00:00 GMT+5”实际上等同于“2021-11-15 19:00:00 UTC”，从而产生了错误的UTC时间戳。

解决方案：结合wp_date()进行时区校正

为了解决strtotime()在WordPress中出现的时区偏移问题，我们可以利用wp_date()函数来“校准”日期时间字符串，使其在被strtotime()解析时能得到正确的UTC时间戳。wp_date()函数的一个关键特性是它能够根据WordPress站点的时区设置来格式化时间戳。

以下是封装好的解决方案函数：

AI建筑知识问答

用人工智能ChatGPT帮你解答所有建筑问题

22

查看详情

/**
 * 修正WordPress中strtotime()的时区偏移问题。
 *
 * 此函数确保将给定的日期时间字符串转换为UTC时间戳，
 * 即使WordPress站点配置了非UTC时区。
 *
 * @param string $str 要转换的日期时间字符串。
 * @return int 对应的UTC时间戳。
 */
function wp_strtotime($str) {
    // 步骤1: 初始的strtotime()调用。
    // 在WordPress环境中，这会将$str（被视为站点时区时间）转换为UTC时间戳。
    // 例如，"2021-11-16 00:00:00" (GMT+5) 会被转换为 2021-11-15 19:00:00 UTC 的时间戳。
    $initial_timestamp = strtotime($str);

    // 步骤2: 使用wp_date()将上一步得到的UTC时间戳，
    // 按照WordPress站点时区重新格式化为日期时间字符串。
    // 此时，如果站点时区是GMT+5，那么 2021-11-15 19:00:00 UTC 会被格式化为
    // "2021-11-16 00:00:00" (这个字符串是站点时区下的表示)。
    $formatted_datetime_str = wp_date('Y-m-d H:i:s', $initial_timestamp);

    // 步骤3: 再次使用strtotime()将这个“校准过”的日期时间字符串转换为时间戳。
    // 此时，strtotime()通常会将其视为UTC时间（或服务器默认时区，如果服务器是UTC则无影响），
    // 从而得到我们期望的正确UTC时间戳。
    // 例如，"2021-11-16 00:00:00" 会被转换为 2021-11-16 00:00:00 UTC 的时间戳。
    return strtotime($formatted_datetime_str);
}

函数工作原理详解：

1. 第一次strtotime($str)： 当你在WordPress环境中调用strtotime("2021-11-16 00:00:00")时，WordPress会将其解释为站点时区（例如GMT+5）下的“2021-11-16 00:00:00”，并将其转换为对应的UTC时间戳（即2021-11-15 19:00:00 UTC的时间戳）。这个时间戳是“不正确”的，因为它已经减去了时区偏移。
2. wp_date('Y-m-d H:i:s', $initial_timestamp)： 这一步是关键。wp_date()函数接收一个UTC时间戳（即上一步得到的“不正确”时间戳），然后根据WordPress站点的配置时区来格式化它。这意味着，wp_date()会将2021-11-15 19:00:00 UTC这个时间戳，按照GMT+5的时区规则，重新格式化为字符串“2021-11-16 00:00:00”。现在，我们得到了一个看起来与原始输入字符串相同的字符串，但它已经经过了WordPress时区规则的“洗礼”。
3. 第二次strtotime($formatted_datetime_str)： 此时，我们再次将“2021-11-16 00:00:00”这个字符串传递给strtotime()。由于这个字符串是通过wp_date()在WordPress时区环境中“规范化”过的，并且不包含显式的时区信息，strtotime()在WordPress环境中此时通常会将其解释为UTC时间（或服务器默认时区，如果服务器默认时区是UTC，则结果是UTC时间戳），从而返回我们期望的2021-11-16 00:00:00 UTC的时间戳。

通过这个巧妙的两步转换，我们成功地抵消了WordPress对strtotime()的第一次调用所施加的时区偏移，最终获得了正确的UTC时间戳。

使用示例

现在，你可以在WordPress代码中使用这个自定义的wp_strtotime函数：

$date_string = "2021-11-16 00:00:00";
$correct_timestamp = wp_strtotime($date_string);

echo "原始日期字符串: " . $date_string . "\n";
echo "校正后的UTC时间戳: " . $correct_timestamp . "\n";
echo "UTC日期时间: " . gmdate('Y-m-d H:i:s', $correct_timestamp) . "\n";

// 验证与标准PHP行为一致
echo "标准PHP strtotime 结果: " . strtotime($date_string) . "\n";

运行上述代码，你将看到wp_strtotime()返回的时间戳与标准PHP环境中的strtotime()结果一致，都是表示“2021-11-16 00:00:00 UTC”的正确时间戳。

注意事项与总结

• 时区意识： 在WordPress开发中，处理日期时间务必保持高度的时区意识。混淆服务器时区、PHP默认时区和WordPress站点时区是导致日期时间错误的主要原因。
• wp_date()与date_i18n()： wp_date()是WordPress 5.3+版本中推荐的日期格式化函数，它取代了旧版中的date_i18n()，并提供了更强大的时区处理能力。
• 输入字符串的格式： wp_strtotime()函数适用于解析不带显式时区信息的日期时间字符串。如果你的输入字符串本身就包含时区信息（例如"2021-11-16 00:00:00 GMT+8"），那么strtotime()的行为会更加明确，可能不需要此校正函数。
• 代码位置： 你可以将wp_strtotime函数添加到主题的functions.php文件或自定义插件中，使其在整个WordPress环境中可用。

通过采纳wp_strtotime这样的辅助函数，开发者可以确保在处理从用户输入或数据库中获取的日期时间字符串时，能够始终获得预期的UTC时间戳，从而避免因时区问题导致的日期计算和显示错误，提升WordPress应用程序的健壮性。

以上就是解决WordPress中strtotime()的时区偏移问题的详细内容，更多请关注php中文网其它相关文章！