CKTIS / Java
ZonedDateTime: ustvarjanje, pretvorbe, oblikovanje in koledarske spremembe
Ustvari datum in čas s časovnim pasom, pretvori ju brez spremembe trenutka, oblikuj izpis in spremeni lokalna polja ob upoštevanju premikov ure.
Različica: Java SE 21
Sintaksa
java.time.ZonedDateTime — Java SE 21
static ZonedDateTime of(LocalDateTime dateTime, ZoneId zone)
static ZonedDateTime of(LocalDate date, LocalTime time, ZoneId zone)
static ZonedDateTime of(int year, int month, int dayOfMonth, int hour, int minute, int second, int nanoOfSecond, ZoneId zone)
static ZonedDateTime ofInstant(Instant instant, ZoneId zone)
static ZonedDateTime ofInstant(LocalDateTime dateTime, ZoneOffset offset, ZoneId zone)
Instant toInstant() // inherited from ChronoZonedDateTime
ZonedDateTime withZoneSameInstant(ZoneId zone)
String format(DateTimeFormatter formatter)
ZonedDateTime with(TemporalAdjuster adjuster)
ZonedDateTime with(TemporalField field, long newValue)
ZonedDateTime withHour(int hour)
ZonedDateTime withMinute(int minute)java.time.ZonedDateTime hrani krajevni datum in čas, identifikator časovnega pasu in določeni odmik od UTC. Statična metoda ZonedDateTime.of sprejme LocalDateTime, par LocalDate in LocalTime ali sedem celih števil (od year do nanoOfSecond), vedno z ZoneId. Če krajevni čas pade v vrzel, ki nastane ob premiku ure naprej, ga metoda pomakne naprej za dolžino vrzeli. Če se krajevni čas ponovi, izbere odmik, ki ustreza zgodnejšemu trenutku. Neveljavna številska polja ali nemogoč datum povzročijo DateTimeException.
ZonedDateTime.ofInstant(Instant, ZoneId) določi krajevni datum, čas in odmik za podani trenutek v ciljnem pasu. Preobremenjena oblika (LocalDateTime, ZoneOffset, ZoneId) najprej iz podanega krajevnega datuma, časa in odmika določi trenutek, nato pa ga izrazi v ciljnem pasu. Krajevni čas in odmik se lahko razlikujeta od vhodnih vrednosti. Podedovana metoda ZonedDateTime.toInstant() vrne isti trenutek brez podatka o pasu. ZonedDateTime.withZoneSameInstant(ZoneId) ohrani trenutek, lahko pa spremeni krajevni datum in čas. Nasprotno withZoneSameLocal poskuša ohraniti krajevni datum in čas ter lahko spremeni trenutek.
ZonedDateTime.format(DateTimeFormatter) vrne String, ne da bi spremenil objekt. ISO_OFFSET_DATE_TIME izpiše krajevni datum, čas in odmik, ne pa identifikatorja območnega časovnega pasu. Če oblikovanje ne uspe, metoda sproži DateTimeException.
ZonedDateTime.with(TemporalAdjuster) uporabi pravilo, na primer TemporalAdjusters.lastDayOfMonth(). Preobremenjena oblika with(TemporalField, long) nastavi podprto polje, na primer ChronoField.MONTH_OF_YEAR. INSTANT_SECONDS nastavi sekundo na časovni premici ter ohrani pas in del sekunde. OFFSET_SECONDS lahko le preklopi na drugi veljavni odmik, kadar se krajevni čas ponovi. Nepodprto polje lahko sproži UnsupportedTemporalTypeException, neveljavna vrednost pa DateTimeException.
ZonedDateTime.withHour(int) nastavi uro (0–23), ZonedDateTime.withMinute(int) pa minuto (0–59); nobena metoda ne prišteva pretečenega časa. Vrednost zunaj obsega povzroči DateTimeException. Pri urejanju krajevnih polj pas ostane isti, trenutek pa se lahko spremeni. V vrzeli se rezultat pomakne naprej za njeno dolžino. Ob ponovitvi časa se prejšnji odmik ohrani, če je veljaven; sicer se izbere zgodnejši trenutek. Objekti so nespremenljivi, zato shrani vrnjeni rezultat.
Primeri
import java.time.Instant;
import java.time.LocalDateTime;
import java.time.ZoneOffset;
import java.time.ZonedDateTime;
import java.time.format.DateTimeFormatter;
import java.time.temporal.ChronoField;
import java.time.temporal.TemporalAdjusters;
public class Main {
public static void main(String[] args) {
ZoneOffset east = ZoneOffset.of("+01:00");
ZoneOffset west = ZoneOffset.of("-05:00");
DateTimeFormatter iso = DateTimeFormatter.ISO_OFFSET_DATE_TIME;
ZonedDateTime original = ZonedDateTime.of(
LocalDateTime.of(2024, 1, 15, 10, 30), east);
Instant instant = original.toInstant();
ZonedDateTime converted = original.withZoneSameInstant(west);
ZonedDateTime rebuilt = ZonedDateTime.ofInstant(instant, west);
ZonedDateTime edited = original.with(ChronoField.MONTH_OF_YEAR, 2)
.with(TemporalAdjusters.lastDayOfMonth())
.withHour(14)
.withMinute(45);
System.out.println(original.format(iso));
System.out.println(instant);
System.out.println(converted.format(iso));
System.out.println(converted.equals(rebuilt));
System.out.println(edited.format(iso));
}
}Rezultat
2024-01-15T10:30:00+01:00 2024-01-15T09:30:00Z 2024-01-15T04:30:00-05:00 true 2024-02-29T14:45:00+01:00
Prve tri vrstice prikazujejo isti trenutek. `true` kaže, da se obe pretvorbi v `-05:00` ujemata. Zadnja vrstica prikazuje spremembo na 29. februar ob 14:45 s prvotnim odmikom. Zaradi stalnih odmikov primer ni odvisen od pravil območnih časovnih pasov.
Povezane lekcije
- Java · Lekcija 59 · Srednja · Različica: 2