Quelltyp

Wert einer Datenquelle, durch den ein Echtzeitwert aktualisiert wird, der auf dem Zifferblatt angezeigt wird.

Eingeführt in Wear OS 4.

Uhrzeit und Tag

Das Watch Face-Format unterstützt die folgenden Datenquellen zu Uhrzeit und Tag:

UTC_TIMESTAMP
Die Anzahl der Millisekunden, die seit Mitternacht UTC am 1. Januar 1970 vergangen sind.
MILLISECOND
Ein ganzzahliger Wert, der das Millisekundenfeld eines ZonedDateTime-Objekts für die aktuelle Zeit darstellt. Dieser Wert liegt immer zwischen 0 und 999.
SECOND
Ein ganzzahliger Wert, der das zweite Feld eines ZonedDateTime-Objekts für die aktuelle Uhrzeit darstellt. Dieser Wert liegt immer zwischen 0 und 59.
SECOND_Z
Ein String, der das zweite Feld eines ZonedDateTime-Objekts für die aktuelle Zeit mit führenden Nullen darstellt, um den Wert 2 Zeichen lang zu machen. Dieser Wert liegt immer zwischen 00 und 59.
SECOND_MILLISECOND
Ein Gleitkommawert, der das zweite Feld und die Millisekunde eines ZonedDateTime-Objekts kombiniert, das die aktuelle Zeit darstellt. Dieser Wert liegt immer zwischen 0.0 und 59.999.
SECONDS_IN_DAY
Die Anzahl der Sekunden, die im Laufe des aktuellen Tages vergangen sind, basierend auf den Werten für HOUR_0_23, MINUTE und SECOND. Dieser Wert liegt immer zwischen 0 und 86399 (24 $ × 60 × 60 – 1 $).
MINUTE
Ein Ganzzahlwert, der das Minutenfeld eines ZonedDateTime-Objekts für die aktuelle Uhrzeit darstellt. Dieser Wert liegt immer zwischen 0 und 59.
MINUTE_Z
Ein Stringwert, der das Minutenfeld eines ZonedDateTime-Objekts für die aktuelle Uhrzeit mit führenden Nullen darstellt, um den Wert 2 Zeichen lang zu machen. Dieser Wert liegt immer zwischen 00 und 59.
MINUTE_SECOND
Ein Gleitkommawert, der die Minuten- und Sekundenfelder eines ZonedDateTime-Objekts kombiniert, das die aktuelle Zeit darstellt. Dieser Wert liegt immer zwischen 0.0 und 59 \frac{59}{60} $ (einschließlich).
HOUR_0_11
Die 12-Stunden-Komponente der aktuellen Uhrzeit, dargestellt als Wert zwischen 0 und 11 (jeweils einschließlich). Wenn der aktuelle CLOCK_HOUR_OF_AMPM 12 ist (z. B. in 12:34 PM), wird dieser Wert in 0 umgewandelt.
HOUR_0_11_Z
Ein String, der die 12-Stunden-Komponente der aktuellen Uhrzeit (von 00 bis einschließlich 11) unter Verwendung der aktuellen Zeitzone des Wear OS-Geräts darstellt. Wenn dieser Wert kleiner als 10 ist, enthält er eine führende Null.
HOUR_0_11_MINUTE
Ein Gleitkommawert, der ein geändertes CLOCK_HOUR_OF_AMPM-Feld und ein Minutenfeld eines ZonedDateTime-Objekts kombiniert, das die aktuelle Zeit darstellt. Dieser Wert liegt immer zwischen 0.0 und 11 \frac{59}{60} $ (jeweils einschließlich).
HOUR_1_12
Die 12-Stunden-Komponente der aktuellen Uhrzeit, dargestellt als Wert zwischen 1 und 12 (jeweils einschließlich). Wenn der aktuelle HOUR_OF_DAY 0 ist, z. B. in 0:12 (00:12 Uhr), wird dieser Wert in 12 umgewandelt.
HOUR_1_12_Z
Ein String, der die 12-Stunden-Komponente der aktuellen Uhrzeit (von 01 bis einschließlich 12) unter Verwendung der aktuellen Zeitzone des Wear OS-Geräts darstellt. Wenn dieser Wert kleiner als 10 ist, enthält er eine führende Null.
HOUR_1_12_MINUTE
Ein Gleitkommawert, der die Felder CLOCK_HOUR_OF_AMPM und Minuten eines ZonedDateTime-Objekts kombiniert, das die aktuelle Zeit darstellt. Dieser Wert liegt immer zwischen 1.0 und 12 \frac{59}{60} $ (jeweils einschließlich).
HOUR_0_23
Die 24-Stunden-Komponente der aktuellen Uhrzeit, dargestellt als Wert zwischen 0 und 23 (jeweils einschließlich). Wenn der Wert 24 ist, z. B. in 24:13 (00:13 Uhr am nächsten Tag), wird dieser Wert in 0 umgewandelt.
HOUR_0_23_Z
Ein String, der die 24-Stunden-Komponente der aktuellen Uhrzeit (von 00 bis einschließlich 23) anhand der aktuellen Zeitzone des Wear OS-Geräts darstellt. Wenn dieser Wert kleiner als 10 ist, enthält er eine führende Null.
HOUR_0_23_MINUTE
Ein Gleitkommawert, der die Stunden- und Minutenfelder eines ZonedDateTime-Objekts kombiniert, das die aktuelle Zeit darstellt. Dieser Wert liegt immer zwischen 0.0 und 23 \frac{59}{60} $ (einschließlich).
HOUR_1_24
Die 24-Stunden-Komponente der aktuellen Uhrzeit, dargestellt als Wert zwischen 1 und 24 (jeweils einschließlich). Wenn der Wert 0 ist, z. B. in 0:12 (00:12 Uhr), wird dieser Wert in 24 umgewandelt.
HOUR_1_24_Z
Ein String, der die 12-Stunden-Komponente der aktuellen Uhrzeit (von 01 bis einschließlich 24) unter Verwendung der aktuellen Zeitzone des Wear OS-Geräts darstellt. Wenn dieser Wert kleiner als 10 ist, enthält er eine führende Null.
HOUR_1_24_MINUTE
Ein Gleitkommawert, der ein geändertes Stunden- und Minutenfeld eines ZonedDateTime-Objekts kombiniert, das die aktuelle Zeit darstellt. Dieser Wert liegt immer zwischen 1.0 und 24 \frac{59}{60} $ (einschließlich).
DAY
Ein ganzzahliger Wert, der das Tagesfeld eines ZonedDateTime-Objekts für das aktuelle Datum darstellt. Dieser Wert liegt immer zwischen 1 und 31.
DAY_Z
Ein Stringwert, der das Tagesfeld eines ZonedDateTime-Objekts für das aktuelle Datum mit führenden Nullen darstellt, um den Wert 2 Zeichen lang zu machen. Dieser Wert liegt immer zwischen 01 und 31.
DAY_HOUR
Ein Gleitkommawert, der die Felder für Tag und Stunde eines ZonedDateTime-Objekts kombiniert, das das aktuelle Datum und die aktuelle Uhrzeit darstellt. Dieser Wert liegt immer zwischen 1.0 und 31 $ \frac{23}{24} $ (jeweils einschließlich).
DAY_0_30
Eine modifizierte Version des getDayOfMonth()-Werts eines ZonedDateTime-Objekts, der das aktuelle Datum darstellt, subtrahiert von 1. Dieser Wert liegt immer zwischen 0 und 30.
DAY_0_30_HOUR
Ein Gleitkommawert, der ein geändertes Feld für den Tag des Monats und das Stundenfeld eines ZonedDateTime-Objekts kombiniert, das das aktuelle Datum und die aktuelle Uhrzeit darstellt. Dieser Wert liegt immer zwischen 0.0 und 30 $ \frac{23}{24} $ (jeweils einschließlich).
DAY_OF_YEAR
Die Anzahl der Tage, die seit dem Kalenderjahr begonnen haben. Dieser Wert liegt immer zwischen 1 und 366 (jeweils einschließlich) und hat in Nicht-Schaltjahren den Höchstwert 365.
DAY_OF_WEEK
Eine geänderte Version des Werts getDayOfWeek() aus einem ZonedDateTime-Objekt, das das aktuelle Datum darstellt. Das Zifferblattformat weist den Wert 1 für den Sonntag und den Wert 7 für den Samstag zu.
DAY_OF_WEEK_F
Der aktuelle Wochentag, dargestellt als String in voller Länge. Beispiele hierfür sind Sunday und Monday.
DAY_OF_WEEK_S
Der aktuelle Wochentag, als gekürzter String dargestellt. Beispiele hierfür sind Sun und Mon.
MONTH
Ein ganzzahliger Wert, der das Monatsfeld eines ZonedDateTime-Objekts für das aktuelle Datum darstellt. Dieser Wert liegt immer zwischen 1 und 12.
MONTH_Z
Ein Stringwert, der das Monatsfeld eines ZonedDateTime-Objekts für das aktuelle Datum mit führenden Nullen darstellt, um den Wert 2 Zeichen lang zu machen. Dieser Wert liegt immer zwischen 01 und 12.
MONTH_F
Der aktuelle Monat des Jahres, dargestellt als String in voller Länge. Beispiele hierfür sind January und December.
MONTH_S
Der aktuelle Monat des Jahres, dargestellt als gekürzter String. Beispiele hierfür sind Jan und Dec.
DAYS_IN_MONTH
Die Anzahl der Tage im aktuellen Monat. Im Februar ist dieser Wert entweder 28 oder 29, im April, Juni, September und November 30 und im gregorianischen Kalender 31.
MONTH_DAY
Ein Gleitkommawert, der das Feld für den Monat des Jahres und das geänderte Feld für den Tag des Monats eines ZonedDateTime-Objekts kombiniert, das das aktuelle Datum darstellt. Dieser Wert liegt immer zwischen 1.0 und 12 \frac{29}{30} $ (jeweils einschließlich).
MONTH_0_11
Eine geänderte Version des Werts getMonthValue() aus einem ZonedDateTime-Objekt, das das aktuelle Datum darstellt. Dieser Wert weist dem Januar den Wert 0 und dem Dezember den Wert 11 zu.
MONTH_0_11_DAY
Ein Gleitkommawert, der ein geändertes Feld für den Monat des Jahres und ein geändertes Feld für den Tag des Monats eines ZonedDateTime-Objekts kombiniert, das das aktuelle Datum darstellt. Dieser Wert liegt immer zwischen 0.0 und 11 \frac{29}{30} $ (jeweils einschließlich).
YEAR
Ein ganzzahliger Wert, der das Jahrfeld eines ZonedDateTime-Objekts für das aktuelle Datum darstellt. Der Wert muss immer zwischen 1902 und 2100 (einschließlich) liegen.
YEAR_S
Eine zweistellige Ganzzahl, die die letzten beiden Ziffern des aktuellen Jahres darstellt. Der Wert für 2023 ist beispielsweise 23.
YEAR_MONTH
Ein Gleitkommawert, der das Feld „Jahr“ und das geänderte Feld für den Tag des Monats eines ZonedDateTime-Objekts kombiniert, das das aktuelle Datum darstellt. Januar 2023 wird als 2023.0 und Dezember 2023 als $ 2023 \frac {11}{12} $ dargestellt.
YEAR_MONTH_DAY
Ein Gleitkommawert, der das Jahresfeld, ein geändertes Feld für den Monat des Jahres und ein geändertes Feld für den Tag des Monats eines ZonedDateTime-Objekts kombiniert, das das aktuelle Datum darstellt. Der 1. Januar 2023 wird als 2023.0 und der 31. Dezember 2023 als $ 2023 \frac{11 \frac{29}{30}}{12} \ ca. 2023,9972 $ dargestellt.
WEEK_IN_MONTH
Eine Ganzzahl, die den Wert des ALIGNED_WEEK_OF_MONTH eines ChronoField-Objekts darstellt, das das aktuelle Datum darstellt. Dieser Wert liegt immer zwischen 0 und 5.
WEEK_IN_YEAR
Eine Ganzzahl, die den Wert des ALIGNED_WEEK_OF_YEAR eines ChronoField-Objekts darstellt, das das aktuelle Datum darstellt. Dieser Wert liegt immer zwischen 1 und 53.
IS_24_HOUR_MODE
Ein boolescher Wert, der dem aktuellen Rückgabewert von is24HourFormat() basierend auf der vom Nutzer gewählten Sprache und Einstellungen entspricht.
IS_DAYLIGHT_SAVING_TIME
Ein boolescher Wert, der dem Aufrufen von inDaylightTime() für das TimeZone-Objekt für die aktuelle Sprache und der Übergabe eines Date-Objekts entspricht, das die aktuelle Uhrzeit enthält. Gibt an, ob in der aktuell eingestellten Zeitzone jetzt die Sommerzeit berücksichtigt wird.
TIMEZONE
Ein String, der dem Aufrufen von getDisplayName() im TimeZone-Objekt für die aktuelle Sprache entspricht. Gibt den vollständigen Zeitzonennamen zurück, z. B. „Eastern Standard Time“ für die Zeitzone von New York City im Winter.
TIMEZONE_ABB
Ein String, der dem Aufrufen einer überlasteten Version von getDisplayName() im Objekt TimeZone für die aktuelle Sprache entspricht, wobei der angegebene Stil SHORT ist. Gibt einen abgekürzten Zeitzonennamen zurück, z. B. „EST“ für die Zeitzone von New York City im Winter.
TIMEZONE_ID
Ein String, der dem Aufruf von getId() für das TimeZone-Objekt für die aktuelle Sprache entspricht. Gibt einen IANA-Zeitzonen-ID-Wert zurück, z. B. America/New_York für die Zeitzone von New York City.
TIMEZONE_OFFSET
Ein String, der dem Aufrufen von getRawOffset() im TimeZone-Objekt für die aktuelle Sprache entspricht. Dieser Wert liegt immer zwischen -12 und +14. Gibt den Wert zurück, der zu UTC hinzugefügt werden sollte, um die Standardzeit für die aktuelle Zeitzone zu erhalten (nicht durch die Sommerzeit korrigiert).
TIMEZONE_OFFSET_DST
Ein String, der der Übergabe des aktuellen Datums an getOffset() im TimeZone-Objekt für die aktuelle Sprache entspricht. Dieser Wert liegt immer zwischen -12 und +14. Gibt den Wert zurück, der zu UTC addiert werden sollte, um die aktuelle Ortszeit zu erhalten, wobei gegebenenfalls die Sommerzeit berücksichtigt wird.
AMPM_STATE
Eine Ganzzahl, die angibt, ob die aktuelle Zeit vor 12:00 Uhr, mittags oder später liegt. Mögliche Werte sind 0 für AM und 1 für PM.
AMPM_POSITION

