BirthdayType领域

编辑本页

警告:您正在浏览的文档欧宝官网下载appob娱乐下载Symfony 3.3,现已不再维护。

本页的更新版本用于Syob娱乐下载mfony 6.2(当前稳定版本)。

BirthdayType领域

一个DateType专门处理出生日期数据的字段。

可以呈现为单个文本框、三个文本框(月、日和年)或三个选择框。

该类型本质上与DateType类型,但是使用更合适的默认值选择。的期权默认为120年前到当年。

基础数据类型 可以DateTime字符串时间戳,或数组(见输入选项
呈现为 可以是三个选择框或1个或3个文本框,基于小部件选项
覆盖选项
继承的选项 DateType: -choice_translation_domain--占位符-格式-输入-model_timezone-个月-view_timezone-小部件FormType: -数据-禁用-inherit_data-invalid_message-invalid_message_parameters-映射
父类型 DateType
BirthdayType

覆盖选项

类型数组默认的: 120年前到现在

年份字段类型可用的年份列表。时,此选项才相关小部件选项设置为选择

继承的选项

方法继承了这些选项DateType

choice_translation_domain

类型字符串布尔

此选项决定是否应该翻译所选值以及在哪个翻译域中翻译。

的值choice_translation_domain选项可以是真正的(重用当前翻译域),(禁用翻译),(使用父翻译域或默认域)或表示要使用的确切翻译域的字符串。

类型数组默认的: 1 ~ 31

日期字段类型可用的日期列表。时,此选项才相关小部件选项设置为选择

1
“天”= >范围(131

占位符

类型字符串|数组

如果小部件选项设置为选择,则该字段将表示为一系列的选择盒子。当占位符值为字符串时,它将被用作空白值在所有选择框中:

1 2 3
构建器->add (“生日”, BirthdayType::类,数组“占位符”= >“选择一个值”));

或者,你可以使用一个数组为年、月和日字段配置不同的占位符值:

1 2 3 4 5
构建器->add (“生日”, BirthdayType::类,数组“占位符”= >数组“年”= >“年”“月”= >“月”“天”= >“天”,)));

格式

类型整数字符串默认的IntlDateFormatter::中等(或yyyy-MM-dd如果小部件single_text

选项传递给IntlDateFormatter类,用于将用户输入转换为适当的格式。这是至关重要的小部件选项设置为single_text并将定义用户如何输入数据。默认情况下,格式是根据当前用户地区确定的:这意味着不同的用户期望的格式也不同.您可以通过将格式作为字符串传递来覆盖它。

有关有效格式的详细信息,请参见日期/时间格式语法

1 2 3 4 5 6 7 8
使用ob娱乐下载组件形式扩展核心类型DateType/ /……构建器->add (“date_created”, DateType::类,数组“部件”= >“single_text”这实际上是single_text的默认格式“格式”= >“yyyy-MM-dd”));

请注意

如果你想让你的字段呈现为HTML5“date”字段,你必须使用single_text窗口小部件具有yyyy-MM-dd格式(RFC 3339格式),如果您使用single_text小部件。

输入

类型字符串默认的datetime

的格式输入数据-即日期存储在基础对象上的格式。有效值为:

  • 字符串(如。2011-06-05
  • datetime(一个DateTime对象)
  • 数组(如。数组('year' => 2011, 'month' => 06, 'day' => 05)
  • 时间戳(如。1307232000

从表单返回的值也将被规范化为这种格式。

谨慎

如果时间戳使用,DateType在32位系统上仅限于1901年12月13日星期五20:45:54 GMT和2038年1月19日星期二03:14:07 GMT之间的日期。这是由于PHP本身的局限性

model_timezone

类型字符串默认的:系统默认时区

输入数据存储的时区。这一定是其中之一PHP支持的时区

个月

类型数组默认的: 1 ~ 12

月份字段类型可用的月份列表。时,此选项才相关小部件选项设置为选择

view_timezone

类型字符串默认的:系统默认时区

时区,用于如何向用户显示数据(因此也包括用户提交的数据)。这一定是其中之一PHP支持的时区

小部件

类型字符串默认的选择

该字段应呈现的基本方式。可以是以下之一:

  • 选择:呈现三个选择输入。对象中定义了选择的顺序格式选择。
  • 文本:呈现一个类型为3的字段输入文本(月、日、年)。
  • single_text:呈现一个类型的输入日期.类型验证用户的输入格式选择。

方法继承了这些选项FormType

数据

类型混合默认的:默认为底层结构的字段。

当你创建一个表单时,每个字段最初都会显示表单域数据的对应属性的值(例如,如果你将一个对象绑定到表单)。如果你想覆盖表单或单个字段的初始值,你可以在data选项中设置它:

1 2 3 4 5 6
使用ob娱乐下载组件形式扩展核心类型HiddenType/ /……构建器->add (“令牌”, HiddenType::类,数组“数据”= >“六边形abcdef”));

谨慎

数据选项总是在呈现时覆盖从域数据(对象)获取的值。这意味着当表单编辑一个已经持久化的对象时,对象值也会被覆盖,从而导致在表单提交时失去它的持久化值。

禁用

类型布尔默认的

如果不希望用户修改字段的值,可以将禁用选项设置为true。任何提交的值都将被忽略。

inherit_data

类型布尔默认的

此选项决定表单是否从其父表单继承数据。如果您有一组跨多个表单重复的字段,这可能很有用。看到如何使用"inherit_data"减少代码重复

谨慎

字段具有inherit_data选项集时,它按原样使用父表单的数据。这意味着数据变形金刚不会被应用到那个领域。

invalid_message

类型字符串默认的此值无效

这是验证错误消息,如果输入到该字段的数据没有意义(即验证失败),将使用该消息。

例如,如果用户将无意义的字符串输入到TimeType字段不能转换为实时的,或者如果用户输入字符串(例如。苹果)转换为数字字段。

正常(业务逻辑)验证(例如在设置字段的最小长度时)应该使用验证消息和验证规则(参考).

invalid_message_parameters

类型数组默认的数组()

当设置invalid_message选项时,您可能需要在字符串中包含一些变量。这可以通过在该选项中添加占位符并包括该选项中的变量来实现:

1 2 3 4 5
构建器->add (“some_field”, SomeFormType::类,数组/ /……“invalid_message”= >'您输入的值无效,它应该包含%num%字母'“invalid_message_parameters”= >数组“% num %”= >6)));

映射

类型布尔默认的真正的

如果希望在读取或写入对象时忽略该字段,则可以设置映射选项

此工作,包括代码示例,是根据创作共用BY-SA 3.0许可证。