База знанияИзпитен център
BGБългарски
Избери език13

CKTIS / Java

Разчитане, създаване и форматиране на дати и дати с час в Java

Създавайте дати от отделни полета, разчитайте текст във формат ISO или по собствен шаблон и форматирайте дати и дати с час, без да задавате часова зона.

Версия: Java SE 21

Синтаксис

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: LocalDateTime

В пакета java.time типът LocalDate представлява само дата по ISO, а LocalDateTime съчетава дата по ISO с местно време. Нито един от двата типа не съхранява часова зона или отместване спрямо UTC и сам по себе си не определя еднозначен момент. И двата типа са неизменяеми.

LocalDate.of(year, month, dayOfMonth) е статичен фабричен метод, който приема номер на месец от 1 до 12 или константа Month. Статичният фабричен метод LocalDateTime.of(date, time) съчетава LocalDate и LocalTime. Претоварените варианти с отделни полета приемат номер на месец или Month, изискват час и минута и позволяват да добавите секунда, а след нея и наносекунда. Пропусната секунда или наносекунда има стойност нула. Невалидни стойности на полетата, например 29 февруари в невисокосна година, предизвикват DateTimeException.

Статичният метод LocalDate.parse(text) използва DateTimeFormatter.ISO_LOCAL_DATE, например за 2024-02-29. Претовареният вариант LocalDate.parse(text, formatter) използва подадения форматиращ обект, например с шаблон dd/MM/uuuu. Ако текстът не може да бъде разчетен като дата, се хвърля DateTimeParseException. По подразбиране DateTimeFormatter.ofPattern използва SMART, който може да коригира 29/02/2023 на 28 февруари. За да отхвърляте такива дати, задайте ResolverStyle.STRICT и използвайте uuuu (година), а не yyyy (година от ерата).

Методите на екземпляра LocalDate.format(formatter) и LocalDateTime.format(formatter) връщат String чрез подадения форматиращ обект, без да променят стойността. Ако липсва необходимо поле, например часът за HH:mm при LocalDate, форматирането хвърля DateTimeException. LocalDate.toString() не приема форматиращ обект и връща текст във формат ISO-8601, например 2024-02-29. В шаблоните главните и малките букви имат значение: MM означава месец, mm — минута, а HH — час в 24-часов формат.

Примери

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");
        }
    }
}

Резултат

true
2024-02-29
29/02/2024
29/02/2024 09:05
Invalid date rejected

Първият ред потвърждава, че и двете разчетени стойности съвпадат с датата от фабричния метод. Следващите три реда показват датата по ISO, датата в собствен формат и датата с час. Последният показва, че строгото разчитане отхвърля 29 февруари 2023 г.

Свързани уроци

  • Java · Урок 61 · Напреднало · Версия: 2

Източници