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.