在 WooCommerce 中自定义显示商品促销起止日期时，常因时间戳处理不当导致起始日显示比后台设置早一天；根本原因是未考虑时区偏移，应使用 getOffsetTimestamp() 替代 getTimestamp()。
在 woocommerce 中自定义显示商品促销起止日期时，常因时间戳处理不当导致起始日显示比后台设置早一天；根本原因是未考虑时区偏移，应使用 `getoffsettimestamp()` 替代 `gettimestamp()`。
WordPress 和 WooCommerce 的日期对象（如 WC_DateTime）默认以 UTC 存储时间，但前端展示需适配站点本地时区。getTimestamp() 返回的是基于 UTC 的 Unix 时间戳（即不包含时区偏移），而 date_i18n() 函数在格式化时会依据 WordPress 设置的时区进行转换——这会导致当站点时区为东八区（UTC+8）时，getTimestamp() 解析出的时间被错误地当作 UTC 时间再加 8 小时，从而造成「显示提前一天」的现象（尤其对零点开始的促销尤为明显）。
正确做法是调用 getOffsetTimestamp()：该方法返回已应用当前时区偏移的本地时间戳，确保与 date_i18n() 的时区逻辑一致。
以下是修复后的完整代码（已优化可读性与健壮性）：
function customize_woocommerce_get_price_html( $price, $product ) {
// 仅在单产品页且为简单型或变体商品时执行
if ( ! is_product() || ! in_array( $product->get_type(), [ 'simple', 'variation' ], true ) ) {
return $price;
}
$start = $product->get_date_on_sale_from();
$end = $product->get_date_on_sale_to();
// 检查促销日期是否有效（非空且为 WC_DateTime 实例）
if ( ! $start || ! $end || ! is_a( $start, 'WC_DateTime' ) || ! is_a( $end, 'WC_DateTime' ) ) {
return $price;
}
$start_formatted = date_i18n( 'j F Y', $start->getOffsetTimestamp() );
$end_formatted = date_i18n( 'j F Y', $end->getOffsetTimestamp() );
$sale_schedule = sprintf(
'<div class="sale-schedule">
<p>%s<span>%s</span></p>
<p>%s<span>%s</span></p>
</div>',
esc_html__( 'Start discount', 'woocommerce' ),
esc_html( $start_formatted ),
esc_html__( 'End discount', 'woocommerce' ),
esc_html( $end_formatted )
);
// 安全替换原价 HTML 中的 </del> 标签（避免破坏结构）
return str_replace( '</del>', '</del>' . $sale_schedule, $price );
}
add_filter( 'woocommerce_get_price_html', 'customize_woocommerce_get_price_html', 100, 2 );✅ 关键改进说明：
- 使用 getOffsetTimestamp() 确保时区一致性，彻底解决起始日偏移问题；
- 增加类型校验（is_a( $date, 'WC_DateTime' )），防止空值或异常对象引发 PHP 警告；
- 采用 sprintf() 和 esc_html() 提升安全性与可维护性；
- 合并重复逻辑，避免 simple/variation 分支冗余；
- 注释清晰，便于后续维护。
⚠️ 注意事项：
- 若促销时间精确到小时分钟（如「8月1日 10:00 开始」），建议改用 'j F Y \a\t g:i A' 格式，并确认后台设置的时区（WP 后台 → 设置 → 常规 → 时区）与服务器实际时区一致；
- 修改后请清空对象缓存（如有 WP Rocket、Redis 等），并测试不同语言环境下的翻译兼容性；
- 不建议直接修改主题 functions.php —— 推荐封装为轻量插件，避免主题更新丢失逻辑。
通过这一调整，促销日期将严格按商家在后台设置的本地时间准确呈现，提升用户信任与运营准确性。
