时区

编辑本页

警告:您正在浏览的文档欧宝官网下载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选项)。
此工作,包括代码示例,是根据创作共用BY-SA 3.0许可证。
ob娱乐下载Symfony 5.3支持通过JoliCode