DataV：時間器

圖表樣式

時間器是文字組件的一種，支援自訂時間器的表徵圖樣式和文本樣式，包括表徵圖的大小、顏色、位置以及時間的顯示格式等，能夠在可視化應用中展示系統的目前時間，協助您合理控制可視化應用或可視化應用中某個模組的示範時間。

配置面板

• 搜尋配置：單擊配置面板右上方的搜尋配置，可在搜尋配置面板中輸入您需要搜尋的配置項名稱，快速定位到該配置項，系統支援模糊比對。詳情請參見搜尋資產配置。

• 圖表尺寸：包括組件的寬度和高度，單位為px。可單擊表徵圖鎖定組件的寬高比，等比例修改組件的寬高。再次單擊進行解鎖，解鎖後寬高比不受限制。
• 圖表位置：包括組件的橫座標和縱座標，單位為px。橫座標為組件左上方距離頁面左邊界的像素距離，縱座標為組件左上方距離頁面上邊界的像素距離。
• 旋轉角度：以組件的中心為中心點，進行旋轉，單位為度（°）。
  • 手動輸入角度值，控制組件的旋轉角度。
  • 拖動表徵圖內的黑點，控制組件的旋轉角度。
  • 單擊表徵圖，控制組件左右翻轉樣式。
  • 單擊表徵圖，控制組件上下翻轉樣式。
• 不透明度：取值範圍為0~1。為0時，圖表隱藏；為1時，圖表全部顯示。預設為1。

• 表徵圖樣式：時間器中表徵圖的樣式，單擊表徵圖控製圖標樣式的顯隱。

  參數	說明
  大小	表徵圖的大小，若不需要表徵圖則設定為0。
  顏色	表徵圖的顏色，請參見顏色選取器說明進行修改。
  邊距	表徵圖與時間器文本之間的距離。

• 時間器

  參數	說明
  文本樣式	設定時間器文本的字型、字型大小、字型顏色和字型粗細。
  格式化	設定時間器文本的顯示格式。預設為yyyy-MM-dd HH:mm:ss，表示“年月日時分秒”的時間格式，為24小時制的格式。如果為hh:mm:ss，表示12小時制的格式。
  間隔時間	設定組件時間變化的間隔時間，單位為ms。例如設定為10000ms，那麼組件的時間每隔10s變化一次。
  停住時間	時間器中的時間是不斷變化的，此配置項可以設定時間器的時間在什麼時候停住，不再發生變化。需要與格式化配置項中配置的時間格式保持一致。 例如設定停住時間為2023-05-27 11:52:00，那麼當時間器的時間變化到2023-05-27 11:52:00時，時間將停住，不再變化。
  停住顯示時間	設定時間器的時間停住後，顯示的時間，只有配置了停住時間後才會生效。需要與格式化配置項中配置的時間格式保持一致。 例如設定停住時間為2023-05-27 11:52:00，停住顯示時間為2023-05-28 12:00:00，那麼當時間器的時間變化到2023-05-27 11:52:00時，時間將停住，且顯示為2023-05-28 12:00:00。
  水平對齊	時間器在水平方向的對齊樣式，可選靠左對齊、置中對齊和靠右對齊。
  垂直對齊	時間器在垂直方向的對齊樣式，可選頂對齊、置中對齊和底對齊。

• 回調配置

  參數	說明
  定時回調設定	單擊表徵圖控制定時回調設定的顯隱。 回調拋出間隔：每隔多久拋出一次回調值，單位為ms。
  定點回調設定	單擊表徵圖控制定點回調設定的顯隱。 定點拋出時間：回調值拋出的時間點，支援表示日期的字串值。

資料面板

此組件不需要配置資料，預設讀取系統目前時間。

互動面板

藍圖編輯器互動配置

1. 在畫布編輯器頁面，按右鍵組件，選擇匯出到藍圖編輯器。
2. 單擊頁面左上方的表徵圖。

3. 在藍圖編輯器配置頁面，單擊匯入節點欄內的時間器組件，在畫布中可以看到如下圖所示的時間器的藍圖編輯器配置參數。

   • 事件

     事件	說明
     當時間變化時	當時間變化時拋出的事件，同時拋出目前時間對應的資料項目。
     當時間到設定時間時	當時間到設定時間時拋出的事件，同時拋出目前時間對應的資料項目。

   • 動作

     動作	說明
     更新群組件配置	動態更新組件的樣式配置。需要先在組件的配置面板中，單擊複製配置到剪貼簿，擷取組件配置資料。再根據需要在藍圖編輯器配置頁面的資料處理節點中更改對應樣式的欄位值。
     顯示	顯示組件，參考資料樣本如下。 return { "animationType": "", "animationDuration": 1000, "animationEasing": "linear" };
     隱藏	隱藏組件，參考資料樣本如下。 return { "animationType": "", "animationDuration": 1000, "animationEasing": "linear" };
     切換顯隱狀態	切換組件顯示或者隱藏，參考資料樣本如下。 return { "animationIn": { "animationType": "", "animationDuration": 1000, "animationEasing": "linear" }, "animationOut": { "animationType": "", "animationDuration": 1000, "animationEasing": "linear" } };
     移動	將組件移動到指定位置，參考資料樣本如下。 return { // 移動方式。絕對位置：to，相對定位：by。預設值：to。 "positionType": "to", // 指定位置。x座標，y座標。 "attr": { "x": 0, "y": 0 }, // 動畫方式。 "animation": { "enable": false, // 動畫延時。 "animationDuration": 1000, // 動畫曲線。可選值為：linear|easeInOutQuad|easeInOutExpo。 "animationEasing": "linear" } };

案例示範

本案例通過時間戳記參數聯動頁面內與時間戳記相關的組件資料查詢。

1. 登入DataV控制台。

2. 選擇任一可視化應用，單擊編輯，進入畫布編輯器頁面。

3. 添加時間器和通用標題兩個組件到畫布中。

4. 單擊時間器，選擇配置面板，設定回調配置 > 定時回調配置下的回調拋出間隔為3000ms。

5. 單擊通用標題，選擇資料面板，單擊配置資料來源，配置資料來源類型為資料庫，並編寫SQL。

   select :start_time as value

6. 按右鍵組件，將兩個組件匯入藍圖編輯器中。

7. 串連組件。

8. 配置串列資料處理節點的處理方法。

   return {
     start_time:
       new Date(data.time).valueOf() - 60 * 1000, // 目前時間前 60s
     end_time:
       new Date(data.time).valueOf() // 目前時間
   } 

9. 單擊頁面右上方的表徵圖，預覽展示結果。