Typ źródła

Wartość źródła danych, która aktualizuje wartość w czasie rzeczywistym widoczną na tarczy zegarka.

Wprowadzona w Wear OS 4.

Data i godzina

Format tarczy zegarka obsługuje te źródła danych związane z godziną i dniem:

UTC_TIMESTAMP
Liczba milisekund, które upłynęły od północy czasu UTC 1 stycznia 1970 r.
MILLISECOND
Wartość całkowita reprezentująca pole milisekundowe obiektu ZonedDateTime w bieżącym czasie. Ta wartość mieści się zawsze z zakresu od 0 do 999 włącznie.
SECOND
Wartość całkowita określająca drugie pole obiektu ZonedDateTime dla bieżącego czasu. Ta wartość zawsze mieści się w przedziale od 0 do 59.
SECOND_Z
Ciąg znaków reprezentujący drugie pole obiektu ZonedDateTime na bieżący czas. Zera na początku składają się z 2 znaków. Ta wartość mieści się zawsze w przedziale od 00 do 59 włącznie.
SECOND_MILLISECOND
Wartość zmiennoprzecinkowa, która łączy pola drugie i milisekundy obiektu ZonedDateTime, który reprezentuje bieżący czas. Ta wartość mieści się zawsze z zakresu od 0.0 do 59.999 włącznie.
SECONDS_IN_DAY
Liczba sekund, które upłynęły w ciągu bieżącego dnia, na podstawie wartości HOUR_0_23, MINUTE i SECOND. Ta wartość mieści się zawsze z zakresu 0–86399 (24 USD * 60 * 60 – 1 $) włącznie.
MINUTE
Liczba całkowita określająca pole minutowe obiektu ZonedDateTime dla bieżącego czasu. Ta wartość zawsze mieści się w przedziale od 0 do 59.
MINUTE_Z
Wartość ciągu znaków reprezentująca pole minutowe obiektu ZonedDateTime na bieżący czas, z zerem na początku tak, by składała się z 2 znaków. Ta wartość mieści się zawsze w przedziale od 00 do 59 włącznie.
MINUTE_SECOND
Wartość zmiennoprzecinkowa, która łączy pola minutowe i sekundy obiektu ZonedDateTime, który reprezentuje bieżący czas. Ta wartość zawsze mieści się w przedziale od 0.0 do 59 USD \frac{59}{60} USD włącznie.
HOUR_0_11
Składnik 12-godzinny bieżącego czasu, wyrażony jako wartość z zakresu od 0 do 11 włącznie. Jeśli bieżąca wartość CLOCK_HOUR_OF_AMPM to 12, np. 12:34 PM, ta wartość jest konwertowana na 0.
HOUR_0_11_Z
Ciąg reprezentujący 12-godzinny składnik bieżącego czasu – od 00 do 11 włącznie – z użyciem bieżącej strefy czasowej urządzenia z Wear OS. Jeśli ta wartość jest mniejsza niż 10, zawiera na początku zero.
HOUR_0_11_MINUTE
Wartość zmiennoprzecinkowa stanowi połączenie zmodyfikowanego pola CLOCK_HOUR_OF_AMPM i pola minutowego obiektu ZonedDateTime, który reprezentuje bieżący czas. Ta wartość zawsze mieści się w zakresie od 0.0 do 11 USD \frac{59}{60} USD włącznie.
HOUR_1_12
Składnik 12-godzinny bieżącego czasu, wyrażony jako wartość z zakresu od 1 do 12 włącznie. Jeśli bieżąca wartość HOUR_OF_DAY to 0, np. 0:12 (00:12), ta wartość jest konwertowana na 12.
HOUR_1_12_Z
Ciąg reprezentujący 12-godzinny składnik bieżącego czasu – od 01 do 12 włącznie – z użyciem bieżącej strefy czasowej urządzenia z Wear OS. Jeśli ta wartość jest mniejsza niż 10, zawiera na początku zero.
HOUR_1_12_MINUTE
Wartość zmiennoprzecinkowa łączy pola CLOCK_HOUR_OF_AMPM i minutowe obiektu ZonedDateTime, który reprezentuje bieżący czas. Ta wartość zawsze mieści się w przedziale od 1.0 do 12 USD \frac{59}{60} USD włącznie.
HOUR_0_23
Składnik 24-godzinny bieżącego czasu, wyrażony jako wartość z zakresu od 0 do 23 włącznie. Jeśli wartość to 24, np. 24:13 (o 00:13 następnego dnia), jest ona konwertowana na 0.
HOUR_0_23_Z
Ciąg znaków reprezentujący 24-godzinny składnik bieżącego czasu – od 00 do 23 włącznie – z użyciem bieżącej strefy czasowej urządzenia z Wear OS. Jeśli ta wartość jest mniejsza niż 10, zawiera na początku zero.
HOUR_0_23_MINUTE
Wartość zmiennoprzecinkowa łączy pola godzin i minut obiektu ZonedDateTime, który reprezentuje bieżący czas. Ta wartość zawsze mieści się w przedziale od 0.0 do 23 USD \frac{59}{60} USD włącznie.
HOUR_1_24
Składnik 24-godzinny bieżącego czasu, wyrażony jako wartość z zakresu od 1 do 24 włącznie. Jeśli wartość to 0, np. 0:12 (00:12), jest ona konwertowana na 24.
HOUR_1_24_Z
Ciąg reprezentujący 12-godzinny składnik bieżącego czasu – od 01 do 24 włącznie – z użyciem bieżącej strefy czasowej urządzenia z Wear OS. Jeśli ta wartość jest mniejsza niż 10, zawiera na początku zero.
HOUR_1_24_MINUTE
Wartość zmiennoprzecinkowa łączy zmodyfikowane pole godziny i pole minut w obiekcie ZonedDateTime, który reprezentuje bieżący czas. Ta wartość zawsze mieści się w przedziale od 1.0 do 24 USD \frac{59}{60} USD włącznie.
DAY
Liczba całkowita określająca pole dnia w obiekcie ZonedDateTime dla bieżącej daty. Ta wartość zawsze mieści się w przedziale od 1 do 31.
DAY_Z
Ciąg znaków reprezentujący pole dnia w obiekcie ZonedDateTime z bieżącego dnia; z początkowymi zerami tworzącymi wartość składającą się z 2 znaków. Ta wartość mieści się zawsze w przedziale od 01 do 31 włącznie.
DAY_HOUR
Wartość zmiennoprzecinkowa łącząca pola dnia miesiąca i godziny obiektu ZonedDateTime, który reprezentuje aktualną datę i godzinę. Ta wartość zawsze mieści się w zakresie od 1.0 do 31 USD \frac{23}{24} USD włącznie.
DAY_0_30
Zmodyfikowana wersja wartości getDayOfMonth() obiektu ZonedDateTime, która reprezentuje bieżącą datę, odjętą przez 1. Ta wartość mieści się zawsze z zakresu od 0 do 30 włącznie.
DAY_0_30_HOUR
Wartość zmiennoprzecinkowa łącząca zmodyfikowane pole dnia miesiąca i pole godziny obiektu ZonedDateTime, który reprezentuje aktualną datę i godzinę. Ta wartość zawsze mieści się w zakresie od 0.0 do 30 USD \frac{23}{24} USD włącznie.
DAY_OF_YEAR
Zmieniła się liczba dni, które rozpoczęły się od roku kalendarzowego. Ta wartość mieści się zawsze z zakresu od 1 do 366 włącznie, a w latach innych niż przestępne ma maksymalną wartość 365.
DAY_OF_WEEK
Zmodyfikowana wersja wartości getDayOfWeek() z obiektu ZonedDateTime, który reprezentuje bieżącą datę. Format tarczy zegarka przypisuje wartość 1 oznaczającą niedzielę i 7, która oznacza sobotę.
DAY_OF_WEEK_F
Bieżący dzień tygodnia w postaci ciągu znaków pełnej długości. Przykłady to Sunday i Monday.
DAY_OF_WEEK_S
Bieżący dzień tygodnia w postaci skróconego ciągu znaków. Przykłady to Sun i Mon.
MONTH
Liczba całkowita określająca pole miesiąca w obiekcie ZonedDateTime dla bieżącej daty. Ta wartość zawsze mieści się w przedziale od 1 do 12.
MONTH_Z
Wartość ciągu tekstowego reprezentująca pole miesiąca w obiekcie ZonedDateTime z bieżącą datą, zaczynając od zera tworzących 2 znaki. Ta wartość mieści się zawsze w przedziale od 01 do 12 włącznie.
MONTH_F
Bieżący miesiąc roku w postaci ciągu tekstowego o pełnej długości. Przykłady to January i December.
MONTH_S
Bieżący miesiąc roku w postaci skróconego ciągu znaków. Przykłady to Jan i Dec.
DAYS_IN_MONTH
Liczba dni w bieżącym miesiącu. Ta wartość wynosi 28 lub 29 w lutym, 30 w kwietniu, czerwcu, wrześniu i listopadzie oraz 31 w pozostałych miesiącach kalendarza gregoriańskiego.
MONTH_DAY
Wartość zmiennoprzecinkowa łącząca pole miesiąca roku i zmodyfikowane pole dnia miesiąca obiektu ZonedDateTime, który reprezentuje datę bieżącą. Ta wartość zawsze mieści się w zakresie od 1.0 do 12 USD \frac{29}{30} USD włącznie.
MONTH_0_11
Zmodyfikowana wersja wartości getMonthValue() z obiektu ZonedDateTime, który reprezentuje bieżącą datę. Ta wartość przypisuje wartość 0 do stycznia oraz wartość 11 – grudzień.
MONTH_0_11_DAY
Wartość zmiennoprzecinkowa łącząca zmodyfikowane pole miesiąca roku i zmodyfikowane pole dnia miesiąca w obiekcie ZonedDateTime reprezentującym bieżącą datę. Ta wartość zawsze mieści się w zakresie od 0.0 do 11 USD \frac{29}{30} USD włącznie.
YEAR
Liczba całkowita określająca pole roku w obiekcie ZonedDateTime dla bieżącej daty. Ta wartość jest ograniczana tak, aby znajdowała się zawsze z zakresu od 1902 do 2100 włącznie.
YEAR_S
2-cyfrowa liczba całkowita reprezentująca 2 ostatnie cyfry bieżącego roku. Na przykład wartość na rok 2023 to 23.
YEAR_MONTH
Wartość zmiennoprzecinkowa łącząca pole roku i zmodyfikowane pole dnia miesiąca w obiekcie ZonedDateTime, który reprezentuje datę bieżącą. W przypadku stycznia 2023 r. występuje wartość 2023.0, a grudzień 2023 r. – USD 2023 \frac {11}{12} USD.
YEAR_MONTH_DAY
Wartość zmiennoprzecinkowa łącząca pole roku, zmodyfikowane pole miesiąca i zmodyfikowane pole dnia miesiąca w obiekcie ZonedDateTime, który reprezentuje bieżącą datę. 1 stycznia 2023 r. jest wyświetlany jako 2023.0, a 31 grudnia 2023 r. jako 2023 USD \frac{11 \frac{29}{30}}{12} \ok. 2023,9972 USD.
WEEK_IN_MONTH
Liczba całkowita określająca wartość ALIGNED_WEEK_OF_MONTH obiektu ChronoField, który reprezentuje bieżącą datę. Ta wartość zawsze mieści się w przedziale od 0 do 5.
WEEK_IN_YEAR
Liczba całkowita określająca wartość ALIGNED_WEEK_OF_YEAR obiektu ChronoField, który reprezentuje bieżącą datę. Ta wartość zawsze mieści się w przedziale od 1 do 53.
IS_24_HOUR_MODE
Wartość logiczna, która odpowiada bieżącej wartości zwracanej przez is24HourFormat() na podstawie wybranego języka i preferencji użytkownika.
IS_DAYLIGHT_SAVING_TIME
Wartość logiczna odpowiadająca wywołaniu funkcji inDaylightTime() w obiekcie TimeZone w bieżącym języku i przekazania obiektu Date, który zawiera aktualną godzinę. Wskazuje, czy obecnie ustawiona strefa czasowa obowiązuje teraz czas letni.
TIMEZONE
Ciąg znaków odpowiadający wywołaniu funkcji getDisplayName() w obiekcie TimeZone w bieżącym języku. Zwraca pełną nazwę strefy czasowej, np. „Wschodni czas standardowy” dla strefy czasowej Nowego Jorku zimą.
TIMEZONE_ABB
Ciąg znaków odpowiadający wywołaniu przeciążonej wersji getDisplayName() w obiekcie TimeZone w bieżącym języku, gdzie podany styl to SHORT. Zwraca skróconą nazwę strefy czasowej, np. „EST” reprezentującą strefę czasową Nowego Jorku zimą.
TIMEZONE_ID
Ciąg znaków odpowiadający wywołaniu funkcji getId() w obiekcie TimeZone w bieżącym języku. Zwraca wartość identyfikatora strefy czasowej IANA, np. America/New_York jako strefę czasową Nowego Jorku.
TIMEZONE_OFFSET
Ciąg znaków odpowiadający wywołaniu funkcji getRawOffset() w obiekcie TimeZone w bieżącym języku. Ta wartość zawsze mieści się w zakresie od -12 do +14 włącznie. Zwraca wartość, którą należy dodać do czasu UTC, aby uzyskać standardowy czas aktualnej strefy czasowej (nie skorygowany o czas letni).
TIMEZONE_OFFSET_DST
Ciąg znaków odpowiadający przesłaniu bieżącej daty do getOffset() w obiekcie TimeZone w bieżącym języku. Ta wartość mieści się zawsze z zakresu od -12 do +14 włącznie. Zwraca wartość, którą należy dodać do czasu UTC, aby uzyskać bieżący czas lokalny, z uwzględnieniem czasu letniego w razie potrzeby.
AMPM_STATE
Liczba całkowita wskazująca, czy bieżąca godzina jest przed południem, południem czy później. Możliwe wartości to 0 w przypadku AM i 1 dla PM.
AMPM_POSITION

