字段类型

编辑本页

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

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

字段类型

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

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

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

基础数据类型 可以DateTime字符串时间戳,或数组(见输入选项
呈现为 可以是三个选择框或1个或3个文本框,基于小部件选项
覆盖选项
继承的选项
父类型 日期
BirthdayType

覆盖选项

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

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

继承的选项

方法继承了这些选项日期类型:

小部件

类型字符串默认的选择

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

  • 选择:呈现三个选择输入。对象中定义了选择的顺序格式选择。
  • 文本:呈现一个文本类型的三个字段输入(月,日,年)。
  • single_text:呈现date类型的单个输入(Symfony 2.0中的文本)。ob娱乐下载用户的
    类型对输入进行验证格式选择。

输入

类型字符串默认的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本身的局限性

个月

类型数组默认的: 1 ~ 12

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

类型数组默认的: 1 ~ 31

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

1
“天”= >范围(131

格式

类型整数字符串默认的IntlDateFormatter::中等

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

有关有效格式的详细信息,请参见日期/时间格式语法.例如,呈现一个期望用户输入的文本框yyyy-MM-dd,使用以下选项:

1 2 3 4
构建器->add (“date_created”“日期”数组“部件”= >“single_text”“格式”= >“yyyy-MM-dd”));

data_timezone

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

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

user_timezone

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

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

方法继承了这些选项日期类型:

invalid_message

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

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

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

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

invalid_message_parameters

类型数组默认的数组()

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

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

read_only

2.1

read_only选项在2.1中被更改为渲染为只读的HTML属性。在此之前,它呈现为禁用属性。使用禁用选项,如果您需要旧的行为。

类型布尔默认的

如果此选项为true,则该字段将使用只读的属性,使字段不可编辑。

禁用

2.1

禁用选项是2.1版的新功能

类型布尔默认的

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

映射

类型布尔

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

虚拟

类型布尔默认的

此选项决定是否将表单映射为数据。如果您需要一个表单来构造视图,这可能很有用。看到如何使用虚拟表单字段选项

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