在WooCommerce中精确显示产品发布时长：避免闰年与月份差异问题

理解日期计算的挑战

在网站上显示产品已发布的时间长度，例如“X年Y月Z天”，是一个常见的需求。然而，如果采用简单的时间戳相减并手动转换为年、月、日的方法，很容易遇到准确性问题。这是因为闰年会导致每年天数不同（365或366天），而每个月的天数也各不相同（28、29、30或31天）。简单地将总秒数除以固定天数来计算年、月、日，会导致结果出现几天甚至数月的偏差。

例如，原始的计算逻辑可能如下： $y = floor($dateDifference / (365*60*60*24));$m = floor(($dateDifference - $y * 365*60*60*24) / (30*60*60*24));$d = floor(($dateDifference - $y * 365*60*60*24 - $m*30*60*60*24)/ (60*60*24)); 这种方法忽略了闰年和月份天数的实际变化，从而导致计算结果不准确。

推荐方案：利用PHP DateTime 和 DateInterval

PHP提供了功能强大的DateTime和DateInterval类，它们是处理日期和时间计算的官方推荐方式。这些类能够自动处理复杂的日期逻辑，包括闰年、月份天数差异以及时区问题，从而确保日期计算的准确性。

• DateTime 类：用于创建和操作日期时间对象。它可以从各种格式的日期字符串中解析出日期时间。
• diff() 方法：DateTime类的一个方法，用于计算两个DateTime对象之间的差值，返回一个DateInterval对象。
• DateInterval 类：表示一个时间间隔（如多少年、多少月、多少天、多少小时等）。它提供了直接访问年（y）、月（m）、日（d）等属性，这些属性是经过精确计算的。

WooCommerce 产品发布时长显示实现

为了在WooCommerce中准确显示产品的发布时长，我们将创建一个函数，该函数利用DateTime和DateInterval来计算产品从创建日期到当前日期的精确时间间隔。然后，通过WooCommerce的动作钩子将此信息显示在产品页面和商品循环中。

核心实现函数

首先，定义一个核心函数来获取并格式化产品发布时长。

/**
 * 精确计算并显示WooCommerce产品的发布时长（年、月、日）。
 * 使用PHP的DateTime和DateInterval类，确保日期计算的准确性。
 */
function display_product_age_accurate() {
    global $product; // 获取当前WooCommerce产品对象

    // 检查产品对象是否存在，如果不存在则退出
    if ( ! $product ) {
        return;
    }

    // 获取产品的发布日期。get_the_date() 默认获取当前文章的发布日期。
    // 对于WooCommerce产品，这通常是post_date。
    // 使用 'Y-m-d' 格式确保 DateTime 构造函数正确解析日期。
    $published_date_str = get_the_date('Y-m-d', $product->get_id());

    // 获取当前日期。current_time() 获取WordPress配置的时区下的当前日期时间。
    $current_date_str = current_time('Y-m-d');

    // 创建 DateTime 对象
    $published = new DateTime($published_date_str);
    $today = new DateTime($current_date_str);

    // 计算两个日期之间的差值，返回 DateInterval 对象
    $interval = $published->diff($today);

    // 从 DateInterval 对象中提取年、月、日
    $years = $interval->y;
    $months = $interval->m;
    $days = $interval->d;

    // 格式化输出结果，并支持国际化
    $output = sprintf(
        // 使用占位符 %1$d, %2$d, %3$d 来表示数字，确保语言环境下的正确显示
        esc_html__('Product Launch Date: %1$d years, %2$d months and %3$d days', 'your-text-domain'),
        $years,
        $months,
        $days
    );

    // 将结果包装在一个div中，方便CSS样式控制
    echo '<div class="product-age-display">' . $output . '</div>';
}

集成到WooCommerce钩子

为了让上述功能在WooCommerce的不同页面生效，我们需要将其挂载到相应的动作钩子上。

1. 在单个产品页面显示： 使用 woocommerce_single_product_summary 钩子，它在产品摘要信息下方触发。

   add_action( 'woocommerce_single_product_summary', 'display_product_age_accurate', 25 );

   登录后复制

2. 在商品循环（如商店页面、分类归档页）显示： 使用 woocommerce_after_shop_loop_item 钩子，它在每个产品卡片下方触发。

   add_action( 'woocommerce_after_shop_loop_item', 'display_product_age_accurate', 20 );

   登录后复制

将上述所有代码片段（核心函数和两个 add_action 调用）放置在您主题的 functions.php 文件中，或者通过自定义插件实现。

芦笋演示

一键出成片的录屏演示软件，专为制作产品演示、教学课程和使用教程而设计。

34

查看详情

注意事项与最佳实践

• 文本域（Text Domain）：在 sprintf 函数中，我们使用了 esc_html__('...', 'your-text-domain')。请务必将 'your-text-domain' 替换为您主题或插件的实际文本域，以便于字符串的国际化和本地化。

• 日期格式：在创建 DateTime 对象时，建议使用 Y-m-d 或 Y-m-d H:i:s 等明确的日期时间格式，以避免不同环境下日期字符串解析可能出现的歧义。get_the_date() 和 current_time() 允许您指定输出格式。

• 时区处理：get_the_date() 和 current_time() 函数会自动考虑WordPress中配置的时区设置，因此通常情况下无需手动处理时区。DateTime 对象在没有指定时区的情况下，会使用PHP默认时区。在WordPress环境中，这通常与WP配置的时区保持一致。

• 自定义输出格式：您可以根据需要调整 sprintf 函数中的格式字符串，例如，如果某个部分（如年、月、日）为零，可以选择不显示它，或者使用单复数形式的单词。

  // 示例：更灵活的输出格式，处理单复数和零值
  $parts = [];
  if ($years > 0) {
      $parts[] = sprintf(_n('%d year', '%d years', $years, 'your-text-domain'), $years);
  }
  if ($months > 0) {
      $parts[] = sprintf(_n('%d month', '%d months', $months, 'your-text-domain'), $months);
  }
  if ($days > 0) {
      $parts[] = sprintf(_n('%d day', '%d days', $days, 'your-text-domain'), $days);
  }
  
  if (empty($parts)) {
      // 如果所有部分都为零（例如，产品发布不到一天）
      $output = esc_html__('Product Launch Date: Less than a day', 'your-text-domain');
  } else {
      // 使用逗号连接各个部分，并添加

  登录后复制

以上就是在WooCommerce中精确显示产品发布时长：避免闰年与月份差异问题的详细内容，更多请关注php中文网其它相关文章！