Utilizzo della sintassi data - ora

Tutte le API, le uscite utente e gli eventi che utilizzano campi data - ora hanno una sintassi uniforme (una combinazione dei formati di base ed estesi della specifica ISO 8601). Questa sintassi è il formato previsto per tutti gli input e output.

Sintassi solo data

AAAA-MM-GG

Sintassi data - ora

AAA-MM-GGTHH:MI:SSZ o AAAA-MM-GGTHH:MI:SS+HH:MM

I valori in grassetto sono segnaposto per i valori letterali. Ad esempio, il formato per 5 marzo 2003, 11:30:59 p.m. è 2003-03-05T23:30:59.

Nota: questa sintassi è una sintassi data - ora ISO e non la sintassi del database. L'utilizzo di una sintassi diversa dal formato data - ora ISO può causare problemi. Ad esempio, l'elemento ora nella sintassi Data - Ora potrebbe essere trascurato o calcolato in modo non corretto.

Ad esempio, se si fornisce l'input Data - ora come "2007-05-18-19.10.28.000000", il sistema potrebbe interpretarlo come "2007-05-18" poiché il simbolo T manca nell'input.

Parametri di sintassi

Parametro Descrizione
AAAA Obbligatorio. Anno a quattro cifre. Utilizzato in entrambi i campi data - ora e data.
MM Obbligatorio. Mese a due cifre. Utilizzato in entrambi i campi data - ora e data.
GG Obbligatorio. Giorno del mese a due cifre. Utilizzato in entrambi i campi data - ora e data.
T Obbligatorio. Il valore letterale T, che separa il componente data e ora. Utilizzato solo nei campi data - ora.
HH Obbligatorio. Ora del giorno a due cifre. Ad esempio, 11 p.m. viene visualizzato come 23:00:00. Utilizzato solo nei campi data - ora.
SN Obbligatorio. Minuti dell'ora a due cifre. Ad esempio, 59 minuti viene visualizzato come 00:59:00. Utilizzato solo nei campi data - ora.
SS Obbligatorio. Secondi a due cifre del minuto. Ad esempio, 21 secondi viene visualizzato come 00:00:21. Utilizzato solo nei campi data - ora.
Z Facoltativo. Questo parametro separa il componente ora in formato GMT. Utilizzato solo nella sintassi data - ora.
Nota: è possibile passare il parametro Z come immissione. Il sistema non restituisce questo parametro nell'output.
+HH :MI Facoltativo. Ore e minuti a due cifre, separati da due punti (":"). Indica quante ore dall'UTC, utilizzando - per indicare prima dell'UTC e + per indicare dopo l'UTC. Se questo valore non viene passato nell'input, viene utilizzato il fuso orario dell'applicazione.