Eine Ganzzahl, die angibt, wo der AM- oder PM-Indikator innerhalb eines Zeitstrings erscheinen soll. Enthält einen der folgenden Werte:

  • 0 bedeutet, dass AM oder PM am Anfang des Strings stehen soll, z. B. AM 12:03.
  • 1 bedeutet, dass AM oder PM am Ende des Strings stehen soll, z. B. 12:03 AM.
  • -1 bedeutet, dass nicht bekannt ist, wo AM oder PM im String stehen soll.
AMPM_STRING

Ein 2-stelliger String, der den AM- oder PM-Status der aktuellen Uhrzeit angibt. Der Wert ist entweder „AM“ oder „PM“.

Mondphase

Das Watch Face-Format unterstützt die folgenden Datenquellen zur Mondphase:

MOON_PHASE_POSITION
Ein ganzzahliger Wert, der die Anzahl der Tage angibt, die seit dem letzten Neumond begonnen haben. Dieser Wert liegt immer zwischen 0 und 28.
MOON_PHASE_TYPE

Eine Ganzzahl, die die aktuelle Mondphase codiert. Mögliche Werte sind:

  • 0 für den letzten Neumond
  • 1 für eine abendliche Mondsichel
  • 2 für einen Mond im ersten Viertel
  • 3 für einen zunehmenden Dreiviertelmond
  • 4 für Vollmond
  • 5 für abnehmenden Dreiviertelmond
  • 6 für einen Mond im letzten Viertel
  • 7 für eine Mondsichel morgens