Liczba całkowita wskazująca, gdzie w ciągu czasu powinien pojawić się wskaźnik AM lub PM. Zawiera jedną z tych wartości:

  • 0 oznacza, że na początku ciągu znaków AM lub PM powinny pojawić się na przykład AM 12:03.
  • 1 oznacza, że na końcu ciągu znaków powinien pojawić się AM lub PM, np. 12:03 AM.
  • -1 oznacza, że nie wiadomo, gdzie w ciągu znaków powinien pojawić się AM lub PM.
AMPM_STRING

Dwuznakowy ciąg znaków, który wskazuje aktualne godziny przed południem lub popołudniem. Wartość to „AM” lub „PM”.

Faza Księżyca

Format tarczy zegarka obsługuje te źródła danych związane z fazą księżyca:

MOON_PHASE_POSITION
Wartość całkowita wskazująca liczbę dni, które rozpoczęły się od ostatniego księżyca po nowiu. Ta wartość mieści się zawsze z zakresu od 0 do 28 włącznie.
MOON_PHASE_TYPE

Liczba całkowita kodująca bieżącą fazę księżyca. Możliwe wartości:

  • 0 – ostatni księżyc
  • 1, gdy wieczorem ma półksiężyc
  • 2 za pierwszą kwadra księżyca
  • 3 dla przybywającego Księżyca
  • 4, aby księżyc w pełni
  • 5 dla ubywającego Księżyca
  • 6 przez ostatnią kwadra księżyca
  • 7, aby poranny półksiężyc
