DigitalClock

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 of 255 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, or ALL.

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.