Tipo di origine

Il valore di un'origine dati, che aggiorna un valore in tempo reale visualizzato sul quadrante.

Introdotta in Wear OS 4.

Ora e giorno

Il formato del quadrante supporta le seguenti origini dati relative all'ora e al giorno:

UTC_TIMESTAMP
Il numero di millisecondi che sono trascorsi dalla mezzanotte UTC del 1° gennaio 1970.
MILLISECOND
Un valore intero che rappresenta il campo in millisecondi di un oggetto ZonedDateTime per l'ora attuale. Questo valore è sempre compreso tra 0 e 999 inclusi.
SECOND
Un valore intero che rappresenta il secondo campo di un oggetto ZonedDateTime per l'ora attuale. Questo valore è sempre compreso tra 0 e 59, inclusi.
SECOND_Z
Una stringa che rappresenta il secondo campo di un oggetto ZonedDateTime per l'ora corrente, con zero iniziali per rendere il valore di 2 caratteri. Questo valore è sempre compreso tra 00 e 59 inclusi.
SECOND_MILLISECOND
Un valore in virgola mobile che combina i campi di secondi e millisecondi di un oggetto ZonedDateTime che rappresenta l'ora attuale. Questo valore è sempre compreso tra 0.0 e 59.999 inclusi.
SECONDS_IN_DAY
Il numero di secondi trascorsi durante il giorno corrente, in base ai valori di HOUR_0_23, MINUTE e SECOND. Questo valore è sempre compreso tra 0 e 86399 (24 $ * 60 * 60 - 1 $), inclusi.
MINUTE
Un valore intero che rappresenta il campo dei minuti di un oggetto ZonedDateTime per l'ora attuale. Questo valore è sempre compreso tra 0 e 59, inclusi.
MINUTE_Z
Un valore stringa che rappresenta il campo dei minuti di un oggetto ZonedDateTime per l'ora attuale, con zeri iniziali che aumentano la lunghezza del valore di 2 caratteri. Questo valore è sempre compreso tra 00 e 59 inclusi.
MINUTE_SECOND
Un valore in virgola mobile che combina i campi minuti e secondi di un oggetto ZonedDateTime che rappresenta l'ora attuale. Questo valore è sempre compreso tra 0.0 e 59 $ \frac{59}{60} $ inclusi.
HOUR_0_11
Il componente di 12 ore dell'ora corrente, rappresentato da un valore compreso tra 0 e 11 inclusi. Se il valore corrente CLOCK_HOUR_OF_AMPM è 12, ad esempio in 12:34 PM, questo valore viene convertito in 0.
HOUR_0_11_Z
Una stringa che rappresenta il componente di 12 ore dell'ora corrente (dal giorno 00 al giorno 11 inclusi) che utilizza il fuso orario attuale del dispositivo Wear OS. Se questo valore è inferiore a 10, include uno zero iniziale.
HOUR_0_11_MINUTE
Un valore a virgola mobile che combina un campo CLOCK_HOUR_OF_AMPM modificato e un campo dei minuti di un oggetto ZonedDateTime che rappresenta l'ora attuale. Questo valore è sempre compreso tra 0.0 e 11 $ \frac{59}{60} $ inclusi.
HOUR_1_12
Il componente di 12 ore dell'ora corrente, rappresentato da un valore compreso tra 1 e 12 inclusi. Se il valore corrente HOUR_OF_DAY è 0, ad esempio in 0:12 (00:12), questo valore viene convertito in 12.
HOUR_1_12_Z
Una stringa che rappresenta il componente di 12 ore dell'ora corrente (dal giorno 01 al giorno 12 inclusi) che utilizza il fuso orario attuale del dispositivo Wear OS. Se questo valore è inferiore a 10, include uno zero iniziale.
HOUR_1_12_MINUTE
Un valore in virgola mobile che combina i campi CLOCK_HOUR_OF_AMPM e dei minuti di un oggetto ZonedDateTime che rappresenta l'ora attuale. Questo valore è sempre compreso tra 1.0 e 12 $ \frac{59}{60} $ inclusi.
HOUR_0_23
Il componente 24 ore dell'ora corrente, rappresentato da un valore compreso tra 0 e 23 inclusi. Se il valore è 24, ad esempio in 24:13 (alle 00:13 del giorno successivo), questo valore viene convertito in 0.
HOUR_0_23_Z
Una stringa che rappresenta il componente 24 ore dell'ora corrente (dal giorno 00 al giorno 23 inclusi) che utilizza il fuso orario attuale del dispositivo Wear OS. Se questo valore è inferiore a 10, include uno zero iniziale.
HOUR_0_23_MINUTE
Un valore in virgola mobile che combina i campi ora e minuti di un oggetto ZonedDateTime che rappresenta l'ora corrente. Questo valore è sempre compreso tra 0.0 e 23 $ \frac{59}{60} $ inclusi.
HOUR_1_24
Il componente 24 ore dell'ora corrente, rappresentato da un valore compreso tra 1 e 24 inclusi. Se il valore è 0, ad esempio in 0:12 (00:12), questo valore viene convertito in 24.
HOUR_1_24_Z
Una stringa che rappresenta il componente di 12 ore dell'ora corrente (dal giorno 01 al giorno 24 inclusi) che utilizza il fuso orario attuale del dispositivo Wear OS. Se questo valore è inferiore a 10, include uno zero iniziale.
HOUR_1_24_MINUTE
Un valore a virgola mobile che combina un campo ora modificato e un campo dei minuti di un oggetto ZonedDateTime che rappresenta l'ora attuale. Questo valore è sempre compreso tra 1.0 e 24 $ \frac{59}{60} $ inclusi.
DAY
Un valore intero che rappresenta il campo del giorno di un oggetto ZonedDateTime per la data corrente. Questo valore è sempre compreso tra 1 e 31, inclusi.
DAY_Z
Un valore stringa che rappresenta il campo del giorno di un oggetto ZonedDateTime per la data corrente, con zero iniziali per caratterizzare il valore. Questo valore è sempre compreso tra 01 e 31 inclusi.
DAY_HOUR
Un valore in virgola mobile che combina i campi del giorno del mese e dell'ora di un oggetto ZonedDateTime che rappresenta la data e l'ora correnti. Questo valore è sempre compreso tra 1.0 e 31 $ \frac{23}{24} $ inclusi.
DAY_0_30
Una versione modificata del valore getDayOfMonth() di un oggetto ZonedDateTime che rappresenta la data corrente, sottratta per 1. Questo valore è sempre compreso tra 0 e 30 inclusi.
DAY_0_30_HOUR
Un valore con virgola mobile che combina un campo del giorno del mese modificato e un campo ora di un oggetto ZonedDateTime che rappresenta la data e l'ora correnti. Questo valore è sempre compreso tra 0.0 e 30 $ \frac{23}{24} $ inclusi.
DAY_OF_YEAR
Il numero di giorni iniziati dopo la modifica dell'anno di calendario. Questo valore è sempre compreso tra 1 e 366 inclusi e ha un valore massimo di 365 durante gli anni non bisestili.
DAY_OF_WEEK
Una versione modificata del valore getDayOfWeek() di un oggetto ZonedDateTime che rappresenta la data corrente. Il formato del quadrante assegna un valore 1 per rappresentare la domenica e un valore 7 per rappresentare il sabato.
DAY_OF_WEEK_F
Il giorno della settimana corrente, rappresentato come una stringa completa. Tra gli esempi ci sono Sunday e Monday.
DAY_OF_WEEK_S
Il giorno della settimana corrente, rappresentato da una stringa abbreviata. Tra gli esempi ci sono Sun e Mon.
MONTH
Un valore intero che rappresenta il campo mese di un oggetto ZonedDateTime per la data corrente. Questo valore è sempre compreso tra 1 e 12, inclusi.
MONTH_Z
Un valore stringa che rappresenta il campo mese di un oggetto ZonedDateTime per la data corrente, con zeri iniziali che aumentano la lunghezza del valore di 2 caratteri. Questo valore è sempre compreso tra 01 e 12 inclusi.
MONTH_F
Il mese corrente dell'anno, rappresentato come una stringa completa. Tra gli esempi ci sono January e December.
MONTH_S
Il mese corrente dell'anno, rappresentato da una stringa abbreviata. Tra gli esempi ci sono Jan e Dec.
DAYS_IN_MONTH
Il numero di giorni nel mese corrente. Questo valore è 28 o 29 a febbraio, 30 a aprile, giugno, settembre e novembre e 31 durante tutti gli altri mesi del calendario gregoriano.
MONTH_DAY
Un valore con virgola mobile che combina il campo del mese dell'anno e il campo del giorno del mese modificato di un oggetto ZonedDateTime che rappresenta la data corrente. Questo valore è sempre compreso tra 1.0 e 12 $ \frac{29}{30} $ inclusi.
MONTH_0_11
Una versione modificata del valore getMonthValue() di un oggetto ZonedDateTime che rappresenta la data corrente. Questo valore assegna un valore 0 a gennaio e un valore di 11 a dicembre.
MONTH_0_11_DAY
Un valore con virgola mobile che combina un campo del mese dell'anno modificato e un campo del giorno del mese modificato di un oggetto ZonedDateTime che rappresenta la data corrente. Questo valore è sempre compreso tra 0.0 e 11 $ \frac{29}{30} $ inclusi.
YEAR
Un valore intero che rappresenta il campo anno di un oggetto ZonedDateTime per la data corrente. Questo valore deve essere sempre compreso tra 1902 e 2100 inclusi.
YEAR_S
Un numero intero a due cifre che rappresenta le ultime due cifre dell'anno in corso. Ad esempio, il valore per il 2023 è 23.
YEAR_MONTH
Un valore in virgola mobile che combina il campo anno e il campo del giorno del mese modificato di un oggetto ZonedDateTime che rappresenta la data corrente. Gennaio 2023 è rappresentato come 2023.0, mentre dicembre 2023 è rappresentato da $ 2023 \frac {11}{12} $.
YEAR_MONTH_DAY
Un valore con virgola mobile che combina il campo dell'anno, un campo del mese dell'anno modificato e un campo del giorno del mese modificato di un oggetto ZonedDateTime che rappresenta la data corrente. Il 1° gennaio 2023 è rappresentato come 2023.0, mentre il 31 dicembre 2023 è rappresentato come $ 2023 \frac{11 \frac{29}{30}}{12} \approx 2023.9972 $.
WEEK_IN_MONTH
Un numero intero che rappresenta il valore dell'elemento ALIGNED_WEEK_OF_MONTH di un oggetto ChronoField che rappresenta la data corrente. Questo valore è sempre compreso tra 0 e 5, inclusi.
WEEK_IN_YEAR
Un numero intero che rappresenta il valore dell'elemento ALIGNED_WEEK_OF_YEAR di un oggetto ChronoField che rappresenta la data corrente. Questo valore è sempre compreso tra 1 e 53, inclusi.
IS_24_HOUR_MODE
Un valore booleano equivalente all'attuale valore restituito di is24HourFormat(), in base alle impostazioni internazionali e alle preferenze scelte dall'utente.
IS_DAYLIGHT_SAVING_TIME
Un valore booleano che equivale a chiamare inDaylightTime() nell'oggetto TimeZone per le impostazioni internazionali correnti e a passare un oggetto Date contenente l'ora corrente. Indica se il fuso orario attualmente impostato applica l'ora legale.
TIMEZONE
Una stringa che equivale a chiamare getDisplayName() nell'oggetto TimeZone per le impostazioni internazionali correnti. Restituisce il nome completo del fuso orario, ad esempio "Ora standard orientale USA" per il fuso orario di New York durante l'inverno.
TIMEZONE_ABB
Una stringa equivalente a chiamare una versione sovraccarico di getDisplayName() nell'oggetto TimeZone per l'impostazione internazionale corrente, dove lo stile specificato è SHORT. Restituisce un nome abbreviato del fuso orario, ad esempio "EST" per il fuso orario di New York durante l'inverno.
TIMEZONE_ID
Una stringa equivalente alla chiamata di getId() nell'oggetto TimeZone per le impostazioni internazionali correnti. Restituisce un valore ID fuso orario IANA, ad esempio America/New_York per il fuso orario di New York City.
TIMEZONE_OFFSET
Una stringa che equivale a chiamare getRawOffset() nell'oggetto TimeZone per le impostazioni internazionali correnti. Questo valore è sempre compreso tra -12 e +14 inclusi. Restituisce il valore che deve essere aggiunto al fuso orario UTC per ottenere l'ora standard per il fuso orario corrente (non corretto per l'ora legale).
TIMEZONE_OFFSET_DST
Una stringa che equivale a passare la data corrente in getOffset() nell'oggetto TimeZone per le impostazioni internazionali correnti. Questo valore è sempre compreso tra -12 e +14 inclusi. Restituisce il valore che deve essere aggiunto al fuso orario UTC per ottenere l'ora locale corrente, prendendo in considerazione l'ora legale, se necessario.
AMPM_STATE
Un numero intero che indica se l'ora corrente è precedente a mezzogiorno oppure se è mezzogiorno o una data successiva. I valori possibili sono 0 per AM e 1 per PM.
AMPM_POSITION

Un numero intero che indica dove deve apparire l'indicatore AM o PM in una stringa temporale. Contiene uno dei seguenti valori:

  • 0 significa che AM o PM devono trovarsi all'inizio della stringa, ad esempio AM 12:03.
  • 1 significa che AM o PM dovrebbero essere presenti alla fine della stringa, ad esempio 12:03 AM.
  • -1 significa che non è noto dove AM o PM devono apparire nella stringa.
AMPM_STRING

Una stringa di due caratteri che indica lo stato AM o PM dell'ora corrente. Il valore è "AM" o "PM".

Fase lunare

Watch Face Format supporta le seguenti origini dati relative alla fase lunare:

MOON_PHASE_POSITION
Un valore intero che indica il numero di giorni iniziati dall'ultima luna nuova. Questo valore è sempre compreso tra 0 e 28 inclusi.
MOON_PHASE_TYPE

Un numero intero che codifica la fase lunare attuale. I valori possibili sono:

  • 0 per la luna nuova più recente
  • 1 per una luna crescente serale
  • 2 per un primo quarto di luna
  • 3 per una luna gibbosa crescente
  • 4 per la luna piena
  • 5 per una luna gibbosa calante
  • 6 per un ultimo quarto di luna
  • 7 per una luna crescente mattutina
MOON_PHASE_TYPE_STRING

Una stringa che rappresenta l'attuale fase lunare. I valori possibili sono:

  • Luna nuova, quando sono trascorsi meno di 0, 5 giorni o più di 27, 5 giorni dalla luna nuova più recente.
  • Mezzaluna serale, quando sono trascorsi almeno 0,5 giorni ma meno di 6,5 giorni dall'ultima luna nuova.
  • Primo quarto, quando sono trascorsi almeno 6,5 giorni ma meno di 7,5 giorni dall'ultima luna nuova.
  • Gibbosa crescente, quando sono trascorsi almeno 7,5 giorni ma meno di 13,5 giorni dall'ultima luna nuova.
  • Luna piena, quando sono trascorsi almeno 13,5 giorni ma meno di 14,5 giorni dall'ultima luna nuova.
  • Gibbosa calante, quando sono trascorsi almeno 14,5 giorni ma meno di 20,5 giorni dall'ultima luna nuova.
  • Il trimestre scorso, quando sono trascorsi almeno 20,5 giorni ma meno di 21,5 giorni dall'ultima luna nuova.
  • Mezzaluna del mattino, quando sono trascorsi almeno 21,5 giorni ma meno di 27,5 giorni dall'ultima luna nuova.

Lingua

Watch Face Format supporta le seguenti origini dati correlate alla lingua dell'utente:

LANGUAGE_LOCALE_NAME
Una stringa che rappresenta le impostazioni internazionali correnti del dispositivo Wear OS, espresse come codice lingua ISO 639-1 di due caratteri, un trattino basso e un codice regione ISO 3166-1 di due caratteri. La variante dell'inglese negli Stati Uniti è rappresentata come en_US.

Dati salute

Il formato del quadrante supporta le seguenti origini dati relative ai dati sulla salute dell'utente:

STEP_COUNT
Il numero di passaggi effettuati dall'utente finora oggi, in base ai sensori dei dispositivi Wear OS.
STEP_GOAL
Il numero di passi che l'utente ha selezionato come obiettivo di passi giornaliero. Questo valore non è mai inferiore a 1000.
STEP_PERCENT
Un numero intero che indica i progressi fatti oggi dall'utente verso l'obiettivo di passi, espresso come percentuale arrotondata. Questo valore è sempre compreso tra 0 e 100 inclusi.
HEART_RATE
La frequenza cardiaca attuale dell'utente, in base ai sensori del dispositivo Wear OS. Questo valore è sempre compreso tra 0 e 240 inclusi.
HEART_RATE_Z
Una stringa che rappresenta la frequenza cardiaca attuale dell'utente, secondo i sensori del dispositivo Wear OS. Questo valore viene riempito con zeri a sinistra secondo necessità per rendere il valore di almeno 2 caratteri. Quindi, se la frequenza cardiaca dell'utente viene misurata come 65, questo valore è 65. Se la frequenza cardiaca dell'utente viene misurata come 0, questo valore è 00.

Sensori dispositivo

Il formato del quadrante supporta le seguenti origini dati relative ai sensori del dispositivo:

ACCELEROMETER_IS_SUPPORTED
Valore booleano che indica se il quadrante può ottenere i dati dell'accelerometro dai sensori dell'attuale dispositivo Wear OS.
ACCELEROMETER_X
Un valore in virgola mobile che indica l'attuale accelerazione lineare lungo l'asse x, in base all'accelerometro del dispositivo Wear OS. I valori positivi indicano che, quando il quadrante è rivolto verso il cielo o il soffitto, il dispositivo Wear OS sta accelerando verso destra.
ACCELEROMETER_Y
Un valore in virgola mobile che indica l'attuale accelerazione lineare lungo l'asse y, in base all'accelerometro del dispositivo Wear OS. I valori positivi indicano che, quando il quadrante è rivolto verso il cielo o il soffitto, il dispositivo Wear OS accelera in direzione delle ore 12 (in alto) lungo il quadrante.
ACCELEROMETER_Z

Un valore in virgola mobile che indica l'attuale accelerazione lineare lungo l'asse z, in base all'accelerometro del dispositivo Wear OS. I valori positivi indicano che, quando il quadrante è rivolto verso il cielo o il soffitto, il dispositivo Wear OS sta accelerando verso il cielo o il soffitto.

ACCELEROMETER_ANGLE_X

Un valore in virgola mobile che indica l'accelerazione angolare attuale, in gradi, rispetto all'asse x. Questo valore è sempre compreso nell'intervallo $ [-90,0, 90,0 $].

ACCELEROMETER_ANGLE_Y

Un valore in virgola mobile che indica l'accelerazione angolare attuale, in gradi, rispetto all'asse y. Questo valore è sempre compreso nell'intervallo $ [-90,0, 90,0 $].

ACCELEROMETER_ANGLE_Z

Un valore in virgola mobile che indica l'accelerazione angolare attuale, in gradi, rispetto all'asse z. Questo valore è sempre compreso nell'intervallo $ [-90,0, 90,0 $].

ACCELEROMETER_ANGLE_XY

Un valore in virgola mobile che è la somma di ACCELEROMETER_ANGLE_X e ACCELEROMETER_ANGLE_Y.

Batteria dispositivo

Watch Face Format supporta le seguenti origini dati relative allo stato attuale della batteria del dispositivo:

BATTERY_PERCENT
Un numero intero che indica l'attuale livello di carica della batteria del dispositivo Wear OS, espresso in percentuale. Un valore pari a 100 indica che la batteria è carica; un valore pari a 0 indica che il livello della batteria è molto basso.
BATTERY_CHARGING_STATUS
Un valore booleano che indica se la batteria del dispositivo Wear OS si sta ricaricando. Se la batteria ha terminato la ricarica ed è completamente carica, questo valore è true.
BATTERY_IS_LOW
Un valore booleano che indica se il livello della batteria del dispositivo Wear OS è basso. La soglia esatta dipende dal produttore. Se la batteria si sta ricaricando, questo valore è false.
BATTERY_TEMPERATURE_CELSIUS
Un valore a virgola mobile che indica la temperatura in gradi Celsius della batteria del dispositivo Wear OS. Per ottenere questo valore, il valore della temperatura non elaborata della batteria, in decimi di grado Celsius, viene diviso per 10.
BATTERY_TEMPERATURE_FAHRENHEIT
Un valore a virgola mobile che indica la temperatura della batteria del dispositivo Wear OS, in gradi Fahrenheit. Si tratta di una conversione da gradi Celsius.

Notifiche

Il formato del quadrante supporta la seguente origine dati relativa alle notifiche del dispositivo:

UNREAD_NOTIFICATION_COUNT
Una stringa che rappresenta il numero di notifiche inviate a questo dispositivo Wear OS che l'utente non ha ancora letto.