TimeText

時間文字是經過格式化的字串，代表目前時間。

這項元素已在 Wear OS 4 推出。

語法

<TimeText format="string" hourFormat="12 | 24 | SYNC_TO_DEVICE"
             align="START | CENTER | END" x="integer" y="integer"
             width="integer" height="integer" pivotX="float" pivotY="float"
             angle="float-degrees" alpha="integer"
             tintColor="argb-color | rgb-color" />

屬性

TimeText 元素的屬性如下：

必要屬性

必要屬性包括：

format

代表時間格式的格式字串。

這份清單能以多種格式顯示下午 12:34:56 這個時間：

• hh:mm:ss 會顯示為「12:34:56」。
• h:mm 會顯示為「12:34」
• hh_10 會顯示為「1」。
• hh_1 會顯示為「2」。
• m 會顯示為「34」
• mm_10 會顯示為「3」。
• mm_1 會顯示為「4」。
• ss 會顯示為「56」
• ss_10 會顯示為「5」。
• ss_1 會顯示為「6」。

x、y、width、height

這是一組指定元素大小和位置的整數。

選用屬性

選用屬性包括：

hourFormat

指定使用 12 小時或 24 小時制的標記法顯示時間。預設值為 SYNC_TO_DEVICE，且會套用裝置上已設定的使用者偏好選項。

align：

對齊定界框內文字的方式。預設為「START」。

pivotX、pivotY

與元素旋轉方向相關的 2D 樞紐點。兩個值都是浮點數，可在 $ [0, 1] $ 範圍內視需求調整。

angle

元素應以順時針方向從樞紐點旋轉的角度數值。

alpha

此屬性可設定元素應具備的透明度。如果值為 0，表示元素應完全透明；值為 255 表示元素應完全不透明。

tintColor

為元素套用色調顏色濾鏡。您必須使用 ARGB 格式 (#ff000000 = 不透明黑) 或 RGB 格式 (#000000 = 黑) 指定顏色。

內部元素

TimeText 元素可包含下列內部元素：

Variant

允許在 Wear OS 裝置處於微光模式時變更元素屬性。詳情請參閱 Variant 參考資料。

BitmapFont

用於顯示時間的 BitmapFont。

Font

用於顯示時間的字型。

，瞭解如何調查及移除這項存取權。