跳到内容

DateTime

编辑此页

验证值是否为有效的“datetime”,即遵循特定格式的字符串(或可以转换为字符串的对象)。

应用于 属性或方法
DateTime
验证器 DateTimeValidator

基本用法

1
2
3
4
5
6
7
8
9
10
11
12
13
// src/Entity/Author.php
namespace App\Entity;

use Symfony\Component\Validator\Constraints as Assert;

class Author
{
    /**
     * @var string A "Y-m-d H:i:s" formatted value
     */
    #[Assert\DateTime]
    protected string $createdAt;
}

注意

与其他大多数约束一样,null 和空字符串被认为是有效值。 这是为了允许它们成为可选值。 如果该值是强制性的,一个常见的解决方案是将此约束与 NotBlank 结合使用。

选项

format

type: string default: Y-m-d H:i:s

此选项允许你验证自定义日期格式。 有关格式化选项,请参阅 DateTime::createFromFormat()

groups

type: array | string default: null

它定义此约束的验证组。 阅读更多关于 验证组 的信息。

message

type: string default: This value is not a valid datetime.

如果底层数据不是有效的 datetime,则显示此消息。

你可以在此消息中使用以下参数

参数 描述
{{ value }} 当前(无效)值
{{ label }} 对应的表单字段标签

payload

type: mixed default: null

此选项可用于将任意特定于域的数据附加到约束。 配置的 payload 不会被 Validator 组件使用,但其处理完全取决于你。

例如,你可能想要使用 多个错误级别,以便根据错误严重程度在前端以不同方式呈现失败的约束。

这项工作,包括代码示例,根据 Creative Commons BY-SA 3.0 许可获得许可。
目录
    版本