萬盛學電腦網

您现在的位置: 萬盛學電腦網 >> 程式設計 >  >> 網路程式設計 >> PHP 程式設計

PHP 日曆類兩版本實作:解決 32 位元 2038 年問題(mktime vs DateTime)

32 位元系統上 mktime/strtotime 最大支援到 2038-01-19(Y2K38 問題)。本文提供兩版日曆類:版本一以 mktime 為主並偵測 32 位元環境自動修正年份範圍;版本二全面採用 DateTime 類別(PHP 5.2+),完全規避 2038 問題,支援任意年份。

版本一:mktime + 32 位元偵測修正

<?php
function myCalendar(int $year = 0, int $month = 0, string $timezone = 'Asia/Shanghai'): string
{
    date_default_timezone_set($timezone);
    $year  = abs($year);
    $month = abs($month);

    // 偵測 32 位元環境
    $is32 = (strtotime('2039-10-10') === false);
    if ($is32) {
        if ($year < 1970 || $year >= 2038) $year = (int)date('Y');
    } else {
        if ($year <= 0) $year = (int)date('Y');
    }
    if ($month <= 0 || $month > 12) $month = (int)date('m');

    // 上/下 年月計算
    $prevY = $year - 1;
    $prevM = $month - 1; if ($prevM <= 0) { $prevM = 12; $prevY--; }
    $nextY = $year + 1;
    $nextM = $month + 1; if ($nextM > 12) { $nextM = 1; $nextY++; }

    // 表頭 HTML
    $html = "<table width='500' border='1'>
        <tr align='center'>
            <td><a href='?y=$prevY'>上一年</a></td>
            <td><a href='?y=$prevY&m=$prevM'>上一月</a></td>
            <td><a href='?'>回到今天</a></td>
            <td><a href='?y=$nextY&m=$nextM'>下一月</a></td>
            <td><a href='?y=$nextY'>下一年</a></td>
        </tr>
        <tr align='center'><td colspan='5'>{$year}年{$month}月</td></tr>
        <tr><td colspan='5'><table width='100%' border='1'>
        <tr align='center'>
            <td style='background:#DAF0DD'>一</td>
            <td style='background:#DAF0DD'>二</td>
            <td style='background:#DAF0DD'>三</td>
            <td style='background:#DAF0DD'>四</td>
            <td style='background:#DAF0DD'>五</td>
            <td style='background:#F60;color:#fff;font-weight:bold'>六</td>
            <td style='background:#F60;color:#fff;font-weight:bold'>日</td>
        </tr>";

    // 當月天數
    $lastDay = (int)date('j', mktime(0, 0, 0, $nextM, 0, $year));
    $today   = date('Y-m-j');
    $day = 1;
    $line = '';

    while ($day <= $lastDay) {
        $cday = "$year-$month-$day";
        $week = (int)date('N', mktime(0, 0, 0, $month, $day, $year)); // 1=Mon .. 7=Sun

        if ($day === 1) {
            $line = "<tr align='center'>";
            $line .= str_repeat("<td> </td>", $week - 1);
        }

        $style = ($cday === $today) ? "style='color:red;'" : '';
        $line .= "<td $style>$day</td>";

        if ($week === 7) {
            $line .= "</tr>";
            $html .= $line;
            $line = "<tr align='center'>";
        }

        if ($day === $lastDay) {
            if ($week !== 7) {
                $line .= str_repeat("<td> </td>", 7 - $week);
            }
            $line .= "</tr>";
            $html .= $line;
            break;
        }
        $day++;
    }

    $html .= "</table></td></tr></table>";
    return $html;
}

版本二:DateTime 物件導向版(推薦生產環境)

<?php
function myCalendarDt(int $year = 0, int $month = 0, string $timezone = 'Asia/Shanghai'): string
{
    date_default_timezone_set($timezone);
    $now = new DateTime();

    $year  = $year > 0 ? $year : (int)$now->format('Y');
    $month = ($month > 0 && $month <= 12) ? $month : (int)$now->format('m');

    $firstDay = new DateTime("{$year}-{$month}-01");
    $lastDay  = (clone $firstDay)->modify('last day of this month');
    $totalDays = (int)$lastDay->format('j');
    $startWeek = (int)$firstDay->format('N'); // 1=Mon

    // 導航連結
    $prev = (clone $firstDay)->modify('-1 month');
    $next = (clone $firstDay)->modify('+1 month');

    $html = "<table width='500' border='1'>
        <tr align='center'>
            <td><a href='?y={$prev->format('Y')}'>上一年</a></td>
            <td><a href='?y={$prev->format('Y')}&m={$prev->format('m')}'>上一月</a></td>
            <td><a href='?'>回到今天</a></td>
            <td><a href='?y={$next->format('Y')}&m={$next->format('m')}'>下一月</a></td>
            <td><a href='?y={$next->format('Y')}'>下一年</a></td>
        </tr>
        <tr align='center'><td colspan='5'>{$year}年{$month}月</td></tr>
        <tr><td colspan='5'><table width='100%' border='1'>
        <tr align='center'>
            <td style='background:#DAF0DD'>一</td><td style='background:#DAF0DD'>二</td>
            <td style='background:#DAF0DD'>三</td><td style='background:#DAF0DD'>四</td>
            <td style='background:#DAF0DD'>五</td>
            <td style='background:#F60;color:#fff;font-weight:bold'>六</td>
            <td style='background:#F60;color:#fff;font-weight:bold'>日</td>
        </tr>";

    $day = 1;
    $line = "<tr align='center'>";
    $line .= str_repeat("<td> </td>", $startWeek - 1);

    while ($day <= $totalDays) {
        $cday = "$year-$month-$day";
        $style = ($cday === $now->format('Y-m-j')) ? "style='color:red;'" : '';
        $line .= "<td $style>$day</td>";

        if (($startWeek + $day - 1) % 7 === 0) { // 週日結束
            $line .= "</tr>";
            $html .= $line;
            if ($day < $totalDays) $line = "<tr align='center'>";
        }
        $day++;
    }

    // 填補最後一週
    $endWeek = (int)(clone $lastDay)->format('N');
    if ($endWeek !== 7) {
        $line .= str_repeat("<td> </td>", 7 - $endWeek);
    }
    $line .= "</tr>";
    $html .= $line . "</table></td></tr></table>";

    return $html;
}

兩版本比較

特性版本一版本二
核心 APImktime/dateDateTime
32 位元支援需偵測並限制年份原生支援任意年份
程式碼行數~90~85
可維護性程序式、較難擴充物件導向、易擴充(如加入農曆、節日)
效能略快(微乎其微)略慢(物件建立開銷)

現代專案建議

  • 直接使用 版本二,或引入成熟套件 jasny/php-calendar、boutique/php-calendar。
  • 前端渲染改用 FullCalendar、Vue Calendar 等 JS 庫,後端僅提供 JSON API。
  • 資料庫儲存日期一律用 DATE/DATETIME 型別,避免年份截斷。
copyright © 萬盛學電腦網 all rights reserved