TimeText

Ein Zeittext ist ein formatierter String, der die aktuelle Uhrzeit darstellt.

Eingeführt 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" />

Merkmale

Das TimeText-Element hat die folgenden Attribute:

Erforderliche Attribute

Die folgenden Attribute sind erforderlich:

format

Ein Formatstring, der das Zeitformat darstellt.

Diese Liste enthält verschiedene Formate zur Anzeige der Uhrzeit 12:34:56 Uhr:

  • hh:mm:ss wird als „12:34:56“ gerendert.
  • h:mm wird als „12:34“ gerendert
  • hh_10 wird als „1“ gerendert.
  • hh_1 wird als „2“ gerendert.
  • m wird als „34“ gerendert
  • mm_10 wird als „3“ gerendert.
  • mm_1 wird als „4“ gerendert.
  • ss wird als „56“ gerendert
  • ss_10 wird als „5“ gerendert.
  • ss_1 wird als „6“ gerendert.
x, y, width, height

Eine Sammlung von Ganzzahlen, die die Größe und Position des Elements angeben.

Optionale Attribute

Die folgenden Attribute sind optional:

hourFormat
Gibt an, ob die Uhrzeit im 12- oder 24-Stunden-Format angezeigt werden soll. Die Standardeinstellung ist SYNC_TO_DEVICE. Dadurch wird die auf dem Gerät konfigurierte Einstellung des Nutzers angewendet.
align:
Wie Sie den Text innerhalb des Begrenzungsrahmens ausrichten. Die Standardeinstellung ist „START“.
pivotX, pivotY
Ein zweidimensionaler Drehpunkt, um den sich das Element dreht. Beide Werte sind Gleitkommazahlen, die so skaliert werden, dass sie in den Bereich $ [0, 1] $ passen.
angle
Eine Anzahl von Grad im Uhrzeigersinn, um die das Element um seinen Drehpunkt gedreht werden soll.
alpha
Legen Sie fest, wie transparent dieses Element sein soll. Der Wert 0 gibt an, dass das Element vollständig transparent sein soll. Der Wert 255 gibt an, dass das Element vollständig deckend sein soll.
tintColor
Wenden Sie einen Farbfilter auf das Element an. Sie müssen die Farbe im ARGB-Format (#ff000000 = opakes Schwarz) oder RGB-Format (#000000 = Schwarz) angeben.

Innere Elemente

Das TimeText-Element kann die folgenden Elemente im Inneren enthalten:

Variant
Ermöglicht das Ändern von Attributen dieses Elements, wenn sich das Wear OS-Gerät im Inaktivmodus befindet. Weitere Informationen finden Sie in der Referenz zu Variant.
BitmapFont
Ein BitmapFont zum Rendern der Uhrzeit.
Font
Eine Schriftart, die zum Rendern der Uhrzeit verwendet werden soll.