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

必需属性

以下属性是必需的

格式

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

此列表包含几种显示时间 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 参考。
位图字体
要用于呈现时间的 BitmapFont。
字体
要用于呈现时间的 Font。