MOON_PHASE_TYPE_STRING

Ein String, der die aktuelle Mondphase darstellt. Mögliche Werte sind:

  • Neumond, wenn seit dem letzten Neumond weniger als 0, 5 Tage vergangen sind oder mehr als 27, 5 Tage vergangen sind.
  • Abendmond: Seit dem letzten Neumond sind mindestens 0,5 Tage, aber weniger als 6,5 Tage vergangen.
  • Erstes Quartal: Seit dem letzten Neumond sind mindestens 6,5, aber weniger als 7,5 Tage vergangen.
  • Zunehmender Dreiviertelmond: Seit dem letzten Neumond sind mindestens 7,5 Tage, aber weniger als 13,5 Tage vergangen.
  • Vollmond: Seit dem letzten Neumond sind mindestens 13,5 Tage, aber weniger als 14,5 Tage vergangen.
  • Abnehmender Gibbous: Seit dem letzten Neumond sind mindestens 14,5 Tage, aber weniger als 20,5 Tage vergangen.
  • Letztes Quartal: Seit dem letzten Neumond sind mindestens 20,5 Tage, aber weniger als 21,5 Tage vergangen.
  • Morgenmond: Seit dem letzten Neumond sind mindestens 21,5 Tage, aber weniger als 27,5 Tage vergangen.

