PHP中计算两个八位日期字符串之间天数差的教程

<?php

/**
 * 计算两个YYYYMMDD格式日期字符串之间的天数差
 *
 * @param string $dateStr1 第一个日期字符串，格式为YYYYMMDD (例如: '20211024')
 * @param string $dateStr2 第二个日期字符串，格式为YYYYMMDD (例如: '20211014')
 * @return string 返回天数差的字符串，包含正负号 (例如: '+10 days' 或 '-10 days')
 * @throws Exception 如果日期字符串格式无效
 */
function calculateDaysBetweenDates(string $dateStr1, string $dateStr2): string
{
    try {
        // 1. 将YYYYMMDD格式的字符串转换为DateTime对象
        // DateTime构造函数能够识别这种无分隔符的日期格式
        $dateTime1 = new DateTime($dateStr1);
        $dateTime2 = new DateTime($dateStr2);

        // 2. 使用diff()方法计算两个DateTime对象之间的时间间隔
        // diff()方法返回一个DateInterval对象
        $interval = $dateTime1->diff($dateTime2);

        // 3. 格式化DateInterval对象以获取天数差
        // %R: 表示正负号，如果差值为负，则为'-'，否则为'+'
        // %a: 表示总天数（绝对值），不考虑月份和年份的边界，直接计算总天数
        return $interval->format('%R%a days');

    } catch (Exception $e) {
        // 捕获DateTime构造函数可能抛出的异常，例如日期格式不正确
        return "日期处理错误: " . $e->getMessage();
    }
}

// 示例用法：
$dateStringA = '20211024';
$dateStringB = '20211014'; // 10天前

echo "日期 {$dateStringA} 和 {$dateStringB} 之间的天数差为: ";
echo calculateDaysBetweenDates($dateStringA, $dateStringB); // 输出: +10 days
echo "\n";

$dateStringC = '20211014';
$dateStringD = '20211024'; // 10天后

echo "日期 {$dateStringC} 和 {$dateStringD} 之间的天数差为: ";
echo calculateDaysBetweenDates($dateStringC, $dateStringD); // 输出: -10 days
echo "\n";

$dateStringE = '20220101';
$dateStringF = '20211231'; // 跨年

echo "日期 {$dateStringE} 和 {$dateStringF} 之间的天数差为: ";
echo calculateDaysBetweenDates($dateStringE, $dateStringF); // 输出: +1 days
echo "\n";

// 错误示例：无效日期格式
$invalidDate = '20219999';
$validDate = '20210101';

echo "日期 {$invalidDate} 和 {$validDate} 之间的天数差为: ";
echo calculateDaysBetweenDates($invalidDate, $validDate); // 输出: 日期处理错误: DateTime::__construct(): Failed to parse time string (20219999) at position 4 (9)
echo "\n";

?>

日期 20211024 和 20211014 之间的天数差为: +10 days
日期 20211014 和 20211024 之间的天数差为: -10 days
日期 20220101 和 20211231 之间的天数差为: +1 days
日期 20219999 和 20210101 之间的天数差为: 日期处理错误: DateTime::__construct(): Failed to parse time string (20219999) at position 4 (9)