為什麼捐款
API 瀏覽器
QTime

QTime 組件提供了一種輸入時間的方法。

提示

若要處理日期和/或時間,也請查看 Quasar 日期工具

載入 QTime API...

用法

請注意,模型僅為字串。

基本

基本



橫向模式



提示

對於橫向模式,您可以將其與 $q.screen 一起使用,使 QTime 具有響應性。範例::landscape="$q.screen.gt.xs"。更多資訊:Quasar Screen Plugin

功能

24 小時制格式的應用取決於您設定的 Quasar 語言包,但您也可以強制使用,如下例所示。

24 小時制格式



點擊「現在」按鈕會將時間設定為目前使用者時間

現在按鈕



停用和唯讀



模型遮罩

預設模型遮罩為 HH:mm(或使用 with-seconds prop 時為 HH:mm:ss),但您也可以使用自訂遮罩。

mask prop 的 tokens 可以在 Quasar 工具 > 日期工具 中找到。

SSR 注意事項

在遮罩中使用 xX (時間戳記) 可能會在客戶端造成 hydration 錯誤,因為解碼模型字串必須使用 new Date(),這會將本地時區納入考量。因此,如果伺服器與客戶端位於不同的時區,則伺服器呈現的輸出將與客戶端的不同,因此 hydration 將會失敗。

波斯曆注意事項

當使用波斯曆時,QTime 的遮罩會強制設定為 HH:mmHH:mm:ss(如果指定了 with-seconds)。

簡單遮罩



如果您想在遮罩中插入字串(包括 [] 字元),請確保用 [] 將它們包圍起來以進行轉義,否則這些字元可能會被解釋為格式 tokens。

帶有轉義字元的遮罩



使用遮罩將 QDate 和 QTime 連接到同一個模型

QDate 和 QTime 在同一個模型上



自訂臨時語言環境

如果由於某些原因,您需要使用自訂臨時語言環境而不是目前已設定的 Quasar 語言包,則可以使用 locale prop

自訂臨時語言環境



顏色

顏色



強制深色模式



限制選項

  • 您可以使用 hour-optionsminute-optionssecond-options props 來限制使用者只能選擇特定時間。
  • 或者,為了更深入地限制選項,您也可以將函數(如下面的第二個範例)提供給 options-fn prop。
選項



與 QInput 一起使用

輸入



在 QInput 上將 QDate 和 QTime 與同一個模型連接

QDate 和 QTime 與 QInput 一起使用



以下是 QInput maskrules props 的helpers。您可以使用這些 helpers 以方便使用,或編寫字串來指定您的自訂需求。

範例:「date」、「time」、「fulltime」。

更多資訊:QInput

帶有額外按鈕

您可以使用預設 slot 來新增按鈕

帶有額外按鈕



原生表單提交

當處理具有 actionmethod 的原生表單時(例如,當將 Quasar 與 ASP.NET controllers 一起使用時),您需要在 QTime 上指定 name property,否則 formData 將不會包含它(如果應該包含)。

原生表單