Sprache

Das Watch Face-Format unterstützt die folgenden Datenquellen in Bezug auf die Sprache des Nutzers:

LANGUAGE_LOCALE_NAME
Ein String, der die aktuelle Sprache des Wear OS-Geräts angibt, ausgedrückt als zweistelliger ISO 639-1-Sprachcode, Unterstrich und zweistelliger ISO 3166-1-Regionscode. Die US-amerikanische Variante des Englischen wird als en_US dargestellt.

Gesundheitsdaten

Das Watch Face-Format unterstützt die folgenden Datenquellen zu den Gesundheitsdaten des Nutzers:

STEP_COUNT
Die Anzahl der Schritte, die der Nutzer bislang bisher gemacht hat, laut den Wear OS-Gerätesensoren.
STEP_GOAL
Die Anzahl der Schritte, die der Nutzer als tägliches Schrittziel ausgewählt hat. Dieser Wert ist nie kleiner als 1000.
STEP_PERCENT
Eine Ganzzahl, die den Fortschritt des Nutzers in Bezug auf sein heutiges Schrittziel angibt, ausgedrückt als gerundeter Prozentsatz. Dieser Wert liegt immer zwischen 0 und 100.
HEART_RATE
Die aktuelle Herzfrequenz des Nutzers gemäß den Wear OS-Gerätesensoren. Dieser Wert liegt immer zwischen 0 und 240.
HEART_RATE_Z
Ein String, der laut den Wear OS-Gerätesensoren die aktuelle Herzfrequenz des Nutzers darstellt. Dieser Wert wird nach Bedarf mit Nullen auf der linken Seite aufgefüllt, um den Wert mindestens 2 Zeichen lang zu machen. Wenn die Herzfrequenz des Nutzers mit 65 gemessen wird, beträgt dieser Wert 65. Wenn die Herzfrequenz des Nutzers mit 0 gemessen wird, ist dieser Wert 00.

