Base de connaissancesCentre d’examen
FRFrançais
Choisir la langue13

CKTIS / Java

ZonedDateTime — date et heure avec un fuseau horaire

ZonedDateTime associe une date et une heure locales, un fuseau et un décalage UTC résolu. Il distingue le changement de fuseau avec conservation de l’instant du maintien de l’heure locale, et gère les ambiguïtés dues aux changements d’heure.

Version : Java SE 21; repository runtime, production runtime not attested

Syntaxe

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 est une date-heure ISO immuable et thread-safe, associée à un ZoneId et à un ZoneOffset. Un fuseau régional définit des règles de changement de décalage ; un décalage fixe n’en connaît pas.

ZonedDateTime.of crée une valeur à partir d’une date-heure locale et d’un fuseau. Lors d’un intervalle inexistant, il avance l’heure de la durée de cet intervalle ; lors d’un chevauchement, il choisit le décalage le plus ancien. ZonedDateTime.ofLocal accepte aussi un décalage préféré : il l’utilise s’il est valide, sinon choisit le plus ancien ; null signifie qu’il n’y a pas de préférence. Les intervalles inexistants sont résolus de la même façon. ZonedDateTime.ofInstant(instant, zone) conserve l’instant fourni sans cette ambiguïté.

ZonedDateTime.withZoneSameInstant conserve l’instant et modifie généralement l’heure locale. ZonedDateTime.withZoneSameLocal conserve, si possible, la date-heure locale en appliquant les règles de ofLocal ; l’instant peut changer. ZonedDateTime.toInstant renvoie uniquement l’instant, sans l’identifiant du fuseau, tandis que ZonedDateTime.format formate la valeur avec un DateTimeFormatter.

ZonedDateTime.with(adjuster) applique un TemporalAdjuster, tandis que ZonedDateTime.with(field, value) définit un champ. ZonedDateTime.withHour définit l’heure entre 0 et 23, et ZonedDateTime.withMinute les minutes entre 0 et 59. Utilisez la valeur renvoyée : l’original reste inchangé. Les changements locaux d’heure ou de minute suivent également les règles des intervalles inexistants et des chevauchements ; ils ne signifient pas qu’une durée écoulée est ajoutée.

Exemples

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()));
    }
}

Résultat

2024-01-15T06:00:00-05:00
2024-01-15T12:00:00-05:00
true
false

Le code affiché et le résultat déclaré ont été vérifiés dans un environnement isolé selon la méthode consignée dans la preuve de vérification de cette version exacte.

Sources