时区

编辑该页面

警告:你浏览的文档欧宝官网下载appob娱乐下载Symfony 5.2,不再维护。

这个页面的更新版本Symfob娱乐下载ony 6.2(当前的稳定版本)。

时区

验证一个值是一个有效的时区标识符(如。欧洲/巴黎)。

基本用法

假设您有一个UserSettings类,时区字段是一个字符串包含的任何PHP时区标识符(如。美国/ New_York):

  • 注释
  • 属性
  • YAML
  • XML
  • PHP
1 2 3 4 5 6 7 8 9 10 11 12
/ / src /实体/ UserSettings.php名称空间应用程序\实体;使用ob娱乐下载\组件\验证器\约束作为断言;UserSettings{/ * * *@Assert\时区* /受保护的美元时区;}

请注意

与大多数其他的约束,和空字符串被认为是有效值。这是为了让他们可选值。如果该值是强制性的,一个常见的解决方案是将这个约束NotBlank

选项

countryCode

类型:字符串默认的:

如果选项设置为\ DateTimeZone时区::PER_COUNTRY这个选项限制有效的时区标识符,那些属于特定国家。

这个选项的值必须是有效的ISO 3166 - 1α2国家代码(如。CN中国)。

类型:数组|字符串

它定义了这个约束属于验证组或组。阅读更多关于验证组

intlCompatible

类型:布尔默认的:

这个约束考虑有效的PHP时区标识符ICU时区Symfony的提供的ob娱乐下载Intl组件

然而,提供的时区Intl组件可以从PHP提供的时区不同Intl扩展(因为他们使用不同的ICU版本)。如果将此选项设置真正的,这个约束只考虑有效的值与PHP兼容\ IntlTimeZone: createTimeZone ()方法。

消息

类型:字符串默认的:这个值不是一个有效的时区。

显示此消息如果底层数据不是有效的时区标识符。

在这个信息:您可以使用以下参数

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

5.2

{{标签}}参数是在Symfony 5.2中引入的。ob娱乐下载

有效载荷

类型:混合默认的:

这个选项可以用来连接任意特定领域的数据约束。配置的有效载荷不使用验证器组件,但是它的处理是完全取决于你。

例如,您可能想要使用几个错误级别以不同的方式来呈现没有约束,在前端取决于错误的严重性。

类型:字符串默认的:\ DateTimeZone时区::

这个选项设置为下列常数限制有效的时区标识符的那些属于地理区:

  • :\ DateTimeZone时区:非洲
  • 美国\ DateTimeZone时区::
  • \ DateTimeZone时区::南极洲
  • \ DateTimeZone时区::北极
  • 亚洲\ DateTimeZone时区::
  • \ DateTimeZone时区::大西洋
  • \ DateTimeZone时区:澳大利亚
  • 欧洲\ DateTimeZone时区::
  • \ DateTimeZone时区::印度
  • \ DateTimeZone时区::太平洋

此外,还有一些特殊的区域值:

  • \ DateTimeZone时区::接受任何时区不包括弃用时区;
  • \ DateTimeZone时区::ALL_WITH_BC接受任何时区包括弃用时区;
  • \ DateTimeZone时区::PER_COUNTRY限制有效的时区到某一个国家(这是定义使用countryCode选项)。
这项工作,包括代码示例,许可下Creative Commons冲锋队3.0许可证。