CKTIS / Java
Razčlenjevanje, ustvarjanje in oblikovanje datumov ter datumov s časom v Javi
Ustvarjajte datume iz posameznih polj, razčlenjujte besedilo v zapisu ISO ali po lastnem vzorcu in oblikujte datume s časom ali brez njega, ne da bi določili časovni pas.
Različica: Java SE 21
Sintaksa
Java SE 21 — java.time.LocalDate and java.time.LocalDateTime; formatter type: java.time.format.DateTimeFormatter
Static factory and parsing methods:
LocalDate LocalDate.of(int year, int month, int dayOfMonth)
LocalDate LocalDate.of(int year, Month month, int dayOfMonth)
LocalDate LocalDate.parse(CharSequence text)
LocalDate LocalDate.parse(CharSequence text, DateTimeFormatter formatter)
LocalDateTime LocalDateTime.of(LocalDate date, LocalTime time)
LocalDateTime LocalDateTime.of(int year, int month, int dayOfMonth, int hour, int minute)
LocalDateTime.of also accepts java.time.Month instead of an int month. Both component-based forms have overloads with a trailing int second or with trailing int second, int nanoOfSecond.
Instance methods:
String date.format(DateTimeFormatter formatter) // date: LocalDate
String date.toString() // date: LocalDate
String dateTime.format(DateTimeFormatter formatter) // dateTime: LocalDateTimeV paketu java.time predstavlja LocalDate samo datum ISO, LocalDateTime pa združuje datum ISO z lokalnim časom. Noben tip ne hrani časovnega pasu ali odmika od UTC in sam po sebi ne določa enoličnega trenutka. Oba tipa sta nespremenljiva.
LocalDate.of(year, month, dayOfMonth) je statična tovarniška metoda, ki sprejme številko meseca od 1 do 12 ali konstanto Month. Statična tovarniška metoda LocalDateTime.of(date, time) združi LocalDate in LocalTime. Preobremenjene različice s posameznimi polji sprejmejo številko meseca ali Month, zahtevajo uro in minuto ter omogočajo dodajanje sekunde in nato nanosekunde. Izpuščena sekunda ali nanosekunda ima vrednost nič. Neveljavne vrednosti polj, na primer 29. februar v neprestopnem letu, sprožijo DateTimeException.
Statična metoda LocalDate.parse(text) uporablja DateTimeFormatter.ISO_LOCAL_DATE, na primer za 2024-02-29. Preobremenjena različica LocalDate.parse(text, formatter) uporabi podani oblikovalnik, na primer z vzorcem dd/MM/uuuu. Če besedila ni mogoče razčleniti v datum, se sproži DateTimeParseException. DateTimeFormatter.ofPattern privzeto uporablja SMART, ki lahko 29/02/2023 popravi na 28. februar. Če želite takšne datume zavrniti, nastavite ResolverStyle.STRICT in uporabite uuuu (leto), ne yyyy (leto znotraj ere).
Metodi primerka LocalDate.format(formatter) in LocalDateTime.format(formatter) s podanim oblikovalnikom vrneta String, ne da bi spremenili vrednost. Če zahtevano polje ni na voljo, na primer ura za HH:mm pri LocalDate, oblikovanje sproži DateTimeException. LocalDate.toString() ne sprejme oblikovalnika in vrne besedilo ISO-8601, na primer 2024-02-29. Vzorci razlikujejo velike in male črke: MM pomeni mesec, mm minuto in HH uro v 24-urnem zapisu.
Primeri
import java.time.LocalDate;
import java.time.LocalDateTime;
import java.time.LocalTime;
import java.time.format.DateTimeFormatter;
import java.time.format.DateTimeParseException;
import java.time.format.ResolverStyle;
import java.util.Locale;
public class Main {
public static void main(String[] args) {
DateTimeFormatter dateFormat = DateTimeFormatter
.ofPattern("dd/MM/uuuu", Locale.ROOT)
.withResolverStyle(ResolverStyle.STRICT);
DateTimeFormatter dateTimeFormat = DateTimeFormatter
.ofPattern("dd/MM/uuuu HH:mm", Locale.ROOT);
LocalDate date = LocalDate.of(2024, 2, 29);
LocalDate fromIso = LocalDate.parse("2024-02-29");
LocalDate fromCustom = LocalDate.parse("29/02/2024", dateFormat);
System.out.println(date.equals(fromIso) && date.equals(fromCustom));
System.out.println(date.toString());
System.out.println(date.format(dateFormat));
LocalDateTime dateTime = LocalDateTime.of(date, LocalTime.of(9, 5));
System.out.println(dateTime.format(dateTimeFormat));
try {
LocalDate.parse("29/02/2023", dateFormat);
System.out.println("Unexpected success");
} catch (DateTimeParseException e) {
System.out.println("Invalid date rejected");
}
}
}Rezultat
true 2024-02-29 29/02/2024 29/02/2024 09:05 Invalid date rejected
Prva vrstica potrdi, da sta obe razčlenjeni vrednosti enaki datumu iz tovarniške metode. Naslednje tri vrstice prikažejo datum ISO, datum v lastnem zapisu ter datum s časom. Zadnja vrstica pokaže, da strogo razčlenjevanje zavrne 29. februar 2023.
Povezane lekcije
- Java · Lekcija 61 · Napredna · Različica: 2