DateTime

string

Data e ora di un formato esteso ISO 8601. L'offset può essere o meno necessario (fai riferimento alla documentazione del campo principale). Il tempo può essere specificato con una precisione fino a nanosecondi. Gli offset possono essere specificati con la precisione in secondi (anche se i secondi di offset non fanno parte di ISO 8601).

Ad esempio:

1985-04-12T23:20:50.52Z sarebbe 20 minuti e 50, 52 secondi dopo la 23a ora del 12 aprile 1985 in UTC.

1985-04-12T19:20:50.52-04:00 corrisponderebbe a 20 minuti e 50, 52 secondi dopo la 19a ora del 12 aprile 1985, 4 ore prima del fuso orario UTC (stesso istante dell'esempio riportato sopra). Se la data e l'ora si riferiscono a una località fisica a New York, corrispondono all'ora legale orientale. Ricorda che l'offset varia nelle regioni che osservano l'ora legale (o ora legale), a seconda del periodo dell'anno.

1985-04-12T19:20:50.52 sarebbe 20 minuti e 50, 52 secondi dopo la 19a ora del 12 aprile 1985 senza informazioni sull'offset.

L'invio di un offset lo rende un momento assoluto nel tempo in tutto il mondo. La data e l'ora vengono regolate in base al fuso orario dell'utente. Ad esempio, 2018-06-19T18:30:00-04:00 saranno le 18:30:00 per gli utenti di New York e le 15:30:00 per gli utenti di Los Angeles.

Se ometti l'offset, viene applicata una data/ora locale, che rappresenta diversi istanti nel tempo in tutto il mondo. La data e l'ora sono sempre riferite al fuso orario corrente dell'utente. Ad esempio, l'orario 2018-06-19T18:30:00 sarà 18:30:00 per un utente di New York e anche 18:30:00 per un utente di Los Angeles. Ciò è utile quando la stessa data e ora locale deve essere applicata a molte sedi fisiche in diversi fusi orari.