A digital clock is a container for a formatted set of strings that represent the current hours, minutes, and seconds associated with a clock time.
Introduced in Wear OS 4.
Syntax
<DigitalClock x="integer" y="integer" width="integer" height="integer" pivotX="float" pivotY="float" angle="float-degrees" alpha="integer" scaleX="float" scaleY="float" renderMode="[SOURCE | MASK | ALL]" tintColor="argb-color | rgb-color"> <!-- This is the only required inner element. --> <TimeText ... /> </DigitalClock>
Attributes
The DigitalClock
element has the following attributes:
Required attributes
The following attributes are required:
x
, y
, width
, height
Optional attributes
- The following attributes are optional:
- 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. scaleX
- The horizontal scaling factor to apply to this element.
scaleY
- The vertical scaling factor to apply to this element.
renderMode
- The element's render mode type. Possible values are:
SOURCE
(default),MASK
, orALL
. 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 DigitalClock
element can contain the following inner elements:
TimeText
A collection of formatted strings to show the hours, minutes, and seconds associated with a current clock time.
Localization
- Provides a hint for the locale to use when rendering the time. More
information is available in the
Localization
reference.
A DigitalClock
element can contain at most one Localization
element.
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.