WooCommerce 产品上线时长精准计算教程

<?php
/**
 * 在 WooCommerce 中显示产品上线时长（年、月、日）
 * 使用 PHP DateTime 和 DateInterval 确保精确计算
 */

/**
 * 获取并格式化产品的上线时长
 *
 * @param WC_Product $product WooCommerce 产品对象
 * @return string 格式化后的上线时长字符串
 */
function get_product_published_time_accurate( $product ) {
    // 获取产品的创建日期。WC_Product::get_date_created() 返回一个 WC_DateTime 对象，
    // WC_DateTime 继承自 PHP 的 DateTime，可以直接使用其方法。
    $creation_date_wc = $product->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 '<div class="product-published-time">' . __( 'Product Live For: Less than a day', 'your-text-domain' ) . '</div>';
    }

    // 格式化输出字符串，例如 "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(
        '<div class="product-published-time">%s %s</div>',
        __( '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 );
}