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 tra0
e999
inclusi. SECOND
- Un valore intero che rappresenta il secondo campo di un oggetto
ZonedDateTime
per l'ora attuale. Questo valore è sempre compreso tra0
e59
, 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 tra00
e59
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 tra0.0
e59.999
inclusi. SECONDS_IN_DAY
- Il numero di secondi trascorsi durante il giorno corrente, in base ai valori di
HOUR_0_23
,MINUTE
eSECOND
. Questo valore è sempre compreso tra0
e86399
(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 tra0
e59
, 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 tra00
e59
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 tra0.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
e11
inclusi. Se il valore correnteCLOCK_HOUR_OF_AMPM
è12
, ad esempio in12:34 PM
, questo valore viene convertito in0
. HOUR_0_11_Z
- Una stringa che rappresenta il componente di 12 ore dell'ora corrente (dal giorno
00
al giorno11
inclusi) che utilizza il fuso orario attuale del dispositivo Wear OS. Se questo valore è inferiore a10
, 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 oggettoZonedDateTime
che rappresenta l'ora attuale. Questo valore è sempre compreso tra0.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
e12
inclusi. Se il valore correnteHOUR_OF_DAY
è0
, ad esempio in0:12
(00:12), questo valore viene convertito in12
. HOUR_1_12_Z
- Una stringa che rappresenta il componente di 12 ore dell'ora corrente (dal giorno
01
al giorno12
inclusi) che utilizza il fuso orario attuale del dispositivo Wear OS. Se questo valore è inferiore a10
, 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 oggettoZonedDateTime
che rappresenta l'ora attuale. Questo valore è sempre compreso tra1.0
e 12 $ \frac{59}{60} $ inclusi. HOUR_0_23
- Il componente 24 ore dell'ora corrente, rappresentato da un valore compreso tra
0
e23
inclusi. Se il valore è24
, ad esempio in24:13
(alle 00:13 del giorno successivo), questo valore viene convertito in0
. HOUR_0_23_Z
- Una stringa che rappresenta il componente 24 ore dell'ora corrente (dal giorno
00
al giorno23
inclusi) che utilizza il fuso orario attuale del dispositivo Wear OS. Se questo valore è inferiore a10
, 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 tra0.0
e 23 $ \frac{59}{60} $ inclusi. HOUR_1_24
- Il componente 24 ore dell'ora corrente, rappresentato da un valore compreso tra
1
e24
inclusi. Se il valore è0
, ad esempio in0:12
(00:12), questo valore viene convertito in24
. HOUR_1_24_Z
- Una stringa che rappresenta il componente di 12 ore dell'ora corrente (dal giorno
01
al giorno24
inclusi) che utilizza il fuso orario attuale del dispositivo Wear OS. Se questo valore è inferiore a10
, 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 tra1.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 tra1
e31
, 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 tra01
e31
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 tra1.0
e 31 $ \frac{23}{24} $ inclusi. DAY_0_30
- Una versione modificata del valore
getDayOfMonth()
di un oggettoZonedDateTime
che rappresenta la data corrente, sottratta per 1. Questo valore è sempre compreso tra0
e30
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 tra0.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
e366
inclusi e ha un valore massimo di365
durante gli anni non bisestili. DAY_OF_WEEK
- Una versione modificata del valore
getDayOfWeek()
di un oggettoZonedDateTime
che rappresenta la data corrente. Il formato del quadrante assegna un valore1
per rappresentare la domenica e un valore7
per rappresentare il sabato. DAY_OF_WEEK_F
- Il giorno della settimana corrente, rappresentato come una stringa completa. Tra gli esempi ci sono
Sunday
eMonday
. DAY_OF_WEEK_S
- Il giorno della settimana corrente, rappresentato da una stringa abbreviata. Tra gli esempi ci sono
Sun
eMon
. MONTH
- Un valore intero che rappresenta il campo mese di un oggetto
ZonedDateTime
per la data corrente. Questo valore è sempre compreso tra1
e12
, 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 tra01
e12
inclusi. MONTH_F
- Il mese corrente dell'anno, rappresentato come una stringa completa. Tra gli esempi ci sono
January
eDecember
. MONTH_S
- Il mese corrente dell'anno, rappresentato da una stringa abbreviata. Tra gli esempi ci sono
Jan
eDec
. DAYS_IN_MONTH
- Il numero di giorni nel mese corrente. Questo valore è
28
o29
a febbraio,30
a aprile, giugno, settembre e novembre e31
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 tra1.0
e 12 $ \frac{29}{30} $ inclusi. MONTH_0_11
- Una versione modificata del valore
getMonthValue()
di un oggettoZonedDateTime
che rappresenta la data corrente. Questo valore assegna un valore0
a gennaio e un valore di11
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 tra0.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 tra1902
e2100
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 come2023.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 come2023.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 oggettoChronoField
che rappresenta la data corrente. Questo valore è sempre compreso tra0
e5
, inclusi. WEEK_IN_YEAR
- Un numero intero che rappresenta il valore dell'elemento
ALIGNED_WEEK_OF_YEAR
di un oggettoChronoField
che rappresenta la data corrente. Questo valore è sempre compreso tra1
e53
, 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'oggettoTimeZone
per le impostazioni internazionali correnti e a passare un oggettoDate
contenente l'ora corrente. Indica se il fuso orario attualmente impostato applica l'ora legale. TIMEZONE
- Una stringa che equivale a chiamare
getDisplayName()
nell'oggettoTimeZone
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'oggettoTimeZone
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'oggettoTimeZone
per le impostazioni internazionali correnti. Restituisce un valore ID fuso orario IANA, ad esempioAmerica/New_York
per il fuso orario di New York City. TIMEZONE_OFFSET
- Una stringa che equivale a chiamare
getRawOffset()
nell'oggettoTimeZone
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'oggettoTimeZone
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 e1
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 esempioAM 12:03
.1
significa che AM o PM dovrebbero essere presenti alla fine della stringa, ad esempio12: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
e28
inclusi. MOON_PHASE_TYPE
Un numero intero che codifica la fase lunare attuale. I valori possibili sono:
0
per la luna nuova più recente1
per una luna crescente serale2
per un primo quarto di luna3
per una luna gibbosa crescente4
per la luna piena5
per una luna gibbosa calante6
per un ultimo quarto di luna7
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
e100
inclusi. HEART_RATE
- La frequenza cardiaca attuale dell'utente, in base ai sensori del dispositivo Wear OS. Questo
valore è sempre compreso tra
0
e240
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
eACCELEROMETER_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 a0
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.
Consigliato per te
- Nota: il testo del link viene visualizzato quando JavaScript è disattivato
- Espressione aritmetica
- Utilizzare dati sintetici con Health Services
- Configurazione elenco