萬盛學電腦網

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

PHP strtotime 與 mktime 處理零值日期陷阱:為什麼 00-00-00 會變成 1999-11-30

許多開發者發現 strtotime('00-00-00') 或 mktime(0,0,0,0,0,0) 回傳 1999-11-30,誤以為是 Bug。實際上這是 PHP 日期解析邏輯的合理結果,理解其運作原理即可避坑。

現象重現

<?php
echo date('Y-m-d', strtotime('00-00-00 00:00:00')); // 1999-11-30
echo "\n";
echo date('Y-m-d', mktime(0, 0, 0, 0, 0, 0));      // 1999-11-30 (Unix timestamp 943920000)

逐步推導過程

  1. 年份 00 → 2000:PHP 兩位數年份解析規則,00-69 對應 2000-2069,70-99 對應 1970-1999
  2. 月份 00 → 1999 年 12 月:月份 0 視為上一年的第 12 月(向前借位)
  3. 日期 00 → 1999 年 11 月 30 日:日期 0 視為上一個月的最後一天(11 月 30 日)
  4. 時間 00:00:00:當日零時
00-00-00 00:00:00
    │
    ▼ 年份 00 → 2000
2000-00-00 00:00:00
    │
    ▼ 月份 00 → 上一年 12 月
1999-12-00 00:00:00
    │
    ▼ 日期 00 → 上個月最後一天
1999-11-30 00:00:00

mktime 參數邏輯一致

// int mktime(時, 分, 秒, 月, 日, 年)
mktime(0, 0, 0, 0, 0, 0)
//      │  │  │  │  │  └─ 年 0 → 2000 → 1999 (月份 0 借位)
//      │  │  │  │  └──── 日 0 → 上月最後一天 (11/30)
//      │  │  │  └────── 月 0 → 上一年 12 月
//      │  │  └───────── 秒
//      │  └──────────── 分
//      └────────────── 時

實務避坑指南

1. 明確使用四位數年份

strtotime('2000-01-01')  // 正確
strtotime('00-01-01')    // 歧義,避免使用

2. 驗證輸入日期格式

function parseDateSafe(string $input): ?int {
    // 強制 Y-m-d 格式
    if (!preg_match('/^\d{4}-\d{2}-\d{2}$/', $input)) return null;
    $ts = strtotime($input);
    return ($ts !== false) ? $ts : null;
}

3. 使用 DateTime 物件(PHP 5.2+,推薦)

<?php
// DateTime 不會發生隱含借位,無效日期直接拋出例外
try {
    $dt = new DateTime('00-00-00'); // Exception: Failed to parse time string
} catch (Exception $e) {
    echo "無效日期: " . $e->getMessage();
}

// 正確用法
$dt = new DateTime('2000-01-01');
echo $dt->format('Y-m-d'); // 2000-01-01

// 從時間戳建立
$dt = new DateTime('@943920000'); // @ 表示 Unix timestamp
echo $dt->format('Y-m-d H:i:s'); // 1999-11-30 00:00:00

4. 資料庫零值日期處理

MySQL DATE/DATETIME 允許 0000-00-00(視 SQL_MODE),PHP 讀取後:

<?php
// PDO 預設將 0000-00-00 轉為 null(PHP 8.1+)
// 或回傳 '0000-00-00 00:00:00' 字串

$dateStr = '0000-00-00 00:00:00';
$ts = strtotime($dateStr); // false (PHP 7.0+) 或 -62169984000 (舊版)
$dt = DateTime::createFromFormat('Y-m-d H:i:s', $dateStr); // false

// 安全處理
function safeDbDate(string|null $dbDate): ?DateTime {
    if (empty($dbDate) || $dbDate === '0000-00-00 00:00:00') return null;
    return DateTime::createFromFormat('Y-m-d H:i:s', $dbDate);
}

總結

  • 非 Bug,是特性:PHP 日期解析允許月份/日期為 0 並進行借位運算
  • 永遠使用四位數年份:避免兩位數年份歧義
  • 優先用 DateTime 類別:嚴格模式、例外處理、時區支援、不可變 DateTimeImmutable
  • 資料庫零值日期:讀取後立即檢查並轉為 null,避免後續運算產生 1999-11-30
copyright © 萬盛學電腦網 all rights reserved