時間選取器小器具
時間選取器小器具是一項資料輸入工具，用來選取開始和結束時間及協助篩選查詢。您可以將其設定為自動重新整理，然後使用「已更新」事件來持續重新整理網頁上的資料。該控制項可讓您向前或向後移動一刻鐘或是完整的間隔。
當您變更時間選取項時，自動重新整理即會關閉，且 Update 事件會等到使用者按一下「立即重新整理」按鈕才會觸發。這樣可以讓使用者在更新之前變更一或兩個日期。
內容
如需通用小器具內容的相關資訊，請參閱小器具。下表說明了專屬於時間選取器小器具的內容。
|
屬性名稱
|
描述
|
基礎類型
|
預設值
|
可繫結?(Y/N)
|
可當地語系化?(Y/N)
|
||||
|---|---|---|---|---|---|---|---|---|---|
|
CustomClass
|
要套用至小器具頂部分區之使用者定義的 CSS 類別。可輸入多個類別，之間以空格分隔。
|
STRING
|
n/a
|
Y
|
N
|
||||
|
StartDateTime
|
小器具的開始日期與時間來源。
|
DATETIME
|
n/a
|
Y
|
N
|
||||
|
EndDateTime
|
小器具的結束日期與時間來源。若未指定結束日期，便會使用目前的日期與時間。
|
DATETIME
|
n/a
|
Y
|
N
|
||||
|
Interval
|
初始間隔大小。
|
NUMBER
|
1
|
Y
|
N
|
||||
|
IntervalType
|
初始間隔類型 (小時、分鐘、秒或天)。
|
STRING
|
時數
|
Y
|
N
|
||||
|
UseIntervalAsMax
|
若已鎖定開始或結束日期，系統將不會考量在此間隔之外的輸入日期。
|
BOOLEAN
|
False
|
N
|
N
|
||||
|
RefreshInterval
|
若 AutoRefresh 為開啟狀態，用來重設為結束日期目前時間的間隔 (秒)，用於持續時間間隔。
|
NUMBER
|
30
|
N
|
N
|
||||
|
AutoRefresh
|
依照在 RefreshInterval 欄位中定義的間隔來重新整理小器具。
|
BOOLEAN
|
True
|
N
|
N
|
||||
|
DateOrder
|
年月日位置。
|
STRING
|
年-月-日
|
N
|
N
|
||||
|
DateDisplay
|
日期長度。
|
STRING
|
簡短
|
N
|
N
|
||||
|
DisplaySeconds
|
顯示時間 (秒)。
|
BOOLEAN
|
True
|
N
|
N
|
||||
|
DateDelimiter
|
用來分隔日、月和年的字元。
|
STRING
|
- (破折號)
|
N
|
Y
|
||||
|
DateFormatToken
|
當地語系化日期格式。採用字串或當地語系化權杖。這會取代 DateDelimiter、DateOrder 和 DateDisplay 內容。支援的格式值：
• mm：零填補編號月
• m：編號月
• M：短月份字串
• MM：長月份名稱
• dd：零填補編號日或月
• d：編號日或月
• yyyy/mm /：4 位數年
• yy：2 位數年
這兩種還原都發生在下次開啟日期時間挑選器時。欲避免此情形，請在為範圍外的年份進行選擇時使用四位數 "yyyy" 日期時間格式。
|
STRING
|
n/a
|
N
|
Y
|
||||
|
TabSequence
|
Tab 索引序列。
|
NUMBER
|
0
|
N
|
N
|
||||
|
Widescreen
|
針對寬螢幕設定變更版面配置。
|
BOOLEAN
|
True
|
N
|
N
|
||||
|
ShowLockControls
|
新增控制項來鎖定開始/結束日期。
|
BOOLEAN
|
False
|
N
|
N
|
||||
|
Updated
|
事件。在使用者按一下「立即重新整理」按鈕時或在觸發 AutoRefresh 選項時觸發。
|
n/a
|
n/a
|
Y
|
N
|
