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

CKTIS / Java

ZoneOffset — un décalage fixe par rapport à UTC

ZoneOffset décrit un décalage fixe par rapport à UTC, et non les règles d’un fuseau horaire régional. ZoneOffset.UTC représente le décalage nul, dont l’identifiant est Z.

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

Syntaxe

ZoneOffset.UTC
ZoneOffset.of("+02:00")
ZoneOffset.ofHoursMinutes(-5, -30)
offset.getId()
offset.getTotalSeconds()

java.time.ZoneOffset représente une différence fixe par rapport à UTC, par exemple +02:00. Il ne stocke ni date ni heure. Un ZoneId régional, tel que Europe/Paris, définit les règles permettant de trouver le décalage à un instant donné ; un décalage seul ne décrit pas les changements liés à l’heure d’été.

ZoneOffset.UTC représente le décalage nul ; getId() renvoie Z pour celui-ci. Des fabriques telles que of("+02:00") et ofHoursMinutes(-5, -30) créent d’autres valeurs. Les composantes non nulles doivent avoir le même signe. La plage va de -18:00 à +18:00 inclus ; une valeur non valide provoque une DateTimeException.

Les instances sont immuables et thread-safe. Comparez-les avec equals, et non avec ==, et ne les utilisez pas comme verrous de synchronisation. L’exemple montre des identifiants normalisés, un décalage en secondes et l’égalité entre deux représentations du décalage nul.

Exemples

import java.time.ZoneOffset;

public class Main {
    public static void main(String[] args) {
        ZoneOffset offset = ZoneOffset.ofHoursMinutes(-5, -30);
        System.out.println(ZoneOffset.UTC.getId());
        System.out.println(offset.getId());
        System.out.println(offset.getTotalSeconds());
        System.out.println(ZoneOffset.UTC.equals(ZoneOffset.of("+00:00")));
    }
}

Résultat

Z
-05:30
-19800
true

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