Mashup Builder > 小器具 > 標準小器具 > 日期時間選擇器小器具 (主題化)
日期時間選擇器小器具 (主題化)
「日期時間選擇器」可讓使用者選取混搭中的日期與時間值。在執行時間，使用者可以選取月、年與日，來指定日期。或者，您也可以將小器具配置為包括小時、分鐘與秒。本主題包含下列各節：
小器具解析
1. 文字欄位
2. 開始日期
3. 結束日期
4. 月下拉清單
5. 年下拉清單
6. 日標籤
7. 所選日期
範圍選取模式
欲啟用範圍選取，請將 DateRange 組態設定為 true，範圍選取模式可讓使用者將日期或時間限制為特定範圍。您也可以在 YearRange 內容中鍵入數值來限制範圍選取。
時間選取
依預設，日期時間選擇器可讓您選取日期。欲啟用時間選取，請將小器具 DateOnly 內容設定為 false。禁用此內容可讓使用者同時選取時間與日期。欲新增秒，請將 DisplaySeconds 內容設定為 true。
間隔內容
使用 Interval 內容可相對於您開啟行事曆時的目前日期或時間，位移預設所選值。您可以使用 IntervalType 內容，按日、小時、分或秒來向前或向後位移所選值。例如，欲使日期選擇器小器具上的所選時間前進 30 分鐘，請將 IntervalType 設定為「分鐘」，並將 Interval 設定為 30。
設定日期與時間格式
您可以使用下列內容設定日期與時間的格式。
• DateOrder 內容可讓您設定日期順序。依預設，日期順序根據執行時間的使用者地區設定在執行時間自動設定。
• FormatToken 可讓您自訂日期與時間格式，FormatToken 內容會覆寫下列內容：DisplaySeconds、DateOnly、DateDelimiter、MonthFormat 與 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. 將月顯示為縮寫字串，其中 January 為 Jan。
e. 將完整月份名稱顯示為字串：January。
◦ DateOrder: DateOrder: 內容可讓使用者以三種不同順序之一設定日期順序。
a. 日-月-年。此為預設格式
b. 月-日-年。
c. 年-月-日。
如需詳細資訊，請參閱設定小器具日期與時間的格式。
內容
描述
基礎類型
預設值
可繫結? (Y/N)
可當地語系化?
Label
顯示在「日期時間選擇器」小器具標籤中的文字。
STRING
N/A
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/A
N
Y
MonthFormat
可讓您以完整、短或數值格式顯示月。
STRING
完整
N
N
PrimaryActionPosition
可讓您將主要動作按鈕的位置設定為「左」或「右」
主要動作是按鈕群組中的
• 「完成」
按鈕
STRING
左
N
N
DateOrder
可讓您設定日期顯示格式。不同的格式有「自動」、「日-月-年」、「月-日-年」與「年-月-日」
選取預設的「自動」時，系統日期會顯示在小器具中。此外，小器具會禁用 DateDelimiter 與 MonthFormat 內容。
STRING
自動
N
N
FormatToken
選取預設值「自動」時，會使用使用者地區設定來設定日期格式。此內容會覆寫 DateDelimiter 與 MonthFormat 內容。
* 
此內容使用 Moment.JS 庫語法。
STRING
N/A
N
Y
IntervalType
可讓您將間隔設定為「小時」、「分鐘」或「天」。
* 
秒僅在 ThingWorx 9.2 或更新版本中可用
STRING
小時
N
N
Interval
可讓您將間隔設定為「小時」、「分鐘」或「天」。
* 
秒間隔僅在 ThingWorx 9.2 或更新版本中可用
NUMBER
0
N
N
MaxRange
設定使用者可在開始與結束日期之間選取的最大天數。
* 
MaxRange 僅在 ThingWorx 9.4 或更新版本中提供
NUMBER
N/A
N
N
MaxRangeFailureMessage
開始日期和結束日期間的選定範圍超過 MaxRange 值時顯示的訊息。
* 
MaxRangeFailureMessage 僅在 ThingWorx 9.4 或更新版本中提供
STRING
N/A
Y
Y
CustomClass
可讓您定義小器具頂部分區之 CSS。可輸入多個類別，之間以空格分隔。
STRING
N/A
Y
N
TabSequence
使用者按下 Tab 鍵時小器具反白的順序。
NUMBER
N/A
N
N
WeeklyCalendarStart
可讓您將週行事曆的起始日設定為星期日或星期一。
STRING
星期一
N
N
InitializeWithCurrentDateTime
可讓您以目前日期與時間設定 DateTime 內容。若未選取此內容，則必須輸入日期時間。
BOOLEAN
TRUE
N
N
LabelAlignment
可讓您在小器具中向左、向右或置中對齊標籤。
STRING
左
N
N
DateTime
日期時間選擇器的日期與時間值來源。
DATETIME
N/A
Y
N
Changed
修改此小器具的資料時所觸發的可繫結事件。
N/A
N/A
Y
N
ResetToDefaultValue
將此小器具的輸入重設為其預設值。
N/A
N/A
Y
N
DateRange
可讓您以年、月、日為單位設定日期範圍。
當您選取此內容時，會新增下列內容：
• StartDate
• StartDateLabel
• EndDate
• EndDateLabel
• RangeHintText
• RangedChanged
* 
此事件在 ThingWorx 9.2 或更新版本中可用。
BOOLEAN
False
N
N
Width
小器具寬度。
NUMBER
N/A
N
N
Height
小器具高度。高度依預設會設定為標籤的最大寬度。如果小器具有多行標籤，高度會增加。在內容面板中輸入值或將畫布中的小器具重定大小，以設定固定高度。
NUMBER
N/A
N
N
CurrentDateButton
新增可讓您選取目前日期的按鈕。
BOOLEAN
True
N
N
YearRange
可讓您選取混搭的年份範圍。
NUMBER
10
N
N
這是否有幫助?