A time text is a formatted string representing the current time.
Introduced in Wear OS 4.
Syntax
<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" />
Attributes
The TimeText
element has the following attributes:
format
A format string representing the time format.
This list includes several different formats for showing the time 9:01:05 AM:
hh:mm:ss
renders as "09:01:05".h:mm
renders as "9:01"ss
renders as "05"m
renders as "1"
hourFormat
Whether to use 12- or 24-hour notation to display the time. Defaults to
SYNC_TO_DEVICE
, which applies the user's preference that's configured on the device.align
:How to align the text within the bounding box. Defaults to "START".
x
,y
,width
,height
A collection of integers that specify the element's size and position.
pivotX
,pivotY
A two-dimensional pivot point about which the element rotates. Both values are floating-point numbers that are scaled to fit in the range $ [0, 1] $.
angle
A number of degrees, clockwise, that the element should be rotated about its pivot point.
alpha
Set the level of transparency that this element should have. A value of
0
indicates that the element should be completely transparent. A value of255
indicates that the element should be completely opaque.tintColor
Apply a tint color filter to the element. You must specify the color using either the ARGB format (
#ff000000
= opaque black) or the RGB format (#000000
= black).
Inner elements
The TimeText
element can contain the following inner elements:
Variant
- Allows for changing attributes of this element when the Wear OS device is in
ambient mode. More information is available in the
Variant
reference. BitmapFont
- A BitmapFont to use for rendering the time.
Font
- A Font to use for rendering the time.
Recommended for you
- Note: link text is displayed when JavaScript is off
- DigitalClock
- PartText
- PartDraw