CKTIS / Java
ZonedDateTime — data e ora con fuso orario
ZonedDateTime combina una data e ora locali, un fuso e un offset UTC risolto. Distingue tra il cambio di fuso mantenendo lo stesso istante e il mantenimento dell’ora locale, e gestisce le ambiguità dovute ai cambi dell’ora.
Versione: Java SE 21; repository runtime, production runtime not attested
Sintassi
ZonedDateTime.of(localDateTime, zone)
ZonedDateTime.ofInstant(instant, zone)
ZonedDateTime.ofLocal(localDateTime, zone, preferredOffset)
zdt.withZoneSameInstant(zone)
zdt.withZoneSameLocal(zone)
zdt.toInstant()
zdt.format(formatter)
zdt.with(adjuster)
zdt.with(field, value)
zdt.withHour(hour)
zdt.withMinute(minute)ZonedDateTime è un valore di data e ora ISO immutabile e thread-safe, con un ZoneId e un ZoneOffset. Un fuso regionale definisce le regole per le variazioni dell’offset; un offset fisso non presenta tali variazioni.
ZonedDateTime.of crea un valore da una data e ora locali e un fuso. In un intervallo inesistente sposta l’ora in avanti della durata dell’intervallo; in una sovrapposizione sceglie l’offset precedente. ZonedDateTime.ofLocal accetta anche un offset preferito: lo usa se è valido, altrimenti sceglie quello precedente; null indica che non c’è una preferenza. Risolve gli intervalli inesistenti allo stesso modo. ZonedDateTime.ofInstant(instant, zone) conserva l’istante fornito senza questa ambiguità.
ZonedDateTime.withZoneSameInstant conserva l’istante e di solito cambia l’ora locale. ZonedDateTime.withZoneSameLocal conserva, se possibile, la data e ora locali applicando le regole di ofLocal; può cambiare l’istante. ZonedDateTime.toInstant restituisce il solo istante, senza l’identificatore del fuso, mentre ZonedDateTime.format formatta il valore usando un DateTimeFormatter.
ZonedDateTime.with(adjuster) applica un TemporalAdjuster, mentre ZonedDateTime.with(field, value) imposta un campo. ZonedDateTime.withHour imposta l’ora tra 0 e 23 e ZonedDateTime.withMinute i minuti tra 0 e 59. Conserva il valore restituito: l’originale non cambia. Anche le modifiche locali di ora o minuto seguono le regole per intervalli inesistenti e sovrapposizioni; non equivalgono ad aggiungere una durata trascorsa.
Esempi
import java.time.*;
import java.time.format.DateTimeFormatter;
public class Main {
public static void main(String[] args) {
ZoneId source = ZoneOffset.ofHours(1);
ZoneId target = ZoneOffset.ofHours(-5);
LocalDateTime local = LocalDateTime.of(2024, 1, 15, 12, 0);
ZonedDateTime original = ZonedDateTime.of(local, source);
ZonedDateTime sameInstant = original.withZoneSameInstant(target);
ZonedDateTime sameLocal = original.withZoneSameLocal(target);
System.out.println(sameInstant.format(DateTimeFormatter.ISO_ZONED_DATE_TIME));
System.out.println(sameLocal.format(DateTimeFormatter.ISO_ZONED_DATE_TIME));
System.out.println(original.toInstant().equals(sameInstant.toInstant()));
System.out.println(original.toInstant().equals(sameLocal.toInstant()));
}
}Risultato
2024-01-15T06:00:00-05:00 2024-01-15T12:00:00-05:00 true false
Il codice mostrato e il risultato dichiarato sono stati verificati in un ambiente isolato con il metodo registrato nella prova di verifica di questa versione esatta.