在电子商务平台中，向用户展示商品已上线或发布了多长时间，可以为商品增添一份历史感或信任度。然而，精确计算两个日期之间的时间差，尤其是在涉及到年、月、日时，并非简单的时间戳相减。传统的基于秒数进行年、月、日转换的方法，往往会因为闰年、不同月份的天数差异而导致计算结果不准确。
传统时间戳计算的局限性
许多开发者可能会尝试通过获取两个日期的时间戳，然后计算它们的差值（秒数），再将秒数除以固定值来估算年、月、日。例如：
- 年 = 差值 / (365 * 24 * 60 * 60)
- 月 = (差值 - 年的秒数) / (30 * 24 * 60 * 60)
- 日 = (差值 - 年的秒数 - 月的秒数) / (24 * 60 * 60)
这种方法的问题在于，一年并非总是365天，一个月也并非总是30天。闰年多一天，不同月份天数各异，这会导致计算结果出现几天甚至更多的偏差。
解决方案：利用 PHP 的 DateTime 和 DateInterval 类
PHP 提供了功能强大的 DateTime 类，用于处理日期和时间。更重要的是，DateTime 对象的 diff() 方法能够计算两个日期之间的精确差值，并返回一个 DateInterval 对象。DateInterval 对象包含了精确的年（y）、月（m）、日（d）等时间单位。这是解决日期计算误差问题的最佳实践。
核心原理
- 创建 DateTime 对象： 将需要比较的两个日期（例如，产品创建日期和当前日期）转换为 DateTime 对象。
- 使用 diff() 方法： 调用其中一个 DateTime 对象的 diff() 方法，传入另一个 DateTime 对象作为参数。
- 获取 DateInterval： diff() 方法将返回一个 DateInterval 对象，该对象包含精确的年、月、日、小时、分钟、秒等差异信息。
在 WooCommerce 中实现产品上线时长显示
以下代码演示了如何在 WooCommerce 中，利用 DateTime 和 DateInterval 类，准确计算并显示产品的上线时长。
get_date_created();
// 如果产品没有创建日期，则返回空
if ( ! $creation_date_wc ) {
return '';
}
// 将 WC_DateTime 对象转换为标准的 DateTime 对象，确保兼容性（尽管WC_DateTime通常可以直接用）
// 实际上，WC_DateTime 已经继承了 DateTime，可以直接使用。这里是为了明确转换。
// 如果直接使用 $creation_date_wc，代码会更简洁。
$creation_date = new DateTime( $creation_date_wc->format( 'Y-m-d H:i:s' ), $creation_date_wc->getTimezone() );
// 获取当前日期和时间
$current_date = new DateTime();
// 计算两个日期之间的差值，返回 DateInterval 对象
$interval = $creation_date->diff( $current_date );
// 构建输出字符串
$parts = [];
if ( $interval->y > 0 ) {
$parts[] = $interval->y . ' ' . _n( 'year', 'years', $interval->y, 'your-text-domain' );
}
if ( $interval->m > 0 ) {
$parts[] = $interval->m . ' ' . _n( 'month', 'months', $interval->m, 'your-text-domain' );
}
if ( $interval->d > 0 ) {
$parts[] = $interval->d . ' ' . _n( 'day', 'days', $interval->d, 'your-text-domain' );
}
// 如果所有单位都为0，表示当天创建
if ( empty( $parts ) ) {
return '' . __( 'Product Live For: Less than a day', 'your-text-domain' ) . '';
}
// 格式化输出字符串，例如 "X years, Y months and Z days"
$output_string = '';
if ( count( $parts ) === 1 ) {
$output_string = $parts[0];
} elseif ( count( $parts ) === 2 ) {
$output_string = implode( ' and ', $parts );
} else {
$last_part = array_pop( $parts );
$output_string = implode( ', ', $parts ) . ' and ' . $last_part;
}
return sprintf(
'%s %s',
__( 'Product Live For:', 'your-text-domain' ),
$output_string
);
}
/**
* 在 WooCommerce 单个产品页面显示产品上线时长
*/
add_action( 'woocommerce_single_product_summary', 'display_single_product_published_time_accurate', 25 );
function display_single_product_published_time_accurate() {
global $product;
echo get_product_published_time_accurate( $product );
}
/**
* 在 WooCommerce 产品循环（商店、分类归档页）显示产品上线时长
*/
add_action( 'woocommerce_after_shop_loop_item', 'display_product_loop_published_time_accurate', 20 );
function display_product_loop_published_time_accurate() {
global $product;
echo get_product_published_time_accurate( $product );
}代码说明：
-
get_product_published_time_accurate( $product ) 函数：
- 接收一个 WC_Product 对象作为参数。
- $product->get_date_created()：这是获取 WooCommerce 产品创建日期的推荐方法，它返回一个 WC_DateTime 对象，该对象继承自 PHP 的 DateTime 类。
- new DateTime()：创建一个表示当前日期和时间的 DateTime 对象。
- $creation_date->diff( $current_date )：计算两个 DateTime 对象之间的差值，返回一个 DateInterval 对象。
- $interval->y, $interval->m, $interval->d：从 DateInterval 对象中获取精确的年、月、日差值。
- _n()：这是一个 WordPress 函数，用于处理复数形式的字符串，确保“year”和“years”等单词的正确显示。
- 构建输出字符串时，我们通过条件判断来避免显示零值的单位（例如，如果不足一年，则不显示“0 years”）。
-
钩子（Actions）：
- add_action( 'woocommerce_single_product_summary', 'display_single_product_published_time_accurate', 25 );：将函数挂载到 woocommerce_single_product_summary 钩子上，使其在单个产品页面的产品摘要区域显示。优先级 25 意味着它会在默认摘要内容之后显示。
- add_action( 'woocommerce_after_shop_loop_item', 'display_product_loop_published_time_accurate', 20 );：将函数挂载到 woocommerce_after_shop_loop_item 钩子上，使其在商店、分类归档等产品列表页的每个产品项下方显示。优先级 20 确保它在产品标题和价格之后显示。
注意事项与最佳实践
- 文本域（Text Domain）： 在 _n() 和 __() 等翻译函数中，请将 'your-text-domain' 替换为您主题或插件的实际文本域，以便于国际化。
- 代码位置： 将上述代码放置在您主题的 functions.php 文件中，或者更推荐的做法是，将其封装在一个自定义插件中，以确保在主题更新时代码不会丢失。
- 样式调整： 输出的 div 元素带有 product-published-time 类，您可以利用此 CSS 类来调整显示样式的字体、颜色、边距等。
- 时区处理： WC_DateTime 和 DateTime 类在处理时区方面非常强大。WC_DateTime 通常会根据 WordPress 的设置来处理时区，而 new DateTime() 默认使用服务器的默认时区。在大多数情况下，它们能够正确协同工作，确保日期计算基于正确的时区。
- 性能考量： 对于每个产品都执行日期计算，在产品数量非常多的页面上可能会有轻微的性能开销，但对于大多数网站而言，这通常不是问题。
通过采用 PHP 的 DateTime 和 DateInterval 类，您可以确保 WooCommerce 产品上线时长的显示既精确又专业，从而提升用户体验并避免因日期计算错误而引发的问题。
