CKTIS / Java
Načítavanie, vytváranie a formátovanie dátumu a dátumu s časom v Jave
Vytvárajte dátumy z jednotlivých polí, načítavajte text vo formáte ISO alebo podľa vlastného vzoru a formátujte dátum a čas bez priradenia časového pásma.
Verzia: Java SE 21
Syntax
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 balíku java.time predstavuje LocalDate samotný dátum ISO, kým LocalDateTime spája dátum ISO s miestnym časom. Ani jeden typ neukladá časové pásmo ani posun voči UTC a sám osebe neurčuje jednoznačný okamih. Oba typy sú nemenné.
LocalDate.of(year, month, dayOfMonth) je statická továrenská metóda, ktorá prijíma číslo mesiaca od 1 do 12 alebo konštantu Month. Statická továrenská metóda LocalDateTime.of(date, time) spája LocalDate a LocalTime. Preťažené varianty s jednotlivými poľami prijímajú číslo mesiaca alebo Month, vyžadujú hodinu a minútu a umožňujú pridať sekundu a potom nanosekundu. Vynechaná sekunda alebo nanosekunda má hodnotu nula. Neplatné hodnoty polí, napríklad 29. február v nepriestupnom roku, vyvolajú DateTimeException.
Statická metóda LocalDate.parse(text) používa DateTimeFormatter.ISO_LOCAL_DATE, napríklad pre 2024-02-29. Preťažený variant LocalDate.parse(text, formatter) používa odovzdaný formátovač, napríklad so vzorom dd/MM/uuuu. Ak text nemožno previesť na dátum, vyvolá sa DateTimeParseException. DateTimeFormatter.ofPattern predvolene používa SMART, ktorý môže upraviť 29/02/2023 na 28. februára. Ak chcete také dátumy odmietať, nastavte ResolverStyle.STRICT a použite uuuu (rok), nie yyyy (rok éry).
Inštančné metódy LocalDate.format(formatter) a LocalDateTime.format(formatter) vracajú pomocou odovzdaného formátovača String bez zmeny hodnoty. Ak chýba požadované pole, napríklad hodina pre HH:mm pri LocalDate, formátovanie vyvolá DateTimeException. LocalDate.toString() neprijíma formátovač a vracia text ISO-8601, napríklad 2024-02-29. Vo vzoroch záleží na veľkosti písmen: MM znamená mesiac, mm minútu a HH hodinu v 24-hodinovom formáte.
Príklady
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");
}
}
}Výsledok
true 2024-02-29 29/02/2024 29/02/2024 09:05 Invalid date rejected
Prvý riadok potvrdzuje, že obe načítané hodnoty sa rovnajú dátumu z továrenskej metódy. Ďalšie tri riadky ukazujú dátum ISO, dátum vo vlastnom formáte a dátum s časom. Posledný ukazuje, že striktné načítavanie odmietne 29. február 2023.
Súvisiace lekcie
- Java · Lekcia 61 · Pokročilá · Verzia: 2