跳到內容

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 結合使用。

選項

格式

類型string 預設值Y-m-d H:i:s

此選項可讓您驗證自訂日期格式。請參閱 DateTime::createFromFormat() 以取得格式化選項。

群組

類型array | string 預設值null

它定義此約束條件的驗證群組或群組。請參閱驗證群組以瞭解更多資訊。

訊息

類型string 預設值This value is not a valid datetime.

如果基礎資料不是有效的 datetime,則會顯示此訊息。

您可以在此訊息中使用以下參數

參數 描述
{{ value }} 目前(無效)值
{{ label }} 對應的表單欄位標籤

酬載

類型mixed 預設值null

此選項可用於將任意特定領域的資料附加到約束條件。Validator 元件不會使用已設定的酬載,但其處理完全由您決定。

例如,您可能會想要使用多個錯誤層級,以便根據錯誤的嚴重性,以前端不同的方式呈現失敗的約束條件。

本作品,包括程式碼範例,均根據 Creative Commons BY-SA 3.0 授權條款授權。
目錄
    版本