时间文本

时间文本是表示当前时间的格式化字符串。

在 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 元素具有以下属性

必需属性

以下属性是必需的

格式

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

此列表包含几种不同的时间显示格式 12:34:56 PM

  • 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

指定元素大小和位置的一组整数。

可选属性

以下属性是可选的

小时格式
是否使用 12 小时或 24 小时记法显示时间。默认为 SYNC_TO_DEVICE，这将应用在设备上配置的用户偏好。
对齐方式:
如何在边界框内对齐文本。默认值为“START”。
pivotX、pivotY
元素旋转的二维轴心点。这两个值都是浮点数，已缩放以适应范围 $[0, 1]$。
角度
元素应围绕其轴心点顺时针旋转的度数。
alpha（透明度）
设置此元素应具有的透明度级别。0 值表示元素应完全透明。255 值表示元素应完全不透明。
tintColor（色调颜色）
将色调颜色滤镜应用于元素。必须使用 ARGB 格式（#ff000000 = 不透明黑色）或 RGB 格式（#000000 = 黑色）指定颜色。

内部元素

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

变体
允许在 Wear OS 设备处于环境模式时更改此元素的属性。更多信息可在Variant 参考中找到。
位图字体
用于渲染时间的位图字体。
字体
用于渲染时间的字体。