Gerätesensoren

Das Watch Face-Format unterstützt die folgenden Datenquellen zu den Sensoren des Geräts:

ACCELEROMETER_IS_SUPPORTED
Boolescher Wert, der angibt, ob das Zifferblatt Daten des Beschleunigungsmessers von den Sensoren des aktuellen Wear OS-Geräts abrufen kann.
ACCELEROMETER_X
Ein Gleitkommawert, der die aktuelle lineare Beschleunigung entlang der x-Achse gemäß dem Beschleunigungsmesser des Wear OS-Geräts angibt. Positive Werte geben an, dass das Wear OS-Gerät nach rechts beschleunigt, wenn das Zifferblatt auf den Himmel oder die Decke zeigt.
ACCELEROMETER_Y
Ein Gleitkommawert, der die aktuelle lineare Beschleunigung entlang der Y-Achse gemäß Beschleunigungsmesser des Wear OS-Geräts angibt. Positive Werte geben an, dass das Wear OS-Gerät, wenn das Zifferblatt auf den Himmel oder die Decke zeigt, in 12-Uhr-Richtung (oben) auf dem Zifferblatt beschleunigt wird.
ACCELEROMETER_Z

Ein Gleitkommawert, der die aktuelle lineare Beschleunigung gemäß dem Beschleunigungsmesser des Wear OS-Geräts entlang der z-Achse angibt. Positive Werte geben an, dass das Wear OS-Gerät in Richtung Himmel oder Decke beschleunigt wird, wenn das Zifferblatt auf den Himmel oder die Decke zeigt.