MOON_PHASE_TYPE_STRING

Ciąg reprezentujący bieżącą fazę księżyca. Możliwe wartości:

  • Księżyc w nowiu, gdy upłynęło mniej niż 0, 5 dnia lub upłynęło ponad 27, 5 dnia od najnowszego księżyca;
  • Wieczorny półksiężyc, gdy od ostatniego księżyca minęło co najmniej 0,5 dnia, ale mniej niż 6,5 dnia.
  • Pierwszy kwadra, gdy od ostatniego księżyca minęło co najmniej 6,5 dnia, ale mniej niż 7,5 dnia.
  • Wzrost Księżyca, gdy od ostatniego nowiu upłynęło co najmniej 7,5 dnia, ale mniej niż 13,5 dnia.
  • pełnia Księżyca, czyli dzień, w którym minęło co najmniej 13,5 dnia, ale mniej niż 14,5 dnia od ostatniego nowiu.
  • Ubywający Księżyc, gdy od ostatniego nowiu księżyca minęło co najmniej 14,5 dnia, ale mniej niż 20,5 dnia.
  • Ostatni kwadra, czyli od ostatniego księżyca po nowiu 20,5 dnia, ale mniej niż 21,5 dnia.
  • Poranny sierp księżyca, czyli po upływie co najmniej 21,5 dnia, ale mniej niż 27,5 dnia od ostatniego nowiu.

