日期時間格式驗證是表單處理、API 參數校驗的高頻需求。本文分析正則表達式局限性,推薦結合 DateTime 類與 strtotime() 的現代最佳實踐。
<?php
$dateTime = '2024-01-15 14:30:45';
// 僅匹配格式,不驗證邏輯合法性(如 2024-02-30 會通過)
if (preg_match('/^\d{4}-\d{2}-\d{2} \d{2}:\d{2}:\d{2}$/', $dateTime)) {
echo "格式匹配";
}
// 缺陷:2024-13-45 99:99:99 也會通過
?>
<?php
// 這類正則極其複雜、難讀、易錯、性能差
$regex = '/^
(?:
(?P\d{4})-(?P0[1-9]|1[0-2])-(?P0[1-9]|[12]\d|3[01])
)
\s+
(?:
(?P[01]\d|2[0-3]):(?P[0-5]\d):(?P[0-5]\d)
)
$/x';
// 即使匹配成功,仍無法驗證:2月30日、閏年2月29日等邏輯
// 結論:不要用正則驗證日期邏輯合法性
?>
<?php
function validateDateTime(string $dateTime, string $format = 'Y-m-d H:i:s'): bool {
$dt = DateTime::createFromFormat($format, $dateTime);
// 關鍵:檢查解析錯誤 且 格式化後與原輸入一致(防止溢出自動修正)
$errors = DateTime::getLastErrors();
return $dt !== false && $errors['warning_count'] === 0 && $errors['error_count'] === 0
&& $dt->format($format) === $dateTime;
}
// 測試
var_dump(validateDateTime('2024-01-15 14:30:45')); // true
var_dump(validateDateTime('2024-02-30 14:30:45')); // false(2月無30日)
var_dump(validateDateTime('2024-13-01 14:30:45')); // false(無13月)
var_dump(validateDateTime('2024-01-15 25:30:45')); // false(無25時)
var_dump(validateDateTime('2024-01-15 14:60:45')); // false(無60分)
var_dump(validateDateTime('2024-01-15')); // false(格式不匹配)
// 支持多種格式
function validateFlexible(string $input): ?DateTime {
$formats = [
'Y-m-d H:i:s',
'Y-m-d',
'Y/m/d H:i:s',
'Y/m/d',
'd.m.Y H:i:s',
'd.m.Y',
];
foreach ($formats as $format) {
$dt = DateTime::createFromFormat($format, $input);
$errors = DateTime::getLastErrors();
if ($dt !== false && $errors['warning_count'] === 0 && $errors['error_count'] === 0
&& $dt->format($format) === $input) {
return $dt;
}
}
return null;
}
?>
format() === 原輸入?<?php
// PHP DateTime 會自動修正溢出值
$dt = DateTime::createFromFormat('Y-m-d', '2024-02-30');
echo $dt->format('Y-m-d'); // 2024-03-01 (自動進位到3月1日)
// 所以必須對比原輸入
$input = '2024-02-30';
$dt = DateTime::createFromFormat('Y-m-d', $input);
$isValid = $dt && $dt->format('Y-m-d') === $input; // false
?>
<?php
function validateWithStrtotime(string $dateTime): bool {
$timestamp = strtotime($dateTime);
if ($timestamp === false) return false;
// 驗證往返一致性
$back = date('Y-m-d H:i:s', $timestamp);
// 注意:strtotime 支持多種格式,往返格式可能不同
// 建議指定預期格式對比
return $back === $dateTime; // 嚴格模式需格式完全一致
}
// 測試
var_dump(validateWithStrtotime('2024-01-15 14:30:45')); // true
var_dump(validateWithStrtotime('2024-02-30 14:30:45')); // false(返回 false)
var_dump(validateWithStrtotime('next Monday')); // true 但格式不一致
?>
'next Monday'、'+1 day' 會返回有效時間戳'2024/1/5'、'Jan 15 2024' 都能解析'24-01-15' 可能解析為 1924 或 2024date_default_timezone_set() 影響<?php
// 專門驗證格里曆日期合法性
var_dump(checkdate(2, 29, 2024)); // true(閏年)
var_dump(checkdate(2, 29, 2023)); // false(平年)
var_dump(checkdate(13, 1, 2024)); // false
var_dump(checkdate(1, 32, 2024)); // false
// 組合使用:分離日期時間驗證
function validateDateTimeSplit(string $dateTime): bool {
if (!preg_match('/^(\d{4})-(\d{2})-(\d{2}) (\d{2}):(\d{2}):(\d{2})$/', $dateTime, $m)) {
return false;
}
// $m[1]=year, [2]=month, [3]=day, [4]=hour, [5]=min, [6]=sec
return checkdate((int)$m[2], (int)$m[3], (int)$m[1])
&& $m[4] < 24 && $m[5] < 60 && $m[6] < 60;
}
?>
<?php
declare(strict_types=1);
class DateTimeValidator {
private array $formats;
public function __construct(array $formats = null) {
$this->formats = $formats ?? [
'Y-m-d H:i:s',
'Y-m-d',
'Y/m/d H:i:s',
'Y/m/d',
'd.m.Y H:i:s',
'd.m.Y',
'Y-m-d\TH:i:s', // ISO 8601
'Y-m-d\TH:i:sP', // ISO 8601 帶時區
];
}
public function validate(string $input): bool {
return $this->parse($input) !== null;
}
public function parse(string $input): ?DateTime {
foreach ($this->formats as $format) {
$dt = DateTime::createFromFormat($format, $input);
$errors = DateTime::getLastErrors();
if ($dt !== false
&& $errors['warning_count'] === 0
&& $errors['error_count'] === 0
&& $dt->format($format) === $input) {
return $dt;
}
}
return null;
}
public function parseOrFail(string $input): DateTime {
$dt = $this->parse($input);
if (!$dt) {
throw new \InvalidArgumentException("無效的日期時間格式:$input");
}
return $dt;
}
// 範圍驗證
public function validateRange(string $input, ?DateTime $min = null, ?DateTime $max = null): bool {
$dt = $this->parse($input);
if (!$dt) return false;
if ($min && $dt < $min) return false;
if ($max && $dt > $max) return false;
return true;
}
}
// 使用
$validator = new DateTimeValidator();
if ($validator->validate($_POST['birthday'] ?? '')) {
$dt = $validator->parse($_POST['birthday']);
// 業務邏輯...
}
?>
<?php
// Laravel Validation
$request->validate([
'birthday' => 'required|date_format:Y-m-d',
'appointment' => 'required|date_format:Y-m-d H:i:s|after:today',
'start_date' => 'required|date|before_or_equal:end_date',
]);
// ThinkPHP Validate
class UserValidate extends Validate {
protected $rule = [
'birthday' => 'require|dateFormat:Y-m-d',
'appointment' => 'require|dateFormat:Y-m-d H:i:s|after:time',
];
}
// 自定義驗證規則(Laravel)
Validator::extend('valid_datetime', function ($attribute, $value, $parameters, $validator) {
$dt = DateTime::createFromFormat($parameters[0] ?? 'Y-m-d H:i:s', $value);
$errors = DateTime::getLastErrors();
return $dt !== false
&& $errors['warning_count'] === 0
&& $errors['error_count'] === 0
&& $dt->format($parameters[0] ?? 'Y-m-d H:i:s') === $value;
});
?>
| 場景 | 推薦方案 | 理由 |
|---|---|---|
| API 參數嚴格驗證 | DateTime::createFromFormat() + 格式對比 | 精確、安全、可擴展多格式 |
| 用戶生日/日期選擇器 | checkdate() + 簡單正則 | 輕量、專門解決日期邏輯 |
| 解析用戶自由輸入 | strtotime() + 範圍限制 | 兼容性好,但需嚴格限制輸出格式 |
| 高性能批量驗證 | 預編譯正則 + checkdate() | 避免對象創建開銷 |
| 框架表單驗證 | 內置 date_format 規則 | 統一錯誤處理、本地化 |