ACCELEROMETER_ANGLE_X

Ein Gleitkommawert, der die aktuelle Winkelbeschleunigung in Grad relativ zur x-Achse angibt. Dieser Wert liegt immer im Bereich [-90.0, 90.0 $].

ACCELEROMETER_ANGLE_Y

Ein Gleitkommawert, der die aktuelle Winkelbeschleunigung in Grad relativ zur Y-Achse angibt. Dieser Wert liegt immer im Bereich [-90.0, 90.0 $].

ACCELEROMETER_ANGLE_Z

Ein Gleitkommawert, der die aktuelle Winkelbeschleunigung in Grad relativ zur z-Achse angibt. Dieser Wert liegt immer im Bereich [-90.0, 90.0 $].

ACCELEROMETER_ANGLE_XY

Ein Gleitkommawert, der die Summe von ACCELEROMETER_ANGLE_X und ACCELEROMETER_ANGLE_Y ist.

Akku des Geräts

Das Watch Face-Format unterstützt die folgenden Datenquellen zum aktuellen Akkustatus des Geräts:

BATTERY_PERCENT
Eine Ganzzahl, die den aktuellen Akkustand des Wear OS-Geräts in Prozent angibt. Ein Wert von 100 bedeutet, dass der Akku voll ist, ein Wert von 0 bedeutet, dass der Akkustand kritisch niedrig ist.
BATTERY_CHARGING_STATUS
Ein boolescher Wert, der angibt, ob der Akku des Wear OS-Geräts geladen wird. Wenn der Akku vollständig aufgeladen wurde, ist dieser Wert true.
BATTERY_IS_LOW
Ein boolescher Wert, der angibt, ob der Akkustand des Wear OS-Geräts niedrig ist. Der genaue Grenzwert hängt vom Hersteller ab. Wenn der Akku geladen wird, ist dieser Wert false.
BATTERY_TEMPERATURE_CELSIUS
Ein Gleitkommawert, der die Temperatur des Akkus des Wear OS-Geräts in Grad Celsius angibt. Der Wert der Rohtemperatur des Akkus in Zehntel Grad Celsius wird durch 10 geteilt, um diesen Wert zu erhalten.
BATTERY_TEMPERATURE_FAHRENHEIT
Ein Gleitkommawert, der die Temperatur des Akkus des Wear OS-Geräts in Grad Fahrenheit angibt. Das ist die Umrechnung von Grad Celsius.

Benachrichtigungen

Das Watch Face-Format unterstützt die folgenden Datenquellen für die Benachrichtigungen des Geräts:

UNREAD_NOTIFICATION_COUNT
Ein String, der die Anzahl der an dieses Wear OS-Gerät gesendeten Benachrichtigungen darstellt, die der Nutzer noch nicht gelesen hat.