Język

Format tarczy zegarka obsługuje te źródła danych związane z językiem użytkownika:

LANGUAGE_LOCALE_NAME
Ciąg znaków reprezentujący bieżące ustawienia regionalne urządzenia z Wear OS, wyrażony w postaci 2-znakowego kodu języka w formacie ISO 639-1, podkreślenia i 2-znakowego kodu regionu w formacie ISO 3166-1. Amerykański wariant języka angielskiego jest dostępny jako en_US.

Dane dotyczące zdrowia

Format tarczy zegarka obsługuje te źródła danych związane z danymi o zdrowiu użytkownika:

STEP_COUNT
Liczba kroków wykonanych przez użytkownika do tej pory według czujników urządzenia z Wear OS.
STEP_GOAL
Liczba kroków, które użytkownik wybrał jako swój dzienny cel kroków. Ta wartość nigdy nie jest mniejsza niż 1000.
STEP_PERCENT
Liczba całkowita wskazująca postęp na drodze użytkownika do osiągnięcia celu kroków dzisiaj, wyrażona jako zaokrąglona wartość procentowa. Ta wartość mieści się zawsze z zakresu od 0 do 100 włącznie.
HEART_RATE
Aktualne tętno użytkownika podane przez czujniki urządzenia z Wear OS. Ta wartość mieści się zawsze w przedziale od 0 do 240 włącznie.
HEART_RATE_Z
Ciąg znaków reprezentujący bieżące tętno użytkownika uzyskane przez czujniki urządzenia z Wear OS. W razie potrzeby ta wartość jest uzupełniona zerami po lewej stronie, by miała co najmniej 2 znaki. Jeśli np. tętno użytkownika wynosi 65, wartość wynosi 65. Jeśli tętno użytkownika jest mierzone jako 0, wartość wynosi 00.

