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 zwischen0
und999
. SECOND
- Ein ganzzahliger Wert, der das zweite Feld eines
ZonedDateTime
-Objekts für die aktuelle Uhrzeit darstellt. Dieser Wert liegt immer zwischen0
und59
. 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 zwischen00
und59
. SECOND_MILLISECOND
- Ein Gleitkommawert, der das zweite Feld und die Millisekunde eines
ZonedDateTime
-Objekts kombiniert, das die aktuelle Zeit darstellt. Dieser Wert liegt immer zwischen0.0
und59.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
undSECOND
. Dieser Wert liegt immer zwischen0
und86399
(24 $ × 60 × 60 – 1 $). MINUTE
- Ein Ganzzahlwert, der das Minutenfeld eines
ZonedDateTime
-Objekts für die aktuelle Uhrzeit darstellt. Dieser Wert liegt immer zwischen0
und59
. 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 zwischen00
und59
. MINUTE_SECOND
- Ein Gleitkommawert, der die Minuten- und Sekundenfelder eines
ZonedDateTime
-Objekts kombiniert, das die aktuelle Zeit darstellt. Dieser Wert liegt immer zwischen0.0
und 59 \frac{59}{60} $ (einschließlich). HOUR_0_11
- Die 12-Stunden-Komponente der aktuellen Uhrzeit, dargestellt als Wert zwischen
0
und11
(jeweils einschließlich). Wenn der aktuelleCLOCK_HOUR_OF_AMPM
12
ist (z. B. in12:34 PM
), wird dieser Wert in0
umgewandelt. HOUR_0_11_Z
- Ein String, der die 12-Stunden-Komponente der aktuellen Uhrzeit (von
00
bis einschließlich11
) unter Verwendung der aktuellen Zeitzone des Wear OS-Geräts darstellt. Wenn dieser Wert kleiner als10
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 einesZonedDateTime
-Objekts kombiniert, das die aktuelle Zeit darstellt. Dieser Wert liegt immer zwischen0.0
und 11 \frac{59}{60} $ (jeweils einschließlich). HOUR_1_12
- Die 12-Stunden-Komponente der aktuellen Uhrzeit, dargestellt als Wert zwischen
1
und12
(jeweils einschließlich). Wenn der aktuelleHOUR_OF_DAY
0
ist, z. B. in0:12
(00:12 Uhr), wird dieser Wert in12
umgewandelt. HOUR_1_12_Z
- Ein String, der die 12-Stunden-Komponente der aktuellen Uhrzeit (von
01
bis einschließlich12
) unter Verwendung der aktuellen Zeitzone des Wear OS-Geräts darstellt. Wenn dieser Wert kleiner als10
ist, enthält er eine führende Null. HOUR_1_12_MINUTE
- Ein Gleitkommawert, der die Felder
CLOCK_HOUR_OF_AMPM
und Minuten einesZonedDateTime
-Objekts kombiniert, das die aktuelle Zeit darstellt. Dieser Wert liegt immer zwischen1.0
und 12 \frac{59}{60} $ (jeweils einschließlich). HOUR_0_23
- Die 24-Stunden-Komponente der aktuellen Uhrzeit, dargestellt als Wert zwischen
0
und23
(jeweils einschließlich). Wenn der Wert24
ist, z. B. in24:13
(00:13 Uhr am nächsten Tag), wird dieser Wert in0
umgewandelt. HOUR_0_23_Z
- Ein String, der die 24-Stunden-Komponente der aktuellen Uhrzeit (von
00
bis einschließlich23
) anhand der aktuellen Zeitzone des Wear OS-Geräts darstellt. Wenn dieser Wert kleiner als10
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 zwischen0.0
und 23 \frac{59}{60} $ (einschließlich). HOUR_1_24
- Die 24-Stunden-Komponente der aktuellen Uhrzeit, dargestellt als Wert zwischen
1
und24
(jeweils einschließlich). Wenn der Wert0
ist, z. B. in0:12
(00:12 Uhr), wird dieser Wert in24
umgewandelt. HOUR_1_24_Z
- Ein String, der die 12-Stunden-Komponente der aktuellen Uhrzeit (von
01
bis einschließlich24
) unter Verwendung der aktuellen Zeitzone des Wear OS-Geräts darstellt. Wenn dieser Wert kleiner als10
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 zwischen1.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 zwischen1
und31
. 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 zwischen01
und31
. 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 zwischen1.0
und 31 $ \frac{23}{24} $ (jeweils einschließlich). DAY_0_30
- Eine modifizierte Version des
getDayOfMonth()
-Werts einesZonedDateTime
-Objekts, der das aktuelle Datum darstellt, subtrahiert von 1. Dieser Wert liegt immer zwischen0
und30
. 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 zwischen0.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
und366
(jeweils einschließlich) und hat in Nicht-Schaltjahren den Höchstwert365
. DAY_OF_WEEK
- Eine geänderte Version des Werts
getDayOfWeek()
aus einemZonedDateTime
-Objekt, das das aktuelle Datum darstellt. Das Zifferblattformat weist den Wert1
für den Sonntag und den Wert7
für den Samstag zu. DAY_OF_WEEK_F
- Der aktuelle Wochentag, dargestellt als String in voller Länge. Beispiele hierfür sind
Sunday
undMonday
. DAY_OF_WEEK_S
- Der aktuelle Wochentag, als gekürzter String dargestellt. Beispiele hierfür sind
Sun
undMon
. MONTH
- Ein ganzzahliger Wert, der das Monatsfeld eines
ZonedDateTime
-Objekts für das aktuelle Datum darstellt. Dieser Wert liegt immer zwischen1
und12
. 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 zwischen01
und12
. MONTH_F
- Der aktuelle Monat des Jahres, dargestellt als String in voller Länge. Beispiele hierfür sind
January
undDecember
. MONTH_S
- Der aktuelle Monat des Jahres, dargestellt als gekürzter String. Beispiele hierfür sind
Jan
undDec
. DAYS_IN_MONTH
- Die Anzahl der Tage im aktuellen Monat. Im Februar ist dieser Wert entweder
28
oder29
, im April, Juni, September und November30
und im gregorianischen Kalender31
. 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 zwischen1.0
und 12 \frac{29}{30} $ (jeweils einschließlich). MONTH_0_11
- Eine geänderte Version des Werts
getMonthValue()
aus einemZonedDateTime
-Objekt, das das aktuelle Datum darstellt. Dieser Wert weist dem Januar den Wert0
und dem Dezember den Wert11
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 zwischen0.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 zwischen1902
und2100
(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 als2023.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 als2023.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
einesChronoField
-Objekts darstellt, das das aktuelle Datum darstellt. Dieser Wert liegt immer zwischen0
und5
. WEEK_IN_YEAR
- Eine Ganzzahl, die den Wert des
ALIGNED_WEEK_OF_YEAR
einesChronoField
-Objekts darstellt, das das aktuelle Datum darstellt. Dieser Wert liegt immer zwischen1
und53
. 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 dasTimeZone
-Objekt für die aktuelle Sprache und der Übergabe einesDate
-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()
imTimeZone
-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 ObjektTimeZone
für die aktuelle Sprache entspricht, wobei der angegebene StilSHORT
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 dasTimeZone
-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()
imTimeZone
-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()
imTimeZone
-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 und1
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
und28
. MOON_PHASE_TYPE
Eine Ganzzahl, die die aktuelle Mondphase codiert. Mögliche Werte sind:
0
für den letzten Neumond1
für eine abendliche Mondsichel2
für einen Mond im ersten Viertel3
für einen zunehmenden Dreiviertelmond4
für Vollmond5
für abnehmenden Dreiviertelmond6
für einen Mond im letzten Viertel7
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
und100
. HEART_RATE
- Die aktuelle Herzfrequenz des Nutzers gemäß den Wear OS-Gerätesensoren. Dieser Wert liegt immer zwischen
0
und240
. 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 Wert00
.
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
undACCELEROMETER_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 von0
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.
Empfehlungen für dich
- Hinweis: Der Linktext wird angezeigt, wenn JavaScript deaktiviert ist.
- ArithmeticExpression
- Synthetische Daten für Gesundheitsdienste verwenden
- ListConfiguration (Listenkonfiguration)