CKTIS / Java
ZoneOffset — uno scostamento fisso da UTC
ZoneOffset descrive uno scostamento fisso da UTC, non le regole di un fuso orario regionale. ZoneOffset.UTC rappresenta lo scostamento zero, il cui identificatore è Z.
Versione: Java SE 21; repository runtime, production runtime not attested
Sintassi
ZoneOffset.UTC
ZoneOffset.of("+02:00")
ZoneOffset.ofHoursMinutes(-5, -30)
offset.getId()
offset.getTotalSeconds()java.time.ZoneOffset rappresenta una differenza fissa da UTC, per esempio +02:00. Non memorizza né una data né un orario. Un ZoneId regionale, come Europe/Paris, definisce le regole per determinare lo scostamento in un dato istante; uno scostamento da solo non descrive i cambiamenti dell’ora legale.
ZoneOffset.UTC rappresenta lo scostamento zero; getId() restituisce Z per questo valore. Metodi factory come of("+02:00") e ofHoursMinutes(-5, -30) creano altri valori. Le componenti diverse da zero devono avere lo stesso segno. L’intervallo va da -18:00 a +18:00, estremi inclusi; un valore non valido causa una DateTimeException.
Le istanze sono immutabili e thread-safe. Confrontale con equals, non con ==, e non usarle come lock di sincronizzazione. L’esempio mostra identificatori normalizzati, uno scostamento in secondi e l’uguaglianza tra due rappresentazioni dello scostamento zero.
Esempi
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")));
}
}Risultato
Z -05:30 -19800 true
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.