Czujniki urządzenia

Format tarczy zegarka obsługuje te źródła danych związane z czujnikami urządzenia:

ACCELEROMETER_IS_SUPPORTED
Wartość logiczna wskazująca, czy tarcza zegarka może pobierać dane z akcelerometru z czujników bieżącego urządzenia Wear OS.
ACCELEROMETER_X
Wartość zmiennoprzecinkowa, która wskazuje bieżące przyspieszenie liniowe wzdłuż osi X zgodnie z danymi z akcelerometru urządzenia z Wear OS. Wartości dodatnie wskazują, że gdy tarcza zegarka jest skierowana w niebo lub sufit, urządzenie z Wear OS przyspiesza w prawo.
ACCELEROMETER_Y
Wartość zmiennoprzecinkowa, która wskazuje bieżące przyspieszenie liniowe wzdłuż osi Y zgodnie z akcelerometrem urządzenia z Wear OS. Wartości dodatnie wskazują, że gdy tarcza zegarka jest skierowana w niebo lub sufit, urządzenie z Wear OS przyspiesza w kierunku dwunastu (od góry) na tarczy zegarka.
ACCELEROMETER_Z

Wartość zmiennoprzecinkowa wskazująca bieżące przyspieszenie liniowe wzdłuż osi Z zgodnie z akcelerometrem w urządzeniu z Wear OS. Wartości dodatnie wskazują, że gdy tarcza zegarka jest skierowana w niebo lub sufit, urządzenie z Wear OS przyspiesza w kierunku nieba lub sufitu.

