Class yii\validators\DateValidator

要被校验的值应该符合的时间日期格式。 它可以是一个 ICU manual 文档中描述的时间日期格式。

另外，这个属性可以是一个前缀为php: 的字符串，代表一个可以被PHP Datetime 类识别的时间日期格式。 更多支持的格式，请参考 http://php.net/manual/en/datetime.createfromformat.php

如果这个属性没有设置，默认值为 Yii::$app->formatter->dateFormat，更多详情，参考 yii\i18n\Formatter::$dateFormat。 自 2.0.8 起，默认值将由不同的格式化类所决定， 依赖 $type 的具体值：

• 如果是 TYPE_DATE, 默认值为 yii\i18n\Formatter::$dateFormat,
• 如果是 TYPE_DATETIME, 默认值为 yii\i18n\Formatter::$datetimeFormat,
• 如果是 TYPE_TIME, 默认为 yii\i18n\Formatter::$timeFormat.

以下是这个属性的示例值：

'MM/dd/yyyy' // date in ICU format
'php:m/d/Y' // the same date in PHP format
'MM/dd/yyyy HH:mm' // not only dates but also times can be validated

注意： 底层所使用的日期转换函数依赖具体的格式，如果你用 ICU 格式， 然后 PHP intl extension 扩展正确安装， 将使用 IntlDateFormatter 转换输入值。其他的情况，使用 PHP DateTime来转换。 IntlDateFormatter 的优势在于它可以转换国际化的世界格式，类似 12. Mai 2015 或者 12 мая 2014。 而 PHP 内置转换函数只能转换英语格式。PHP内置转换函数对输入更严格一些， 如果是格式 php:d.m.Y ，那么值 12.05.05将不会被PHP内置函数接受 ,但是 IntlDateFormatter 却可以以格式 dd.MM.yyyy 接受这个值。 如果你需要使用 IntlDateFormatter 你可以通过指定 minimum date 来避免这个问题。

本地化时间日期转化的 locale ID 这个只有在 PHP intl extension 安装的情况下才生效。 如果未设置，将使用 formatter， 参见 yii\i18n\Formatter::$locale

时间日期的上限，默认为 null ，代表无上限。 这个可以是一个 unix 时间戳，也可以是一个代表日期时间格式的字符串值。 如果这个属性是字符串， 将使用 $format 来格式化它。

参见 $tooBig 当日期太大时，参考 tooBig 自定义错误消息。.

用户友好的最大值，用于展示在错误消息中。 如果这个属性是 null， 将会使用未转换的 $max。

时间日期的下限，默认是 null，代表无下限。 这个可以是一个 unix 时间戳，也可以是一个代表日期时间格式的字符串值。 如果这个属性是字符串， 将使用 $format 来格式化它。

参见 $tooSmall 当日期太小时，参考 tooSmall 自定义错误消息。.

用户友好的最小值，用于展示在错误消息中。 如果这个属性是 null， 将会使用未转换的 $min。

转化日期和时间值的时区。 这个可以是任意可以传递给函数 date_default_timezone_set() 调用的参数值。 例如： UTC, Europe/Berlin 或者 America/Chicago。 可用的时区值参考 php manual。 如果这个属性没有设置，将使用 yii\base\Application::$timeZone。

用于接受转换结果的属性名称。 当这个属性不为空，且校验成功的情况下， 指定的属性将会被赋值为转换结果。

这个可以同时为被校验的属性名。 在这种情况下，原始值在成功校验后，会被重写为时间戳值。

注意，当使用这个属性时，输入值将会被转换为一个 unix 时间戳， 默认是 UTC 时区，所以会有一个 input time zone 到 UTC 的时区转换。 当定义了 $timestampAttributeFormat ， 你可以通过设置 $timestampAttributeTimeZone 为其他不同于 'UTC' 的值来控制这个转换。

参见：

• $timestampAttributeFormat
• $timestampAttributeTimeZone

填充 $timestampAttribute 的格式。 这个格式可以同 $format 一样。

如果未设置，$timestampAttribute 将会接受一个 UNIX 时间戳。 如果 $timestampAttribute 未设置，这个属性将会被忽略。

参见：

• $format
• $timestampAttribute

当填充 $timestampAttribute 属性时，使用的时区，默认为 UTC。

这个可以是任意可以传递给函数 date_default_timezone_set() 调用的参数值。 例如： UTC, Europe/Berlin 或者 America/Chicago。 可用的时区值参考 php manual。

如果属性 $timestampAttributeFormat 未设置，这个属性也会被忽略。

参见 $timestampAttributeFormat.

用户自定义错误消息当值大于 $max.

用户自定义错误消息当值小于 $min.

校验器的类型，意味着被校验的是一个日期，时间戳，或者时间日期值。 这个属性影响着 $format 的默认值， 当 $format 是 short, medium, long, 或者 full 之一的intl短格式时，它会设置校验器的正确行为。

这个属性只有扩展 PHP intl extension 安装时才生效。

这个属性可以设置为如下值：

• TYPE_DATE - （默认）只接受日期值，这意味着不包括时间部分的日期值才有效。
• TYPE_DATETIME - 接受时间日期值，即同时包含时间部分和日期部分。
• TYPE_TIME - 接受时间戳值，即不包含日期信息。