設定小器具日期與時間的格式
您可以使用日期與時間格式字串的組合來配置小器具中的日期與時間格式設定。日期與時間表示會因地區設定及前後關聯而有所不同。設定格式可讓您在以其他語言顯示混搭時，當地語系化日期與時間。您也可以使用它來控制顯示日期與時間的小器具 (例如「日期選擇器」與「值顯示」小器具) 顯示日期與時間的方式。您可透過下列兩種方式之一指定日期格式：
• 在小器具格式設定內容中手動鍵入格式。
• 使用可讓您根據使用者地區設定建立及使用不同日期格式的當地語系化權杖。
支援的格式以 Moment.js JavaScript 程式庫為基礎，且區分大小寫。如需有關程式庫的詳細資訊，請參閱：
接下來的各部份內容將會分別介紹下列主題：
• 支援的日期格式
• 支援的時間格式
支援的日期格式
下表列出了可用的日期格式。
 |
下列清單適用於可作為 ThingWorx Web 元件 SDK 一部份使用的 Web 元件小器具。
|
|
類型
|
格式
|
輸出
|
範例
|
|---|---|---|---|
|
工作日
|
d
|
顯示介於 0 到 6 之間的範圍，其中 0 為星期日，6 為星期六。
|
1
|
|
dd
|
顯示日的前兩個字母。
|
Mo
|
|
|
ddd
|
顯示日的前三個字母。
|
Mon
|
|
|
dddd
|
顯示周中的日的完整名稱。
|
星期一
|
|
|
年
|
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
|
1 月
|
|
|
季
|
Q
|
將季度顯示為介於 1 到 4 之間的範圍。
|
2
|
|
Qo
|
將季度顯示為介於加上序數標識的 1 到 4 之間的數字。
|
第二
|
|
|
日數
|
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 中，開啟 Default 當地語系化表。
2. 在「當地語系化權杖」標籤中，按一下「新增」。側面板即會顯示。
3. 在「名稱」方塊中，鍵入權杖名稱。當您新增其他語言的權杖時，此名稱會作為參考使用。
4. 在「權杖值」方塊中，鍵入要用於目前語言的日期與時間格式。Default 表會設定英文語言的格式。
5. 記下您鍵入的當地語系化權杖名稱，按一下 
以新增權杖並關閉面板，然後按一下「儲存」。當地語系化權杖即會新增至表格。
以新增權杖並關閉面板，然後按一下「儲存」。當地語系化權杖即會新增至表格。6. 重複步驟 1 到 5，為您要變更的每種語言定義日期與時間格式。當您為其他表格建立權杖時，請使用在 Default 表中指定的權杖名稱作為參考。
現在，當地語系化權杖是使用每種語言的特定格式所定義。欲設定當地語系化權杖，請執行下列步驟：
1. 在 Mashup Builder 中，選取支援日期與時間格式設定的小器具，然後開啟「內容」面板。
2. 按一下日期與時間格式內容旁邊的 
以從伺服器上的可用權杖清單中選取。
以從伺服器上的可用權杖清單中選取。3. 在方塊中，輸入您在之前程序中建立的權杖名稱。
4. 按一下「儲存」，儲存混搭。
當地語系化權杖現在可用來設定內容值，且日期格式會根據混搭的目前地區設定自動變更。
您可使用小器具組態對話方塊設定某些小器具的日期與時間格式。例如，欲配置「值顯示」小器具的格式，請按一下 ValueFormat 內容旁邊的「轉譯器和狀態」。在對話方塊中，選取「轉譯器」下的 DATETIME。您可使用此對話方塊配置其他小器具 (例如「進階格點」) 的日期與時間。
如需有關當地語系化表與權杖的詳細資訊，請參閱當地語系化表。