ACCELEROMETER_ANGLE_X

Wartość zmiennoprzecinkowa wskazująca bieżące przyspieszenie kątowe względem osi X (w stopniach). Ta wartość zawsze mieści się w zakresie $ [-90.0, 90.0 $].

ACCELEROMETER_ANGLE_Y

Wartość zmiennoprzecinkowa wskazująca bieżące przyspieszenie kątowe w stopniach względem osi Y. Ta wartość zawsze mieści się w zakresie $ [-90.0, 90.0 $].

ACCELEROMETER_ANGLE_Z

Wartość zmiennoprzecinkowa wskazująca bieżące przyspieszenie kątowe (w stopniach) względem osi Z. Ta wartość zawsze mieści się w zakresie $ [-90.0, 90.0 $].

ACCELEROMETER_ANGLE_XY

Wartość zmiennoprzecinkowa, która jest sumą wymiarów ACCELEROMETER_ANGLE_X i ACCELEROMETER_ANGLE_Y.

Bateria urządzenia

Format tarczy zegarka obsługuje te źródła danych związane z bieżącym stanem baterii urządzenia:

BATTERY_PERCENT
Liczba całkowita wskazująca aktualny poziom naładowania baterii urządzenia z Wear OS, wyrażona jako procent. Wartość 100 oznacza, że bateria jest w pełni naładowana. Wartość 0 oznacza, że bateria jest bardzo słaba.
BATTERY_CHARGING_STATUS
Wartość logiczna wskazująca, czy bateria urządzenia z Wear OS się ładuje. Jeśli bateria została naładowana i naładowana, ta wartość wynosi true.
BATTERY_IS_LOW
Wartość logiczna wskazująca, czy bateria urządzenia z Wear OS jest słaba. Dokładny próg zależy od producenta. Gdy bateria się ładuje, ta wartość wynosi false.
BATTERY_TEMPERATURE_CELSIUS
Wartość zmiennoprzecinkowa wskazująca temperaturę baterii urządzenia z Wear OS (w stopniach Celsjusza). W celu uzyskania tej wartości temperatura surowa baterii baterii jest wyrażona w dziesiątkach stopnia Celsjusza.
BATTERY_TEMPERATURE_FAHRENHEIT
Wartość zmiennoprzecinkowa wskazująca temperaturę baterii urządzenia z Wear OS (w stopniach Fahrenheita). Jest to konwersja ze stopni Celsjusza.

Powiadomienia

Format tarczy zegarka obsługuje te źródła danych związane z powiadomieniami na urządzeniu:

UNREAD_NOTIFICATION_COUNT
Ciąg znaków reprezentujący liczbę powiadomień dostarczonych na to urządzenie z Wear OS, których użytkownik jeszcze nie przeczytał.