CKTIS / Java
ZoneOffset — een vaste offset ten opzichte van UTC
ZoneOffset beschrijft een vaste offset ten opzichte van UTC, niet de regels van een regionale tijdzone. ZoneOffset.UTC staat voor de nul-offset, met Z als identificatie.
Versie: Java SE 21; repository runtime, production runtime not attested
Syntax
ZoneOffset.UTC
ZoneOffset.of("+02:00")
ZoneOffset.ofHoursMinutes(-5, -30)
offset.getId()
offset.getTotalSeconds()java.time.ZoneOffset vertegenwoordigt een vast verschil ten opzichte van UTC, bijvoorbeeld +02:00. Het slaat geen datum en geen tijd op. Een regionale ZoneId, zoals Europe/Paris, bepaalt de regels om de offset op een bepaald moment te vinden; een offset op zichzelf beschrijft geen veranderingen door zomertijd.
ZoneOffset.UTC staat voor de nul-offset; getId() geeft daarvoor Z terug. Fabriekmethoden zoals of("+02:00") en ofHoursMinutes(-5, -30) maken andere waarden aan. Niet-nulcomponenten moeten hetzelfde teken hebben. Het bereik loopt inclusief van -18:00 tot +18:00; een ongeldige waarde veroorzaakt een DateTimeException.
Instanties zijn onveranderlijk en thread-safe. Vergelijk ze met equals, niet met ==, en gebruik ze niet als synchronisatievergrendeling. Het voorbeeld toont genormaliseerde identificaties, een offset in seconden en de gelijkheid van twee schrijfwijzen voor de nul-offset.
Voorbeelden
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")));
}
}Resultaat
Z -05:30 -19800 true
De getoonde code en het opgegeven resultaat zijn in een geïsoleerde omgeving geverifieerd met de methode die in het verificatiebewijs voor exact deze versie is vastgelegd.