熟悉App日期时间控制组件

ThingsX App 设备界面支持日期时间控制组件，通过合理的使用它们，您可以为用户的物联网设备实现一些时间相关的能力，例如定时开关、定期重复等功能。

进入任意设备类型的 App 编辑器，可以轻松找到日期时间控制类组件，如下图：

以下为您介绍这些组件的用法和示例。

时间组件

用来选择时间，例如：开机时间、启动时间、维护时间等。

该组件可绑定以下数据类型的属性：

• Text（文本类型）

在创建属性定义时，使用 Text 数据类型，如下：

将属性绑定到该组件，如下图：

使用文本类型属性时，属性值格式为 HH:mm:ss，例如：

08:30:00

• Object（键值对）

若设备端更倾向于接收 JSON 格式数据，可以将属性的数据类型设置为 Object（键值对），如下图：

属性值的格式如下：

{
    "h": 8,
    "m": 30,
    "s": 0
}

时间重复组件

用来设置时间的重复规则，例如：不重复、每天、自定义。该组件通常和上边的时间组件搭配使用。

我们使用数字表示一个星期中的每一天，如下：

• 0：周日
• 1：周一
• 2：周二
• 3：周三
• 4：周四
• 5：周五
• 6：周六

该组件可绑定以下数据类型的属性：

• Text（文本类型）

如果选择每天，属性值为：

0123456

如果选择自定义周一到周五，属性值为：

12345

如果选择不重复，属性值为空字符串：

• List（列表）

若设备端更倾向于接收 JSON 格式数据，可使用 List 数据类型的属性。

如果选择每天，属性值为：

[0,1,2,3,4,5,6]

如果选择自定义周一到周五，属性值为：

[1,2,3,4,5]

如果选择不重复，属性值为空数组：

[]

时间长度组件

用来设置时间长度，例如：延迟时间。

在组件选项中，您还可以设置用户可选择的间隔时间长度，如下图：

该组件可绑定以下数据类型的属性：

• Number（数值）

使用数值类型，表示时间长度的总秒数，例如：

3600

• Object（键值对）

若设备端更倾向于接收 JSON 格式数据，可使用 Object 数据类型的属性。

属性值格式如下：

{
    "h": 8,
    "m": 30,
    "s": 0
}

日期组件

用来设置日期，例如：维护日期、停机日期。

该组件可绑定以下数据类型的属性：

• Text（文本类型）

使用文本类型时，属性值的格式为 YYYY:MM:DD，例如：

2024-06-20

• Object（键值对）

若设备端更倾向于接收 JSON 格式数据，可使用 Object 数据类型的属性。

属性值格式如下：

{
    "y": 2024,
    "m": 6,
    "d": 20
}

通过以上的学习，您是否掌握了日期时间组件的使用方法呢？快来试试吧！

关于 ThingsX App 的详细介绍，请参考 用户 App 通用版