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

CKTIS / Java

LocalDate: създаване, изместване, сравняване и показване на дати

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

Версия: Java SE 21

Синтаксис

import java.time.LocalDate;
import java.time.Month;
import java.time.chrono.ChronoLocalDate;

// Method signatures on LocalDate (Java SE 21)
public static LocalDate of(int year, int month, int dayOfMonth)
public static LocalDate of(int year, Month month, int dayOfMonth)
public LocalDate plusDays(long daysToAdd)
public boolean isAfter(ChronoLocalDate other)
public String toString()

java.time.LocalDate представя дата от календара ISO без час и часова зона. Статичният фабричен метод LocalDate.of приема година, месец и ден от месеца в този ред. Подай месеца като int от 1 до 12 или като стойност от тип Month, различна от null, например Month.FEBRUARY. Невалидна дата като 29 февруари в невисокосна година не се коригира: методът хвърля DateTimeException.

date.plusDays(n) приема брой календарни дни от тип long и връща получената дата, при нужда в друг месец или година. Отрицателна стойност измества датата назад, а нулата запазва стойността ѝ. LocalDate е неизменяем: извикването не променя date, затова запази или използвай върнатата стойност. Ако при изчислението няма препълване, но получената дата е извън поддържания диапазон, методът хвърля DateTimeException, както при LocalDate.MAX.plusDays(1). В JDK 21, ако междинният сбор на броя дни от епохата и добавените дни излезе извън границите на типа long, методът хвърля ArithmeticException преди проверката на диапазона от дати.

a.isAfter(b) връща true само ако a е по-късна от b. Ако a е по-ранна или двете представят един и същ ден, методът връща false. Параметърът е от тип ChronoLocalDate и b не може да бъде null. Сравняват се позициите на датите по локалната времева ос, без да се отчита календарната им система.

date.toString() връща String във формат ISO-8601 uuuu-MM-dd, например 2024-03-01. Методът не отпечатва нищо и не приспособява текста към регионалните настройки. За формат, съобразен с читателя, използвай format с подходящ DateTimeFormatter.

Примери

import java.time.LocalDate;

public class Main {
    public static void main(String[] args) {
        LocalDate start = LocalDate.of(2024, 2, 28);
        LocalDate later = start.plusDays(2);

        System.out.println(start.toString());
        System.out.println(later.toString());
        System.out.println(later.isAfter(start));
        System.out.println(later.isAfter(later));
    }
}

Резултат

2024-02-28
2024-03-01
true
false

2024 г. е високосна, така че два дни след `2024-02-28` е `2024-03-01`. Първият ред показва, че началната дата не се е променила; последните два показват, че резултатът е по-късен от началната дата, но не е по-късен от самия себе си.

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

  • Java · Урок 68 · Начално · Версия: 2

Източници