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

CKTIS / Java

LocalDate — дата без час и часова зона

LocalDate представя неизменна дата от ISO календара без час и часова зона. Позволява създаване, преместване, сравняване, анализиране и форматиране на дати.

Версия: Java SE 21; repository runtime, production runtime not attested

Синтаксис

LocalDate.of(year, month, dayOfMonth)
date.plusDays(days)
date.isAfter(other)
date.toString()
date.equals(other)
date.compareTo(other)
date.with(adjuster)
date.with(field, newValue)
date.atTime(hour, minute)
LocalDate.parse(text)
LocalDate.parse(text, formatter)
date.format(formatter)

java.time.LocalDate съхранява дата от ISO календара без час и часова зона; самостоятелно тя не определя момент от времевата линия. Неизменна е и е безопасна за използване в нишки. LocalDate.of(year, month, dayOfMonth) създава дата; месеците се номерират от 1 до 12. Невалидна дата причинява DateTimeException.

LocalDate.plusDays връща резултата от добавянето на дни, като отчита границите на месеците и високосните години; оригиналният обект остава непроменен. LocalDate.with(adjuster) прилага правило за корекция, а LocalDate.with(field, newValue) задава поле. Обработката на невалиден ден зависи от полето: промяната на месеца може да ограничи деня до края на месеца, но невалиден DAY_OF_MONTH причинява изключение.

LocalDate.isAfter проверява дали дадена дата е по-късна. LocalDate.equals сравнява стойностите на дати от тип LocalDate, а не идентичността на обектите — не го заменяйте с ==. За два обекта LocalDate LocalDate.compareTo връща отрицателно число, нула или положително число според реда на датите; не приемайте, че резултатът е точно -1 или 1.

LocalDate.parse(text) прочита ISO дата; претовареният вариант с formatter поддържа друг формат. Грешка при анализиране причинява DateTimeParseException. LocalDate.toString връща ISO текст, докато LocalDate.format(formatter) използва зададения formatter. В шаблона dd/MM/uuuu uuuu означава година, а не година от ерата (yyyy).

LocalDate.atTime(hour, minute) създава LocalDateTime, все още без часова зона; претовареният вариант с OffsetTime връща OffsetDateTime. Примерът използва фиксирани дати и показва 29 февруари 2024 г. Обхват на документацията: Java SE 21; производствената среда не е потвърдена.

Примери

import java.time.LocalDate;
import java.time.format.DateTimeFormatter;
import java.time.temporal.TemporalAdjusters;

public class Main {
    public static void main(String[] args) {
        LocalDate start = LocalDate.of(2024, 2, 28);
        LocalDate next = start.plusDays(1);
        LocalDate parsed = LocalDate.parse("2024-02-29");
        DateTimeFormatter formatter = DateTimeFormatter.ofPattern("dd/MM/uuuu");

        System.out.println(start.toString());
        System.out.println(next.toString());
        System.out.println(next.isAfter(start));
        System.out.println(next.equals(parsed));
        System.out.println(start.compareTo(next) < 0);
        System.out.println(start.with(TemporalAdjusters.lastDayOfMonth()));
        System.out.println(next.atTime(9, 30));
        System.out.println(next.format(formatter));
    }
}

Резултат

2024-02-28
2024-02-29
true
true
true
2024-02-29
2024-02-29T09:30
29/02/2024

Показаният код и заявеният резултат са проверени в изолирана среда по метода, записан в доказателството за проверка на тази точна версия.

Източници