时区
编辑本页警告:您正在浏览的文档欧宝官网下载appob娱乐下载Symfony 5.3,现已不再维护。
读本页的更新版本用于Syob娱乐下载mfony 6.2(当前稳定版本)。
时区
验证一个值是否为有效的时区标识符(例如。欧洲/巴黎
).
适用于 | 属性或方法 |
类 | 时区 |
验证器 | TimezoneValidator |
基本用法
假设你有一个UserSettings
类,使用时区
字段的字符串,该字符串包含PHP时区标识符(如。美国/ New_York
):
- 注释
- 属性
- YAML
- XML
- PHP
12 3 4 5 6 7 8 9 10 11 12
/ / src /实体/ UserSettings.php名称空间应用程序\实体;使用ob娱乐下载\组件\验证器\约束作为断言;类UserSettings{/ * * *@Assert\时区* /受保护的$时区;}
请注意
与大多数其他约束条件一样,零
空字符串被认为是有效值。这是为了允许它们是可选值。如果该值是强制的,常见的解决方案是将此约束与NotBlank.
选项
countryCode
类型:字符串
默认的:零
如果区
选项设置为\ DateTimeZone时区::PER_COUNTRY
,此选项将有效的时区标识符限制为属于给定国家的时区标识符。
此选项的值必须是有效的ISO 3166-1 alpha-2国家代码(例如:CN
中国)。
intlCompatible
类型:布尔
默认的:假
这个约束认为是有效的PHP时区标识符和ICU时区由Symfony's提供ob娱乐下载Intl组件
但是,Intl组件提供的时区可能与PHP的Intl扩展提供的时区不同(因为它们使用不同的ICU版本)。如果此选项设置为真正的
,此约束只考虑与PHP兼容的值有效\ IntlTimeZone: createTimeZone ()
方法。
消息
类型:字符串
默认的:此值不是有效的时区。
如果底层数据不是有效的时区标识符,则显示此消息。
您可以在此消息中使用以下参数:
参数 | 描述 |
---|---|
{{value}} |
当前(无效)值 |
{{label}} |
对应的表单字段标签 |
5.2
的{{label}}
参数在Symfony 5.2中引入。ob娱乐下载
有效载荷
类型:混合
默认的:零
此选项可用于将任意特定于领域的数据附加到约束。已配置的有效负载不由Validator组件使用,但其处理完全取决于您。
例如,您可能想使用若干错误级别根据错误的严重程度,在前端以不同的方式呈现失败的约束。
区
类型:字符串
默认的:\ DateTimeZone时区::
将此选项设置为以下任何常量,以将有效的时区标识符限制为属于该地理区域的标识符:
: \ DateTimeZone时区:非洲
美国\ DateTimeZone时区::
\ DateTimeZone时区::南极洲
\ DateTimeZone时区::北极
亚洲\ DateTimeZone时区::
\ DateTimeZone时区::大西洋
\ DateTimeZone时区:澳大利亚
欧洲\ DateTimeZone时区::
\ DateTimeZone时区::印度
\ DateTimeZone时区::太平洋
此外,还有一些特殊的区域值:
\ DateTimeZone时区::
接受任何时区,不包括已弃用的时区;\ DateTimeZone时区::ALL_WITH_BC
接受任何时区,包括已弃用的时区;\ DateTimeZone时区::PER_COUNTRY
将有效时区限制为某个国家(使用countryCode
选项)。