CKTIS / Java
ZonedDateTime : création, conversion, formatage et ajustements calendaires
Créez une date et une heure avec un fuseau, convertissez-les sans changer d’instant, formatez-les et modifiez les champs locaux en tenant compte des changements d’heure.
Version : Java SE 21
Syntaxe
java.time.ZonedDateTime — Java SE 21
static ZonedDateTime of(LocalDateTime dateTime, ZoneId zone)
static ZonedDateTime of(LocalDate date, LocalTime time, ZoneId zone)
static ZonedDateTime of(int year, int month, int dayOfMonth, int hour, int minute, int second, int nanoOfSecond, ZoneId zone)
static ZonedDateTime ofInstant(Instant instant, ZoneId zone)
static ZonedDateTime ofInstant(LocalDateTime dateTime, ZoneOffset offset, ZoneId zone)
Instant toInstant() // inherited from ChronoZonedDateTime
ZonedDateTime withZoneSameInstant(ZoneId zone)
String format(DateTimeFormatter formatter)
ZonedDateTime with(TemporalAdjuster adjuster)
ZonedDateTime with(TemporalField field, long newValue)
ZonedDateTime withHour(int hour)
ZonedDateTime withMinute(int minute)java.time.ZonedDateTime conserve une date et une heure locales, un identifiant de fuseau et le décalage retenu par rapport à UTC. La méthode statique ZonedDateTime.of accepte un LocalDateTime, un couple LocalDate et LocalTime ou sept entiers (year à nanoOfSecond), toujours avec un ZoneId. Si l’heure locale tombe dans un intervalle sauté lorsque l’horloge avance, la méthode l’avance de la durée de cet intervalle. Si l’heure locale se répète, elle choisit le décalage correspondant au premier des deux instants. Des champs numériques invalides ou une date impossible déclenchent DateTimeException.
ZonedDateTime.ofInstant(Instant, ZoneId) détermine la date, l’heure et le décalage de l’instant dans le fuseau cible. La surcharge (LocalDateTime, ZoneOffset, ZoneId) détermine d’abord l’instant à partir de la date et de l’heure locales et du décalage fournis, puis le représente dans le fuseau cible. L’heure locale et le décalage obtenus peuvent donc différer des valeurs fournies. La méthode héritée ZonedDateTime.toInstant() renvoie le même instant sans information de fuseau. ZonedDateTime.withZoneSameInstant(ZoneId) conserve l’instant, mais peut modifier la date et l’heure locales. À l’inverse, withZoneSameLocal essaie de conserver la date et l’heure locales et peut changer l’instant.
ZonedDateTime.format(DateTimeFormatter) renvoie un String sans modifier l’objet. ISO_OFFSET_DATE_TIME affiche la date et l’heure locales ainsi que le décalage, mais pas l’identifiant du fuseau régional. En cas d’échec du formatage, la méthode lève DateTimeException.
ZonedDateTime.with(TemporalAdjuster) applique une règle, par exemple TemporalAdjusters.lastDayOfMonth(). La surcharge with(TemporalField, long) définit un champ pris en charge, par exemple ChronoField.MONTH_OF_YEAR. INSTANT_SECONDS fixe la seconde sur la ligne du temps sans changer le fuseau ni la fraction de seconde. OFFSET_SECONDS ne peut que sélectionner l’autre décalage valide lorsque l’heure locale se répète. Un champ non pris en charge peut déclencher UnsupportedTemporalTypeException ; une valeur invalide peut déclencher DateTimeException.
ZonedDateTime.withHour(int) fixe l’heure (0–23) et ZonedDateTime.withMinute(int) la minute (0–59) ; ces méthodes n’ajoutent pas de durée. Une valeur hors limites déclenche DateTimeException. Modifier des champs locaux conserve le fuseau, mais peut changer l’instant. Dans un intervalle sauté, le résultat avance de la durée de l’intervalle. Si l’heure se répète, le décalage précédent est conservé s’il reste valide ; sinon, le premier instant est choisi. Les objets sont immuables : conservez le résultat renvoyé.
Exemples
import java.time.Instant;
import java.time.LocalDateTime;
import java.time.ZoneOffset;
import java.time.ZonedDateTime;
import java.time.format.DateTimeFormatter;
import java.time.temporal.ChronoField;
import java.time.temporal.TemporalAdjusters;
public class Main {
public static void main(String[] args) {
ZoneOffset east = ZoneOffset.of("+01:00");
ZoneOffset west = ZoneOffset.of("-05:00");
DateTimeFormatter iso = DateTimeFormatter.ISO_OFFSET_DATE_TIME;
ZonedDateTime original = ZonedDateTime.of(
LocalDateTime.of(2024, 1, 15, 10, 30), east);
Instant instant = original.toInstant();
ZonedDateTime converted = original.withZoneSameInstant(west);
ZonedDateTime rebuilt = ZonedDateTime.ofInstant(instant, west);
ZonedDateTime edited = original.with(ChronoField.MONTH_OF_YEAR, 2)
.with(TemporalAdjusters.lastDayOfMonth())
.withHour(14)
.withMinute(45);
System.out.println(original.format(iso));
System.out.println(instant);
System.out.println(converted.format(iso));
System.out.println(converted.equals(rebuilt));
System.out.println(edited.format(iso));
}
}Résultat
2024-01-15T10:30:00+01:00 2024-01-15T09:30:00Z 2024-01-15T04:30:00-05:00 true 2024-02-29T14:45:00+01:00
Les trois premières lignes représentent le même instant. `true` indique que les deux conversions vers `-05:00` donnent le même résultat. La dernière ligne montre l’ajustement au 29 février à 14:45 avec le décalage initial. Les décalages fixes rendent l’exemple indépendant des règles des fuseaux régionaux.
Leçons associées
- Java · Leçon 59 · Intermédiaire · Version : 2