DateIntervalType领域

编辑本页

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

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

DateIntervalType领域

此字段允许用户选择时间间隔的时间。例如,如果您希望允许用户进行选择多长时间他们会收到一封状态电子邮件,他们可以使用这个字段来选择间隔,比如每“10分钟”或“3天”。

字段可以以各种不同的方式呈现(参见小部件),并可配置为给您一个DateInterval对象,一个ISO 8601持续时间字符串(例如:P1DT12H)或数组(参见输入).

基础数据类型 可以DateInterval字符串或数组(请参阅输入选项)
呈现为 单个文本框、多个文本框或选择字段-请参见小部件选项
选项
继承的选项
父类型 FormType
DateIntervalType

基本用法

此字段类型是高度可配置的,但易于使用。最重要的选择是输入而且小部件

你可以配置很多不同的选择,包括哪一个要显示的选项范围(例如,不显示“months”,但是“天”):

1 2 3 4 5 6 7 8 9 10
构建器->add (“remindEvery”, DateIntervalType::类,“部件”= >“整数”//渲染每个部分的文本字段// 'input' => 'string', //如果你想让字段返回一个ISO 8601字符串给你//自定义显示的文本框“with_years”= >“with_months”= >“with_days”= >真正的“with_hours”= >真正的]);

场的选择

类型数组默认的: 0 ~ 31

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

1
“天”= >范围(131

占位符

类型字符串数组

如果小部件选项设置为选择,则该字段将表示为一系列的选择盒子。的占位符选项可用于在每个选择框的顶部添加一个“空白”条目:

1 2 3
构建器->add (“remindEvery”, DateIntervalType::类,“占位符”= >]);

或者,你可以指定一个字符串来显示"blank"值:

1 2 3
构建器->add (“remindEvery”, DateIntervalType::类,“占位符”= > [“年”= >“年”“月”= >“月”“天”= >“天”]]);

小时

类型数组默认的: 0 ~ 24

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

1
“小时”= >范围(124

输入

类型字符串默认的dateinterval

的格式输入数据-即间隔存储在底层对象上的格式。有效值为:

  • 字符串格式化的字符串ISO 8601标准,如。P7Y6M5DT12H15M30S
  • dateinterval(一个DateInterval对象)
  • 数组(如。['days' => '1', 'hours' => '12',]

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

标签

类型数组默认的:(见下文)

为该类型的每个元素显示的标签。默认值为,因此它们显示子名称的“人性化版本”(等):

1 2 3 4 5 6 7 8 9
“标签”= > [“反转”= >“年”= >“月”= >“天”= >“小时”= >“分钟”= >“秒”= >,)

分钟

类型数组默认的: 0 ~ 60

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

1
“分钟”= >范围(160

个月

类型数组默认的: 0 ~ 12

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

1
“月”= >范围(112

类型数组默认的: 0 ~ 60

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

1
“秒”= >范围(160

类型数组默认的: 0 ~ 52

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

1
“周”= >范围(152

小部件

类型字符串默认的选择

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

with_days

类型布尔默认的真正的

输入中是否包含天数。这将导致额外的输入来捕获天数。

谨慎

这不能用于时with_weeks启用。

with_hours

类型布尔默认的

输入中是否包含小时数。这将导致额外的输入以捕获小时数。

with_invert

类型布尔默认的

是否在输入中包含反转。这将导致一个额外的复选框。此方法不能用于小部件选项设置为single_text

with_minutes

类型布尔默认的

是否在输入中包含分钟。这将导致额外的输入以捕获分钟数。

with_months

类型布尔默认的真正的

输入中是否包含月份。这将导致捕获月份的额外输入。

with_seconds

类型布尔默认的

是否在输入中包含秒。这将导致额外的输入以捕获秒数。

with_weeks

类型布尔默认的

输入中是否包含周数。这将导致占用数周的额外输入。

谨慎

这不能用于时with_days启用。

with_years

类型布尔默认的真正的

输入中是否包含年份。这将导致获取年份的额外输入。

类型数组默认的: 0 ~ 100

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

1
“年”= >范围(1One hundred.

继承的选项

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

数据

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

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

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

谨慎

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

禁用

类型布尔默认的

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

帮助

类型字符串默认的:零

允许您为表单字段定义帮助消息,默认情况下,表单字段呈现在字段下面。

1 2 3
构建器->add (“zip_code”, (“帮助”= >“您信用卡账单地址的邮政编码。”]);

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)));

映射

类型布尔默认的真正的

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

场变量

变量 类型 使用
小部件 混合 的值小部件选择。
with_days 布尔 的值with_days选择。
with_invert 布尔 的值with_invert选择。
with_hours 布尔 的值with_hours选择。
with_minutes 布尔 的值with_minutes选择。
with_months 布尔 的值with_months选择。
with_seconds 布尔 的值with_seconds选择。
with_weeks 布尔 的值with_weeks选择。
with_years 布尔 的值with_years选择。
此工作,包括代码示例,是根据创作共用BY-SA 3.0许可证。