Baza znanjaIzpitno središče
SLSlovenščina
Izberi jezik13

CKTIS / Java

ZonedDateTime: isti trenutek ali isti lokalni čas?

V Javi 21 ustvari datum in čas s časovnim pasom, izrecno izberi vsako od dveh pojavitev ponovljenega časa ter ob menjavi pasu ohrani trenutek ali prikaz na uri.

Različica: Java SE 21

Sintaksa

java.time.ZonedDateTime — Java SE 21

public static ZonedDateTime of(LocalDateTime localDateTime, ZoneId zone)
public static ZonedDateTime of(LocalDate date, LocalTime time, ZoneId zone)
public static ZonedDateTime of(int year, int month, int dayOfMonth, int hour, int minute, int second, int nanoOfSecond, ZoneId zone)
public static ZonedDateTime ofLocal(LocalDateTime localDateTime, ZoneId zone, ZoneOffset preferredOffset)
public ZonedDateTime withZoneSameInstant(ZoneId zone)
public ZonedDateTime withZoneSameLocal(ZoneId zone)

java.time.ZonedDateTime združuje lokalni datum in čas z identifikatorjem časovnega pasu (ZoneId) in odmikom od UTC (ZoneOffset). Instant je točka na časovnici. Lokalni datum in čas sta podatka, ki ju kažeta koledar in ura; v danem pasu lahko označujeta dva različna trenutka.

ZonedDateTime.of je statična tovarniška metoda s tremi preobremenitvami: sprejme LocalDateTime, par LocalDate in LocalTime ali sedem številskih polj, vselej skupaj z ZoneId. Če je veljaven le en odmik, uporabi tega. Pri prekrivanju, ko se lokalni interval ponovi, izbere odmik prve pojavitve. V vrzeli, ko je lokalni interval preskočen, lokalni datum in čas premakne naprej za dolžino vrzeli in uporabi odmik po prehodu. Neveljavna datumska ali časovna polja v številski preobremenitvi povzročijo DateTimeException.

ZonedDateTime.ofLocal(localDateTime, zone, preferredOffset) je statična tovarniška metoda. Pri prekrivanju uporabi želeni odmik samo, če je eden od dveh veljavnih; pri null ali neujemajočem se odmiku izbere prvo pojavitev. Pri enem veljavnem odmiku ali v vrzeli se obnaša kot of. Nastavitev želenega odmika ni preverjanje veljavnosti: če mora aplikacija zavrniti vrzeli ali pri prekrivanju zahtevati izrecno izbiro, preveri zone.getRules().getValidOffsets(localDateTime), ki vrne 0, 1 ali 2 odmika.

ZonedDateTime.withZoneSameInstant(zone) prikaže isti dogodek v drugem pasu: vrednost toInstant() ostane enaka, tudi če se lokalni datum ali čas spremeni. Lokalnih vrzeli in prekrivanj ni treba razreševati; rezultat zunaj podprtega obsega datumov povzroči DateTimeException. ZonedDateTime.withZoneSameLocal(zone) isti datum in čas razume kot lokalna v ciljnem pasu, zato se trenutek lahko spremeni. Upošteva pravila ofLocal, pri čemer kot želeni odmik uporabi trenutnega. V vrzeli ne more ohraniti prvotnega lokalnega datuma in časa. Nobena metoda ne spremeni izvornega objekta.

Primeri

import java.time.LocalDateTime;
import java.time.ZoneId;
import java.time.ZoneOffset;
import java.time.ZonedDateTime;

public class ZonedDateTimeTransform {
    public static void main(String[] args) {
        ZoneId paris = ZoneId.of("Europe/Paris");
        LocalDateTime wallTime = LocalDateTime.of(2024, 10, 27, 2, 30);

        ZonedDateTime defaultChoice = ZonedDateTime.of(wallTime, paris);
        ZonedDateTime earlier = ZonedDateTime.ofLocal(wallTime, paris, ZoneOffset.ofHours(2));
        ZonedDateTime later = ZonedDateTime.ofLocal(wallTime, paris, ZoneOffset.ofHours(1));

        System.out.println("of: " + defaultChoice);
        System.out.println("ofLocal +02:00: " + earlier + " -> " + earlier.toInstant());
        System.out.println("ofLocal +01:00: " + later + " -> " + later.toInstant());
        System.out.println("same instant: " + earlier.withZoneSameInstant(ZoneOffset.UTC));
        System.out.println("same local: " + earlier.withZoneSameLocal(ZoneOffset.UTC));
    }
}

Rezultat

of: 2024-10-27T02:30+02:00[Europe/Paris]
ofLocal +02:00: 2024-10-27T02:30+02:00[Europe/Paris] -> 2024-10-27T00:30:00Z
ofLocal +01:00: 2024-10-27T02:30+01:00[Europe/Paris] -> 2024-10-27T01:30:00Z
same instant: 2024-10-27T00:30Z
same local: 2024-10-27T02:30Z

Po pravilih za `Europe/Paris`, uporabljenih v primeru, se `02:30` pojavi dvakrat: pri `+02:00` pomeni `00:30Z`, pri `+01:00` pa `01:30Z`. `of` izbere prvo pojavitev; klica `ofLocal` izrecno izbereta oba odmika. Pri pretvorbi prve pojavitve v UTC dobiš `00:30Z`, če ohraniš trenutek, ali `02:30Z`, če ohraniš prikaz na uri. Rezultati za regionalni pas so odvisni od pravil, ki so na voljo v izvajalnem okolju.

Povezane lekcije

  • Java · Lekcija 60 · Napredna · Različica: 2

Viri