格式化小组件的日期和时间
可使用日期和时间格式化字符串的组合来配置小组件中的格式化日期和时间。日期和时间表示随区域设置和上下文的不同而变化。格式化可用于本地化以另一种语言显示混搭时的日期和时间。此外，还可通过其控制显示日期和时间的小组件 (例如日期选取器和值显示小组件) 中日期和时间的显示方式。可通过以下两种方式之一来指定日期格式：
• 通过在小组件格式属性中键入格式来手动指定。
• 使用能够让您根据用户区域设置创建和使用单独日期格式的本地化标记。
所支持格式均基于 Moment.js JavaScript 库，且区分大小写。有关上述库的详细信息，请参阅：
以下主题分为如下几个部分：
• 支持的日期格式
• 支持的时间格式
支持的日期格式
下表列出了日期的可用格式。
 |
以下列表适用于可作为 ThingWorx Web Component SDK 一部分的 Web 组件小部件。
|
|
类型
|
格式
|
输出
|
示例
|
|---|---|---|---|
|
工作日
|
d
|
显示范围介于 0 到 6 之间的数字，其中 0 表示星期日，6 表示星期六。
|
1
|
|
dd
|
显示星期的前两个字母。
|
Mo
|
|
|
ddd
|
显示星期的前三个字母。
|
Mon
|
|
|
dddd
|
显示星期全名。
|
Monday
|
|
|
年
|
YY
|
将年份显示为带前导零的两位数字。例如将 2009 显示为 09。
|
09
|
|
YYYY
|
将年份显示为四位数字。
|
2009
|
|
|
月
|
M
|
将月份数显示为范围介于 1 到 12 之间的数字，其中一月为 1，十二月为 12。
|
1
|
|
Mo
|
将月份数显示为范围介于 1 到 12 之间且带有序数指示符的数字，其中一月为 1st，十二月为 12th。
|
12th
|
|
|
MM
|
将月份数显示为范围介于 01 到 12 之间的数字，其中一月为 01，十二月为 12。
|
01
|
|
|
MMM
|
以缩写字符串形式显示月份。
|
Jan
|
|
|
MMMM
|
将完整月份名显示为字符串：January
|
January
|
|
|
季度
|
Q
|
将季度数显示为范围介于 1 到 4 之间的数字
|
2
|
|
Qo
|
将季度数显示为范围介于 1 到 4 之间且带有序数指示符的数字。
|
2nd
|
|
|
天
|
D
|
将月份中的某一天显示为范围介于 1 到 31 之间的数字。
|
30
|
|
Do
|
将月份中的某一天显示为范围介于 1 到 31 之间且带有序数指示符的数字，其中第一天为 1st，最后一天为 31st。
|
30th
|
|
|
DD
|
将月份中的某一天显示为范围介于 01 到 31 之间的数字。
|
23
|
|
|
一年中的日期
|
DDD
|
将一年中的日期显示为范围介于 1 到 365 之间的数字。
|
51
|
|
DDDo
|
将一年中的日期显示为范围介于 1 到 365 之间且带有序数指示符的数字，其中第一天为 1st，最后一天为 365th。
|
51st
|
|
|
DDDD
|
将一年中的日期显示为范围介于 001 到 365 之间的数字。
|
051
|
|
|
一年中的周
|
w
|
将当前周显示为范围介于 1 到 53 之间的数字。
|
42
|
|
wo
|
将周数显示为范围介于 1 到 53 之间且带有序数指示符的数字。
|
42nd
|
|
|
ww
|
将当前周显示为范围介于 1 到 53 之间的数字。对于 10 下的数字追加前导零。
|
01
|
支持的时间格式
下表列出了可用的时间格式。
|
类型
|
格式
|
输出
|
示例
|
|---|---|---|---|
|
24 小时格式
|
H
|
以 24 小时格式显示小时数。
|
• 0
• 23
|
|
HH
|
以 24 小时格式显示小时数，当值小于 10 时追加前导零。
|
• 00
• 23
|
|
|
12 小时格式
|
h
|
以 12 小时格式显示小时数。
|
• 1
• 12
|
|
hh
|
以 12 小时格式显示小时数，当值小于 10 时追加前导零。
|
• 01
• 12
|
|
|
分钟
|
m
|
显示分钟数。
|
• 0
• 59
|
|
mm
|
以两位数字显示分钟数，当值小于 10 时追加前导零。
|
• 00
• 59
|
|
|
秒
|
s
|
显示秒数
|
• 0
• 59
|
|
ss
|
显示秒数时追加前导零。
|
• 00
• 59
|
|
|
AM/PM
|
a
|
在使用 12 小时格式时，显示小写 AM 和 PM 缩写。
|
• am
• pm
|
|
A
|
在使用 12 小时格式时，显示大写 AM 和 PM 缩写。
|
• AM
• PM
|
|
|
毫秒
|
SSS
|
显示千分之一秒。
|
001
|
|
厘秒
|
SS
|
显示百分之一秒。
|
01
|
|
分秒
|
S
|
显示十分之一秒。
|
1
|
|
时区偏移
|
Z
|
显示当前时区的协调世界时 (UTC) 偏移量。
|
+3:00
|
|
ZZ
|
当前时区无冒号分隔符的 UTC 偏移量。
|
+300
|
使用日期和时间分隔符
可使用任何标点字符作为不同时间和日期单位之间的分隔符：
• , (逗号)
• .(句号)
• : (冒号)
• - (破折号)
• / (斜杠)
也可通过插入空格来分隔单位。
日期和时间格式使用示例
可根据需要组合可用的时间和日期格式来显示日期。例如要将日期和时间显示为：
请使用以下格式：
DD-MM-YYYY hh:mm:ss
其中：
• DD 表示日期：11
• MM 表示月份：10
• YYYY 表示年份：2020
• hh:mm:ss 表示 12 小时制时间：12:00:00
也可在字符串周围添加方括号，以将日期格式化为句子或短语。例如，下图显示的是日期选取器小组件中的日期：
dddd [the] Do [of] MMMM [at] hh:mm:ss a
其中：
• ddd 将星期表示为字符串：Sunday
• Do 表示带有序数指示符的日期数：11th
• MMMM 表示月份名称：October
• hh:mm:ss 表示时间：12:00:00
• a 表示小写的 AM/PM：am
要将季度名称缩写为 Q1、Q2、Q3 和 Q4，请键入：
[Q]Q
其中 [Q] 为字符串，Q 表示季度数。
为日期和时间格式化创建本地化标记
本地化标记能够让您基于用户的当前区域设置自动转换日期格式。要为日期格式添加本地化标记，请执行以下步骤：
1. 在 Composer 中，打开 默认 本地化表。
2. 在“本地化标记”选项卡中，单击“添加”。随即将显示侧面板。
3. 在“名称”框中，键入标记名称。当为其他语言添加标记时，此名称将用作参考。
4. 在“标记值”框中，键入用于当前语言的数据和时间格式。默认 表格可用于设置英语语言的格式。
5. 请记下已键入的本地化标记名称，单击 
以添加标记并关闭面板，然后予以“保存”。本地化标记即被添加到表格中。
以添加标记并关闭面板，然后予以“保存”。本地化标记即被添加到表格中。6. 重复步骤 1 至 5 以定义要为每种语言更改的日期和时间格式。在为其他表格创建标记时，可将于 默认 表格中指定的标记名称作为参考。
本地化标记目前已通过每种语言的特定格式进行了定义。要设置本地化标记，请执行以下操作：
1. 在 Mashup Builder 中，选择支持日期和时间格式化的小组件，然后打开“属性”面板。
2. 单击日期和时间格式属性旁的 
，以从服务器上的可用标记列表中进行选择。
，以从服务器上的可用标记列表中进行选择。3. 在框中输入于上一过程创建的标记名称。
4. 单击“保存”以保存混搭。
本地化标记现可用于设置属性值，且日期格式会根据混搭的当前区域设置自动更改。
可使用小组件配置对话框为某些小组件设置日期和时间格式。例如，要配置值显示小组件的格式，请单击 ValueFormat 属性旁的“呈现器和状态”。在该对话框中，选择“呈现器”器下的 DATETIME。可使用此对话框配置其他小组件 (例如“高级栅格”) 的日期和时间。
有关本地化表及标记的详细信息，请参阅本地化表。