checkdate

(PHP 4, PHP 5, PHP 7, PHP 8)

checkdate验证一个格里高里日期

说明

checkdate ( int $month , int $day , int $year ) : bool

检查由参数构成的日期的合法性。如果每个参数都正确定义了则会被认为是有效的。

参数

month

month 的值是从 1 到 12。

day

Day 的值在给定的 month 所应该具有的天数范围之内,闰年已经考虑进去了。

year

year 的值是从 1 到 32767。

返回值

如果给出的日期有效则返回 true,否则返回 false

范例

Example #1 checkdate() 例子

<?php
var_dump
(checkdate(12312000));
var_dump(checkdate(2292001));
?>

以上例程会输出:

bool(true)
bool(false)

参见

  • mktime() - 取得一个日期的 Unix 时间戳
  • strtotime() - 将任何字符串的日期时间描述解析为 Unix 时间戳

User Contributed Notes

hugo dot REMOVE dot voerman at priva dot NOTNEEDED dot com 05-Oct-2021 02:03
I use a slight variation of the validateDate() above, to also allow validating dates like: '2021-10-05T13:55:01Z' with DateTime::ATOM like:

<?php
function validateDate($date, $format = 'Y-m-d H:i:s')
{
   
// replace a 'Z' at the end by '+00:00'
   
$date = preg_replace('/(.*)Z$/', '${1}+00:00', $date);

   
$d = DateTime::createFromFormat($format, $date);
    return
$d && $d->format($format) == $date;
}
?>

This means a call like:
<?php
var_dump
(validateDate('2021-10-05T13:55:01Z', DateTime::ATOM));
?>
will output true

I use this in a filter_input wrapper like:

<?php
function fi_validateDate($format)
{
    return function(
$value = null) use ($format) {
        return
validateDate($value, $format) ? $value : null;
    };
}
?>

so I can do stuff like:

<?php
$dateFrom
= filter_input(INPUT_GET, 'dateFrom', FILTER_CALLBACK, ['options' => fi_validateDate(DateTime::ATOM)]);
?>
Anonymous 15-Feb-2021 06:10
based on :
https://www.php.net/manual/es/function.checkdate.php#113205

there is a HOF php8 refactor

        $isValidFormatDateHOF = fn (string $format) =>  static fn (string $date) => ($dateTimeInmutable = \DateTimeImmutable::createFromFormat( $format, $date)) && $dateTimeInmutable->format( $format) === $date;

$isAtom = $isvalidFormatDateHOF(DateTimeInterface::ATOM)

$isAtom('2020-02-02')  //false
$isAtom('2021-02-15T19:17:01+00:00') //true
MarkAgius at markagius dot co dot uk 08-Mar-2020 02:25
Note:
checkdate() will return true and not false with the non existing dates 3/09/1752 to 13/09/1752
glavic at gmail dot com 12-Sep-2013 12:46
With DateTime you can make the shortest date&time validator for all formats.

<?php

function validateDate($date, $format = 'Y-m-d H:i:s')
{
   
$d = DateTime::createFromFormat($format, $date);
    return
$d && $d->format($format) == $date;
}

var_dump(validateDate('2012-02-28 12:12:12')); # true
var_dump(validateDate('2012-02-30 12:12:12')); # false
var_dump(validateDate('2012-02-28', 'Y-m-d')); # true
var_dump(validateDate('28/02/2012', 'd/m/Y')); # true
var_dump(validateDate('30/02/2012', 'd/m/Y')); # false
var_dump(validateDate('14:50', 'H:i')); # true
var_dump(validateDate('14:77', 'H:i')); # false
var_dump(validateDate(14, 'H')); # true
var_dump(validateDate('14', 'H')); # true

var_dump(validateDate('2012-02-28T12:12:12+02:00', 'Y-m-d\TH:i:sP')); # true
# or
var_dump(validateDate('2012-02-28T12:12:12+02:00', DateTime::ATOM)); # true

var_dump(validateDate('Tue, 28 Feb 2012 12:12:12 +0200', 'D, d M Y H:i:s O')); # true
# or
var_dump(validateDate('Tue, 28 Feb 2012 12:12:12 +0200', DateTime::RSS)); # true
var_dump(validateDate('Tue, 27 Feb 2012 12:12:12 +0200', DateTime::RSS)); # false
# ...
PHP8中文手册 站长在线 整理 版权归PHP文档组所有