“日期时间选取器”小组件 (可应用主题)
用户可通过日期时间选取器在混搭中选择日期和时间值。用户可在运行时通过选择月、年和日来指定日期。或者，可将小组件配置为包括小时、分钟和秒。本主题包含以下章节：
• 小组件剖析
• 范围选择模式
• 时间选择
• 间隔属性
• 日期时间格式化
小组件剖析
1. 文本字段
2. 开始日期
3. 结束日期
4. 月下拉列表
5. 年下拉列表
6. 日标签
7. 选定日期
范围选择模式
要启用范围选择，请将 DateRange 配置设置为 true，范围选择模式允许用户将日期或时间限制于特定范围。也可通过在 YearRange 属性中键入数字值来限制范围选择。
时间选择
默认情况下，日期-时间选取器可用于选择日期。要启用时间选择，请将小组件 DateOnly 属性设置为 false。用户可通过禁用属性同时选择时间和日期。要添加秒，请将 DisplaySeconds 属性设置为 true。
间隔属性
使用 Interval 属性，可在打开日历后相对于当前日期或时间偏移默认选定值。您可以使用 IntervalType 属性以天、小时、分钟或秒为单位向前或向后偏移选定值。例如，要将日期选取器小组件上的选定时间提前 30 分钟，可将 IntervalType 设置为“分钟”，将 Interval 设为 30。
设置日期和时间格式
可使用以下属性设置日期和时间格式。
• DateOrder 属性允许设置日期顺序。默认情况下，会在运行时基于用户的区域设置自动设置日期顺序。
• FormatToken 允许自定义日期和时间格式，FormatToken 属性会覆盖 DisplaySeconds、MonthFormat、DateOnly、DateDelimiter 和 DateOrder 属性。
◦ DisplaySeconds: DisplaySeconds 属性允许用户以两种不同格式显示秒。
a. 0:59
b. 00 59.
◦ DateOnly: DateOnly 属性允许用户以三种格式显示月份中的日期。
a. 将月份中的某一天显示为范围介于 1 到 31 之间的数字。
b. 将月份中的某一天显示为范围介于 1 到 31 之间且带有序数指示符的数字，即第一天为 1st，最后一天为 31st。
c. 将月份中的某一天显示为范围介于 01 到 31 之间的数字。
◦ DateDelimiter: DateDelimiter 属性允许用户将五种不同类型的标点字符之一用作不同时间和日期单位之间的分隔符。
a. 
◦ MonthFormat: MonthFormat 属性允许用户以五种不同格式之一显示年中的月份。
a. 将月份数显示为范围介于 1 到 12 之间的数字，其中一月为 1，十二月为 12。
b. 将月份数显示为范围介于 1 到 12 之间且带有序数指示符的数字，其中一月为 1st，十二月为 12th。
c. 将月份数显示为范围介于 01 到 12 之间的数字，其中一月为 01，十二月为 12。
d. 显示月份缩写名称，例如一月为 Jan。
e. 显示月份完整名称：January。
◦ DateOrder: DateOrder: 属性允许用户以三种不同的顺序之一设置日期顺序。
a. 日-月-年。此为默认格式
b. 月-日-年。
c. 年-月-日。
有关详细信息，请参阅格式化小组件的日期和时间。
属性 | 说明 | 基本类型 | 默认值 | 是否可绑定? (Y/N) | 是否可本地化? | ||
Label | 日期时间选取器小组件的标签中显示的文本。 | STRING | 不适用 | Y | Y | ||
Disabled | 使用此属性可以禁用混搭中的小组件。小组件会显示在混搭中，但无法单击。 | BOOLEAN | FALSE | Y | N | ||
HintText | 显示用于说明字段中应输入内容的占位符文本。 | STRING | 选择日期和时间 | Y | Y | ||
DateOnly | 用于仅显示日期。 | BOOLEAN | TRUE | N | N | ||
DisplaySeconds | 用于显示以秒计的时间。 | BOOLEAN | FALSE | N | N | ||
DateDelimter | 设置用于分隔日、月和年的字符。例如，- (连字符) 或 / (斜杠)，如 05/10/2020 中所示。 | STRING | 不适用 | N | Y | ||
MonthFormat | 用于以完整、简短或数字格式显示月份。 | STRING | 完整 | N | N | ||
PrimaryActionPosition | 可将主要操作按钮的位置设置为“左”或“右”。 主要操作是“完成”按钮组中的 • “完成” 按钮组中的按钮 | STRING | 左 | N | N | ||
DateOrder | 用于设置日期显示格式。有“自动”、“日-月-年”、“月-日-年”和“年-月-日”等不同格式 选中默认的“自动”时，系统日期会显示在此小组件中。此外，DateDelimiter 和 MonthFormat 属性还可通过此小组件禁用。 | STRING | 自动 | N | N | ||
FormatToken | 选中默认的“自动”时，用户区域设置将用于设置日期格式。此属性会覆盖 DateDelimiter 和 MonthFormat 属性。
| STRING | 不适用 | N | Y | ||
IntervalType | 用于将间隔设置为“小时”、“分钟”或“天”。
| STRING | 小时 | N | N | ||
Interval | 用于将间隔设置为“小时”、“分钟”或“天”。
| NUMBER | 0 | N | N | ||
MaxRange | 用于设置：用户可在开始日期和结束日期之间选择的最大天数。
| NUMBER | 不适用 | N | N | ||
MaxRangeFailureMessage | 当介于开始和结束日期的选定时间范围超出 MaxRange 值时，显示的消息。
| STRING | 不适用 | Y | Y | ||
CustomClass | 用于定义要应用于小组件顶层 div 的 CSS 类。可以输入多个类，以空格作为分隔符。 | STRING | 不适用 | Y | N | ||
TabSequence | 当用户按下 Tab 键时，内容将在其中突出显示的小组件序列。 | NUMBER | 不适用 | N | N | ||
WeeklyCalendarStart | 用于将每周日历设置为从星期日还是星期一开始。 | STRING | 星期一 | N | N | ||
InitializeWithCurrentDateTime | 用于使用当前日期和时间设置“日期时间”属性。如果此属性未处于选中状态，则必须输入日期和时间。 | BOOLEAN | TRUE | N | N | ||
LabelAlignment | 可用于将标签在小组件中靠左、靠右或居中对齐。 | STRING | 左 | N | N | ||
DateTime | 日期时间选取器的日期和时间值的源。 | DATETIME | 不适用 | Y | N | ||
Changed | 可绑定事件，在修改此小组件的数据时触发。 | 不适用 | 不适用 | Y | N | ||
ResetToDefaultValue | 将此小组件的输入重置为其默认值。 | 不适用 | 不适用 | Y | N | ||
DateRange | 允许以年、月、天为单位设置日期范围。 选择此属性时，将添加以下属性： • StartDate • StartDateLabel • EndDate • EndDateLabel • RangeHintText • RangedChanged
| BOOLEAN | False | N | N | ||
Width | 小组件宽度。 | NUMBER | 不适用 | N | N | ||
Height | 小组件高度。默认情况下，高度将设置为标签的最大宽度。如果小组件具有多行标签，则高度会增加。在属性面板中输入一个值，或在工作区中调整小组件的大小，以设置固定的高度。 | NUMBER | 不适用 | N | N | ||
CurrentDateButton | 添加用于选择当前日期的按钮。 | BOOLEAN | True | N | N | ||
YearRange | 允许选择混搭的年范围。 | NUMBER | 10 | N | N |
