年

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

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

天

类型：数组默认的: 1 ~ 31

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

1

“天”= >范围(1，31）

empty_value

类型：字符串或布尔

这个选项决定了一个特殊的“空”选项(例如:“选择一个选项”)将出现在选择小部件的顶部。此选项仅适用于多个选项设置为false。

• 添加一个空值，文本为“Choose an option”:

  1 2 3

  ＄构建器->add (“州”，“选择”，数组（“empty_value”= >“选择一个选项”));

• 确保没有“空”值选项显示:

  1 2 3

  ＄构建器->add (“州”，“选择”，数组（“empty_value”= >假));

如果你离开empty_value选项未设置时，则当且仅当要求选项为false:

1 2 3 4

//添加一个空白(无文本)选项＄构建器->add (“州”，“选择”，数组（“要求”= >假));

格式

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

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

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

1 2 3 4 5

＄构建器->add (“date_created”，“日期”，数组（“部件”= >“single_text”，这实际上是single_text的默认格式“格式”= >“yyyy-MM-dd”));

输入

类型：字符串默认的：datetime

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

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

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

model_timezone

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

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

个月

类型：数组默认的: 1 ~ 12

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

view_timezone

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

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

小部件

类型：字符串默认的：选择

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

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

方法继承了这些选项形式类型:

数据

类型:混合默认的:默认为基础对象的字段(如果有的话)

创建表单时，每个字段最初显示表单域对象的相应属性的值(如果对象绑定到表单)。如果你想覆盖表单的初始值或只是一个单独的字段，你可以在data选项中设置它:

1 2 3

＄构建器->add (“令牌”，“隐藏”，数组（“数据”= >“六边形abcdef”));

禁用

类型：布尔默认的：假

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

inherit_data

类型：布尔默认的：假

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

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

类型：布尔默认的：假

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