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

CKTIS / Java

LocalDate.of — създаване на дата от година, месец и ден

Създайте дата по ISO от три полета, изберете подходящия претоварен вариант и сравнявайте датите по стойност с `equals`, а не по референция с `==`.

Версия: Java SE 21

Синтаксис

public static LocalDate of(int year, int month, int dayOfMonth)
public static LocalDate of(int year, Month month, int dayOfMonth)

LocalDate.of е статичен фабричен метод на java.time.LocalDate. Приема година, месец и ден от месеца в този ред. Връща неизменяема дата от календара ISO-8601, без час и часова зона. За разлика от LocalDate.now(), не чете часовника.

Вторият аргумент е int от 1 (януари) до 12 (декември) или константа от изброимия тип java.time.Month, например Month.JANUARY. Годината трябва да е от -999999999 до 999999999 включително. Денят трябва да е от 1 до 31 и да съществува в посочените месец и година. Стойност извън диапазона или несъществуваща дата като 29 февруари 2019 г. води до DateTimeException; методът не коригира датата. Подаването на null вместо Month води до NullPointerException.

LocalDate е клас, базиран на стойности. Две извиквания за 2020-01-01 дават дати, които са равни според equals, но няма гаранция, че върнатите обекти са отделни. == сравнява референции, а не дати. Не използвайте екземпляри на LocalDate за синхронизация.

Примери

import java.time.DateTimeException;
import java.time.LocalDate;
import java.time.Month;

public class Main {
    public static void main(String[] args) {
        final int year = 2020;
        LocalDate january = LocalDate.of(year, 1, 1);
        LocalDate sameJanuary = LocalDate.of(year, Month.JANUARY, 1);
        LocalDate june = LocalDate.of(year, Month.JUNE, 1);
        LocalDate july = LocalDate.of(year, 7, 1);
        LocalDate previousDecember = LocalDate.of(year - 1, Month.DECEMBER, 31);

        System.out.println(january);
        System.out.println(june);
        System.out.println(july);
        System.out.println(previousDecember);
        System.out.println(january.equals(sameJanuary));

        try {
            LocalDate.of(year - 1, Month.FEBRUARY, 29);
        } catch (DateTimeException e) {
            System.out.println("DateTimeException");
        }
    }
}

Резултат

2020-01-01
2020-06-01
2020-07-01
2019-12-31
true
DateTimeException

Програмата извежда фиксирани дати през януари, юни и юли 2020 г. и дата през декември на предходната година, изчислена с `year - 1`. Двата варианта дават една и съща дата през януари, затова `equals` връща `true`. Тъй като 2019 г. не е високосна, блокът `catch` извежда `DateTimeException`.

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

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

Източници