“日期时间选取器”控件（不推荐）

该控件是用户可查看并输入日期和时间的用户界面。

在大多数浏览器中，“日期时间选取器”控件显示该浏览器中包含的本机日期和时间选择器。 该行为意味着当用户切换浏览器时，会看到不同的日期时间选取器。例如，在笔记本电脑上，用户可能使用 Google Chrome 处理任务，因此会看到 Chrome 日期和时间选择器。然后，如果用户切换至 Apple iPhone，用户将看到 Apple Safari 日期和时间选择器。如果浏览器没有本机日期和时间选择器，那么该控件将使用自己的日期和时间选择器。例如，Mozilla Firefox 是没有包括本机日期和时间选择器的浏览器。

由于日期时间选取器使用浏览器日期和时间选择器，因此用户必须在其 IBM® BPM 概要文件和浏览器中设置其语言偏好。在这两处设置语言可以确保行为正确。

虽然采用 UTC 时间存储日期，但会针对用户系统的时区调整显示的日期和时间。

限制和局限性

局限性
  • 注意： 如果用户输入日期不完整或格式无效的内容，那么当用户触发边界事件（如单击按钮）时，绑定数据项将为空。 如果流返回到 Coach，那么该控件为空。绑定到相同数据项的任何其他控件也为空。
  • 使用 Microsoft Internet Explorer 9（不推荐）时，用户看到的“日期时间选取器”控件位于使用水平布局的部分内，占据该部分的整个宽度。该部分中的其他控件环绕周围，以便以类似垂直布局的形式放置于日期时间选取器的上方或下方。要防止此行为，请在“日期时间选取器”控件的布局属性中设置宽度，如 25em。

数据绑定

在常规属性选项卡中设置控件的数据绑定。
表 1. “日期时间选取器”控件数据绑定
绑定描述 数据类型
包含要显示的初始日期和时间并存储对该值的更新。 Date

主题定义

主题编辑器的设计方式包含此控件的模拟。如果将光标悬停在模拟上方，那么将会列出用于确定控件外观的主题定义。 有关主题编辑器的信息，请参阅创建主题。

配置属性

在配置属性选项卡中设置或修改控件配置。
屏幕大小
在属性名称旁边具有“屏幕大小”图标 “屏幕大小”图标 的配置属性可具有针对每种屏幕大小的不同值。如果您未设置值，那么屏幕大小会继承下一个更大的屏幕大小值来作为其缺省值。如果您正在使用 Process Designer 桌面编辑器，那么需要为大屏幕大小设置相应的值。其他屏幕大小将继承该值。

使用本地日期和时间选择器意味着部分配置选项不适用于某些浏览器或具有备用行为。例如，如果使用 Google Chrome V30 或更高版本，那么日期格式和显示日历配置选项不适用。此外，显示日历选项已有功能限制，因为没有内嵌的日历和单独的单击按钮（但是，用户可以在字段边缘看见箭头）。

表 2. “日期时间选取器”控件配置属性
配置属性 描述 数据类型
日期格式 设置用于显示和解析文本字段中输入的文本的格式，例如 MM/dd/yyyy 或 dd/MM/yyyy。 该配置选项支持与 Java™ SimpleDateFormat 相同的格式。有关信息，请参阅http://docs.oracle.com/javase/6/docs/api/index.html?java/text/SimpleDateFormat.html。

该配置选项只可在浏览器未包含本机日期选择器时应用。

 String
占位符提示 屏幕尺寸图标 用户所需输入的简明描述或示例。如果绑定数据项不包含值，那么用户在字段中输入值之前，会一直看到该提示。 String
显示日历 屏幕尺寸图标 选择日历显示。
  • 单击时：仅当用户单击文本字段或单击文本字段旁边的图标时才显示日历。单击时是缺省值。
  • 直接插入显示直接插入的日历并隐藏输入文本字段。
  • 从不显示输入文本字段并隐藏日历。
 CalendarShowSelection
日历类型 选择日历类型：
  • Gregorian（缺省值）
  • Hebrew
  • Islamic
 CalendarType
包含时间选择器 屏幕尺寸图标 选择是否将时间选择器添加到日期时间选取器。

未选择缺省值 (False)。

 Boolean
中断日期 设置用户无法选择的一个或多个日期。

如果浏览器不支持中断日期，且已提供中断日期列表，那么该控件将使用自己的日期和时间选择器，而非本机浏览器日期和时间选择器。

 Date (List)
样式 > 文本大小 屏幕尺寸图标 设置控件中文本的大小、标签文本的大小以及文本四周的内间距量。 例如，要使智能手机上的文本和标签更易读，您可以针对较小的屏幕尺寸将此配置选项设置为 Large。

缺省值为 Medium。

 String
父主题： 响应式 Coach Toolkit 中的控件（不推荐）