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

表示时间格式的格式字符串。

此列表包含多种不同的格式，用于显示时间是上午 9:01:05：

• hh:mm:ss 将呈现为“09:01:05”
• h:mm 将呈现为“9:01”
• ss 将呈现为“05”
• m 将呈现为“1”

x、y、width、height

用于指定元素的尺寸和位置的整数集合。

可选属性

以下属性是可选属性：

hourFormat

使用 12 小时制还是 24 小时制来显示时间。默认设置为 SYNC_TO_DEVICE，这样即会应用在设备上配置的用户偏好设置。

align：

如何对齐边界框内的文本。默认设置为“START”。

pivotX、pivotY

表示元素围绕其旋转的二维轴心点。这两个值都是浮点数，且均会经过调整以符合 $ [0, 1] $ 这一范围。

angle

表示元素围绕轴心点顺时针旋转时应遵循的角度值。

alpha

用于设置此元素应具有的透明度。值 0 表示此元素应是完全透明的。值 255 表示此元素应是完全不透明的。

tintColor

对此元素应用色调滤镜。您必须使用 ARGB 格式（#ff000000 = 不透明的黑色）或 RGB 格式（#000000 = 黑色）来指定颜色。

内部元素

TimeText 元素可以包含以下内部元素：

Variant

允许在 Wear OS 设备处于氛围模式时更改此元素的属性。如需了解详情，请参阅 Variant 参考文档。

BitmapFont

用于渲染时间的 BitmapFont。

Font

用于渲染时间的 Font。