驗證用戶輸入的日期是否合法(如 2023-02-29 不存在、月份 13 不存在)是表單處理的基礎需求。PHP 提供內建 checkdate()、正則匹配、DateTime 物件解析三種方案,各有適用場景。本文系統對比並給出最佳實踐。
<?php
// bool checkdate(int $month, int $day, int $year)
// 參數順序:月、日、年(注意順序!)
var_dump(checkdate(12, 31, 2000)); // true
var_dump(checkdate(2, 29, 2003)); // false(2003 非閏年)
var_dump(checkdate(2, 29, 2004)); // true(2004 閏年)
var_dump(checkdate(13, 1, 2024)); // false(月份無效)
var_dump(checkdate(0, 1, 2024)); // false(月份無效)
?>
優點:原生函數、自動處理閏年/每月天數、無需正則、效能高。
缺點:需先將字串解析為年/月/日整數、不支援時間部分驗證。
<?php
// 僅驗證格式 YYYY-MM-DD,不驗證日期合法性(如 2023-02-30 會通過)
function isDateFormat(string $str): bool {
return (bool)preg_match('/^\d{4}-\d{2}-\d{2}$/', $str);
}
// 驗證日期時間格式 YYYY-MM-DD HH:MM:SS
function isDateTimeFormat(string $str): bool {
return (bool)preg_match('/^\d{4}-\d{2}-\d{2} \d{2}:\d{2}:\d{2}$/', $str);
}
// 帶範圍約束的正則(粗略)
function isDateRangeFormat(string $str): bool {
// 月份 01-12,日期 01-31(不精確檢查每月天數)
return (bool)preg_match('/^\d{4}-(0[1-9]|1[0-2])-(0[1-9]|[12]\d|3[01])$/', $str);
}
?>
適用場景:前端提交前預檢、API 參數格式校驗、日誌解析預過濾。
<?php
function validateDateTime(string $datetime, string $format = 'Y-m-d H:i:s'): bool {
$dt = DateTime::createFromFormat($format, $datetime);
// 必須檢查:無錯誤、且格式化後與原字串完全一致(防止溢出自動修正)
return $dt !== false && $dt->format($format) === $datetime;
}
// 使用範例
var_dump(validateDateTime('2024-02-29 12:00:00')); // true(閏年)
var_dump(validateDateTime('2023-02-29 12:00:00')); // false
var_dump(validateDateTime('2024-13-01 12:00:00')); // false
var_dump(validateDateTime('2024-02-29 25:00:00')); // false(時段錯誤)
var_dump(validateDateTime('2024-02-29 12:60:00')); // false
// 僅驗證日期
function validateDate(string $date): bool {
return validateDateTime($date . ' 00:00:00', 'Y-m-d H:i:s');
}
?>
關鍵技巧:$dt->format($format) === $datetime 確保「嚴格模式」,防止 DateTime 自動修正無效日期(如 2023-02-29 → 2023-03-01)。
<?php
class DateValidator {
/** 驗證日期字串(支援多種常見格式) */
public static function validate(string $input, ?string &$normalized = null): bool {
$formats = [
'Y-m-d', // 2024-01-15
'Y/m/d', // 2024/01/15
'Y.m.d', // 2024.01.15
'Y年m月d日', // 2024年01月15日
'Y-m-d H:i:s', // 2024-01-15 14:30:00
'Y/m/d H:i:s',
'Y-m-d\TH:i:s', // ISO 8601 無時區
'Y-m-d\TH:i:sP', // ISO 8601 帶時區
];
foreach ($formats as $fmt) {
$dt = DateTime::createFromFormat($fmt, $input);
if ($dt !== false && $dt->format($fmt) === $input) {
$normalized = $dt->format('Y-m-d H:i:s'); // 統一輸出格式
return true;
}
}
return false;
}
/** 快速驗證:僅 Y-m-d 格式 */
public static function validateDate(string $date): bool {
$parts = explode('-', $date);
if (count($parts) !== 3) return false;
return checkdate((int)$parts[1], (int)$parts[2], (int)$parts[0]);
}
/** 獲取日期錯誤詳情(用於用戶提示) */
public static function getError(string $input): string {
if (!preg_match('/^\d{4}[-\/.]\d{2}[-\/.]\d{2}/', $input)) {
return '格式錯誤,請使用 YYYY-MM-DD';
}
$parts = explode('-', str_replace(['/','.'], '-', $input));
$y = (int)$parts[0]; $m = (int)$parts[1]; $d = (int)$parts[2];
if ($m < 1 || $m > 12) return '月份必須在 1-12 之間';
if ($d < 1 || $d > 31) return '日期必須在 1-31 之間';
if (!checkdate($m, $d, $y)) return "{$y}年{$m}月沒有{$d}日(閏年規則)";
return '';
}
}
// 使用
$input = '2024-02-29';
if (DateValidator::validate($input, $norm)) {
echo "合法,標準化: $norm";
} else {
echo "錯誤: " . DateValidator::getError($input);
}
?>
<?php
function validateBirthdate(string $birthdate, int $minAge = 18): bool {
if (!DateValidator::validateDate($birthdate)) return false;
$birth = new DateTime($birthdate);
$now = new DateTime();
$age = $now->diff($birth)->y;
return $age >= $minAge;
}
?>
<?php
function validateDateRange(string $start, string $end): bool {
if (!DateValidator::validate($start, $s) || !DateValidator::validate($end, $e)) return false;
return $s <= $e;
}
?>
<?php
function validateFutureDate(string $date): bool {
if (!DateValidator::validateDate($date)) return false;
return new DateTime($date) > new DateTime('today');
}
function validatePastDate(string $date): bool {
if (!DateValidator::validateDate($date)) return false;
return new DateTime($date) < new DateTime('today');
}
?>
checkdate() | 高(日曆級) | 極快 | 已解析年/月/日整數、僅需日期合法性 |
| 正則格式檢查 | 低(僅格式) | 快 | 前端預檢、API 格式校驗、大批量預過濾 |
| DateTime::createFromFormat | 最高(含時間、時區、嚴格模式) | 中等 | 表單提交最終驗證、多格式支援、需標準化輸出 |
type="date" + JS 正則 → 後端 DateTime 嚴格驗證 + checkdate 快速路徑Y-m-d 或 Y-m-d H:i:s 存入資料庫strtotime('2023-02-30') 返回 3 月 2 日的時間戳,極不安全PHP 日期驗證的「黃金組合」是:DateTime::createFromFormat 嚴格模式(格式化後比對原串)作為核心,checkdate() 作為純日期快速路徑,正則作為格式預檢。封裝為 DateValidator 工具類,統一項目日期處理標準,消除「2023-02-30 入庫」等低級 Bug。