Класс LocalDate

public static final LocalDate MIN

Минимально поддерживаемое значение LocalDate, '-999999999-01-01'. Приложение может использовать его как дату «далёкого прошлого».

public static final LocalDate MAX

Максимально поддерживаемое значение LocalDate, '+999999999-12-31'. Приложение может использовать его как дату «далёкого будущего».

public static final LocalDate EPOCH

Эпохальный год LocalDate, '1970-01-01'.

public static LocalDate now()

Получает текущую дату по системным часам в часовом поясе по умолчанию.

Для получения текущей даты выполняется запрос к system clock в часовом поясе по умолчанию.

Использование этого метода не позволяет применять альтернативные часы для тестирования, поскольку часы заданы жёстко.

public static LocalDate now(ZoneId zone)

Получает текущую дату по системным часам в указанном часовом поясе.

Для получения текущей даты выполняется запрос к system clock. Указание часового пояса позволяет избежать зависимости от часового пояса по умолчанию.

Использование этого метода не позволяет применять альтернативные часы для тестирования, поскольку часы заданы жёстко.

public static LocalDate now(Clock clock)

Получает текущую дату по указанным часам.

Для получения текущей даты — сегодняшнего дня — выполняется запрос к указанным часам. Использование этого метода позволяет применять альтернативные часы для тестирования. Альтернативные часы можно создать с помощью dependency injection.

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

Создаёт экземпляр LocalDate на основе года, месяца и дня.

Возвращает LocalDate с указанными годом, месяцем и днём месяца. День должен быть допустимым для указанного года и месяца, иначе будет выброшено исключение.

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

Создаёт экземпляр LocalDate на основе года, месяца и дня.

Возвращает LocalDate с указанными годом, месяцем и днём месяца. День должен быть допустимым для указанного года и месяца, иначе будет выброшено исключение.

public static LocalDate ofYearDay(int year, int dayOfYear)

Создаёт экземпляр LocalDate на основе года и дня года.

Возвращает LocalDate с указанными годом и днём года. День года должен быть допустимым для указанного года, иначе будет выброшено исключение.

public static LocalDate ofInstant(Instant instant, ZoneId zone)

Создаёт экземпляр LocalDate на основе объекта Instant и идентификатора часового пояса.

Создаёт локальную дату на основе указанного момента времени. Сначала по идентификатору часового пояса и моменту времени определяется смещение относительно UTC/Гринвича. Это просто, поскольку для каждого момента времени допустимо только одно смещение. Затем момент времени и смещение используются для вычисления локальной даты.

public static LocalDate ofEpochDay(long epochDay)

Создаёт экземпляр LocalDate на основе количества дней эпохи.

Возвращает LocalDate с указанным днём эпохи. EPOCH_DAY — это простой возрастающий отсчёт дней, в котором день 0 соответствует 1970-01-01. Отрицательные числа обозначают более ранние дни.

public static LocalDate from(TemporalAccessor temporal)

Создаёт экземпляр LocalDate на основе временного объекта.

Получает локальную дату на основе указанного временного объекта. TemporalAccessor представляет произвольный набор сведений о дате и времени, который эта фабрика преобразует в экземпляр LocalDate.

Для преобразования используется запрос TemporalQueries.localDate(), основанный на извлечении поля EPOCH_DAY.

Сигнатура этого метода соответствует функциональному интерфейсу TemporalQuery, что позволяет использовать его как запрос через ссылку на метод, LocalDate::from.

public static LocalDate parse(CharSequence text)

Создаёт экземпляр LocalDate на основе текстовой строки, например 2007-12-03.

Строка должна представлять допустимую дату и разбирается с помощью DateTimeFormatter.ISO_LOCAL_DATE.

public static LocalDate parse(CharSequence text, DateTimeFormatter formatter)

Создаёт экземпляр LocalDate на основе текстовой строки с использованием заданного форматировщика.

Текст разбирается с помощью форматировщика, в результате чего возвращается дата.

public boolean isSupported(TemporalField field)

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

Проверяет, можно ли запросить у этой даты значение указанного поля. Если результат — false, вызовы методов range, get и with(TemporalField, long) приведут к выбросу исключения.

Если поле является ChronoField, запрос реализуется здесь. Поддерживаются следующие поля:

• DAY_OF_WEEK
• ALIGNED_DAY_OF_WEEK_IN_MONTH
• ALIGNED_DAY_OF_WEEK_IN_YEAR
• DAY_OF_MONTH
• DAY_OF_YEAR
• EPOCH_DAY
• ALIGNED_WEEK_OF_MONTH
• ALIGNED_WEEK_OF_YEAR
• MONTH_OF_YEAR
• PROLEPTIC_MONTH
• YEAR_OF_ERA
• YEAR
• ERA

Для всех остальных экземпляров ChronoField возвращается false.

Если поле не является ChronoField, результат этого метода получается вызовом TemporalField.isSupportedBy(TemporalAccessor) с передачей this в качестве аргумента. Поддерживается ли поле, определяет само поле.

public boolean isSupported(TemporalUnit unit)

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

Проверяет, можно ли прибавить указанную единицу измерения к этой дате или вычесть её из неё. Если результат — false, вызовы методов plus(long, TemporalUnit) и minus приведут к выбросу исключения.

Если единица измерения является ChronoUnit, запрос реализуется здесь. Поддерживаются следующие единицы измерения:

• DAYS
• WEEKS
• MONTHS
• YEARS
• DECADES
• CENTURIES
• MILLENNIA
• ERAS

Для всех остальных экземпляров ChronoUnit возвращается false.

Если единица измерения не является ChronoUnit, результат этого метода получается вызовом TemporalUnit.isSupportedBy(Temporal) с передачей this в качестве аргумента. Поддерживается ли единица измерения, определяет сама единица.

public ValueRange range(TemporalField field)

Получает диапазон допустимых значений указанного поля.

Объект диапазона задаёт минимальное и максимальное допустимые значения поля. Эта дата используется для повышения точности возвращаемого диапазона. Если вернуть диапазон невозможно, поскольку поле не поддерживается или по какой-либо другой причине, выбрасывается исключение.

Если поле является ChronoField, запрос реализуется здесь. Метод supported fields возвращает соответствующие экземпляры диапазона. Для всех остальных экземпляров ChronoField выбрасывается исключение UnsupportedTemporalTypeException.

Если поле не является ChronoField, результат этого метода получается вызовом TemporalField.rangeRefinedBy(TemporalAccessor) с передачей this в качестве аргумента. Возможность получения диапазона определяется самим полем.

public int get(TemporalField field)

Получает значение указанного поля этой даты в виде int.

Запрашивает у этой даты значение указанного поля. Возвращаемое значение всегда находится в допустимом диапазоне значений этого поля. Если вернуть значение невозможно, поскольку поле не поддерживается или по какой-либо другой причине, выбрасывается исключение.

Если поле является ChronoField, запрос реализуется здесь. Метод supported fields возвращает допустимые для этой даты значения, кроме EPOCH_DAY и PROLEPTIC_MONTH, которые слишком велики для представления в int и приводят к выбросу исключения UnsupportedTemporalTypeException. Для всех остальных экземпляров ChronoField выбрасывается исключение UnsupportedTemporalTypeException.

Если поле не является ChronoField, результат этого метода получается вызовом TemporalField.getFrom(TemporalAccessor) с передачей this в качестве аргумента. Возможность получения значения и его смысл определяются самим полем.

public long getLong(TemporalField field)

Получает значение указанного поля этой даты в виде long.

Запрашивает у этой даты значение указанного поля. Если вернуть значение невозможно, поскольку поле не поддерживается или по какой-либо другой причине, выбрасывается исключение.

Если поле является ChronoField, запрос реализуется здесь. Метод supported fields возвращает допустимые для этой даты значения. Для всех остальных экземпляров ChronoField выбрасывается исключение UnsupportedTemporalTypeException.

Если поле не является ChronoField, результат этого метода получается вызовом TemporalField.getFrom(TemporalAccessor) с передачей this в качестве аргумента. Возможность получения значения и его смысл определяются самим полем.

public IsoChronology getChronology()

Получает хронологию этой даты — календарную систему ISO.

Chronology представляет используемую календарную систему. Календарная система ISO-8601 — современная гражданская календарная система, используемая сегодня в большинстве стран мира. Она эквивалентна пролептической григорианской календарной системе, в которой современные правила високосных лет применяются ко всему временному диапазону.

public IsoEra getEra()

Получает эру, соответствующую этой дате.

Официальный стандарт ISO-8601 не определяет эры, однако IsoChronology определяет. Он задаёт две эры: «CE» — начиная с первого года, и «BCE» — от нулевого года в прошлое. Поскольку даты до перехода от юлианского календаря к григорианскому не соответствуют историческим датам, граница между «BCE» и «CE» также не совпадает с общепринятой границей эр, которые часто обозначают «BC» и «AD».

Пользователям этого класса обычно следует игнорировать данный метод, поскольку он существует главным образом для выполнения контракта ChronoLocalDate, который необходим для поддержки японской календарной системы.

public int getYear()

Получает поле года.

Этот метод возвращает примитивное значение int, соответствующее году.

Возвращаемый этим методом год является пролептическим согласно get(YEAR). Чтобы получить год эры, используйте get(YEAR_OF_ERA).

public int getMonthValue()

Получает поле месяца года в диапазоне от 1 до 12.

Этот метод возвращает месяц в виде значения int в диапазоне от 1 до 12. В прикладном коде часто понятнее использовать перечисление Month, вызывая getMonth().

public Month getMonth()

Получает поле месяца года с помощью перечисления Month.

Этот метод возвращает для месяца элемент перечисления Month. Это позволяет избежать неоднозначности значений int. Если требуется доступ к примитивному значению int, перечисление предоставляет метод int value.

public int getDayOfMonth()

Получает поле дня месяца.

Этот метод возвращает примитивное значение int, соответствующее дню месяца.

public int getDayOfYear()

Получает поле дня года.

Этот метод возвращает примитивное значение int, соответствующее дню года.

public DayOfWeek getDayOfWeek()

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

Этот метод возвращает для дня недели элемент перечисления DayOfWeek. Это позволяет избежать неоднозначности значений int. Если требуется доступ к примитивному значению int, перечисление предоставляет метод int value.

Дополнительную информацию можно получить из DayOfWeek. В неё входят текстовые названия значений.

public boolean isLeapYear()

Проверяет, является ли год високосным согласно правилам пролептической календарной системы ISO.

Этот метод применяет действующие правила високосных лет ко всей временной шкале. В общем случае год является високосным, если он делится на четыре без остатка. Однако годы, делящиеся на 100, не являются високосными, за исключением годов, делящихся на 400.

Например, 1904 год является високосным, поскольку делится на 4. 1900 год не был високосным, поскольку делится на 100, однако 2000 год был високосным, поскольку делится на 400.

Вычисление является пролептическим: одни и те же правила применяются к далёкому будущему и далёкому прошлому. С исторической точки зрения это неточно, но соответствует стандарту ISO-8601.

public int lengthOfMonth()

Возвращает количество дней в месяце, представленном этой датой.

Возвращает количество дней в месяце. Например, для даты в январе возвращается 31.

public int lengthOfYear()

Возвращает количество дней в году, представленном этой датой.

Возвращает количество дней в году: 365 или 366.

public LocalDate with(TemporalAdjuster adjuster)

Возвращает копию этой даты с применённой корректировкой.

Возвращает LocalDate на основе этой даты с изменёнными значениями даты. Корректировка выполняется с помощью указанного объекта стратегии корректировки. Ознакомьтесь с документацией корректировщика, чтобы понять, какие изменения будут выполнены.

Простой корректировщик может изменить значение одного из полей, например года. Более сложный корректировщик может установить дату на последний день месяца.

Набор распространённых корректировок предоставляется классом TemporalAdjusters. Среди них — поиск «последнего дня месяца» и «следующей среды». Важные классы даты и времени также реализуют интерфейс TemporalAdjuster, например Month и MonthDay. Корректировщик отвечает за обработку особых случаев, таких как разная продолжительность месяцев и високосные годы.

Например, следующий код возвращает дату, соответствующую последнему дню июля:

 import static java.time.Month.*;
 import static java.time.temporal.TemporalAdjusters.*;

 result = localDate.with(JULY).with(lastDayOfMonth());

Результат этого метода получается вызовом метода TemporalAdjuster.adjustInto(Temporal) указанного корректировщика с передачей this в качестве аргумента.

Этот экземпляр неизменяем и не изменяется при вызове данного метода.

public LocalDate with(TemporalField field, long newValue)

Возвращает копию этой даты, в которой указанному полю присвоено новое значение.

Возвращает LocalDate на основе этой даты, в которой изменено значение указанного поля. Это можно использовать для изменения любого поддерживаемого поля, например года, месяца или дня месяца. Если установить значение невозможно, поскольку поле не поддерживается или по какой-либо другой причине, выбрасывается исключение.

В некоторых случаях изменение указанного поля может привести к недопустимой результирующей дате. Например, изменение месяца с 31 января на февраль сделает день месяца недопустимым. В таких случаях за разрешение даты отвечает поле. Обычно оно выбирает предыдущую допустимую дату, то есть в этом примере последний допустимый день февраля.

Если поле является ChronoField, корректировка выполняется здесь. Поддерживаемые поля ведут себя следующим образом:

• DAY_OF_WEEK — возвращает LocalDate с указанным днем недели. Дата корректируется не более чем на 6 дней вперед или назад в пределах недели с понедельника по воскресенье.
• ALIGNED_DAY_OF_WEEK_IN_MONTH — возвращает LocalDate с указанным выровненным днем недели. Дата корректируется до указанного выровненного дня недели в пределах месяца. Выровненные недели отсчитываются так, что первая неделя данного месяца начинается в первый день этого месяца. Это может привести к смещению даты не более чем на 6 дней в следующий месяц.
• ALIGNED_DAY_OF_WEEK_IN_YEAR — возвращает LocalDate с указанным выровненным днем недели. Дата корректируется до указанного выровненного дня недели в пределах года. Выровненные недели отсчитываются так, что первая неделя данного года начинается в первый день этого года. Это может привести к смещению даты не более чем на 6 дней в следующий год.
• DAY_OF_MONTH — возвращает LocalDate с указанным днем месяца. Месяц и год не изменяются. Если день месяца недопустим для данного года и месяца, выбрасывается DateTimeException.
• DAY_OF_YEAR — возвращает LocalDate с указанным днем года. Год не изменяется. Если день года недопустим для данного года, выбрасывается DateTimeException.
• EPOCH_DAY — возвращает LocalDate с указанным днем эпохи. Это полностью заменяет дату и эквивалентно ofEpochDay(long).
• ALIGNED_WEEK_OF_MONTH — возвращает LocalDate с указанной выровненной неделей месяца. Выровненные недели отсчитываются так, что первая неделя данного месяца начинается в первый день этого месяца. При корректировке дата перемещается целыми неделями, чтобы соответствовать указанной неделе. Результат будет иметь тот же день недели, что и эта дата. Это может привести к смещению даты на следующий месяц.
• ALIGNED_WEEK_OF_YEAR — возвращает LocalDate с указанной выровненной неделей года. Выровненные недели отсчитываются так, что первая неделя данного года начинается в первый день этого года. При корректировке дата перемещается целыми неделями, чтобы соответствовать указанной неделе. Результат будет иметь тот же день недели, что и эта дата. Это может привести к смещению даты на следующий год.
• MONTH_OF_YEAR — возвращает LocalDate с указанным месяцем года. Год не изменяется. День месяца также не изменяется, если только он не окажется недопустимым для нового месяца и года. В этом случае день месяца корректируется до наибольшего допустимого значения для нового месяца и года.
• PROLEPTIC_MONTH — возвращает LocalDate с указанным пролептическим месяцем. День месяца не изменяется, если только он не окажется недопустимым для нового месяца и года. В этом случае день месяца корректируется до наибольшего допустимого значения для нового месяца и года.
• YEAR_OF_ERA — возвращает LocalDate с указанным годом эры. Эра и месяц не изменяются. День месяца также не изменяется, если только он не окажется недопустимым для нового месяца и года. В этом случае день месяца корректируется до наибольшего допустимого значения для нового месяца и года.
• YEAR — возвращает LocalDate с указанным годом. Месяц не изменяется. День месяца также не изменяется, если только он не окажется недопустимым для нового месяца и года. В этом случае день месяца корректируется до наибольшего допустимого значения для нового месяца и года.
• ERA — возвращает LocalDate с указанной эрой. Год эры и месяц не изменяются. День месяца также не изменяется, если только он не окажется недопустимым для нового месяца и года. В этом случае день месяца корректируется до наибольшего допустимого значения для нового месяца и года.

Во всех случаях, если новое значение выходит за допустимый диапазон значений поля, выбрасывается DateTimeException.

Для всех остальных экземпляров ChronoField выбрасывается UnsupportedTemporalTypeException.

Если поле не является ChronoField, результат этого метода получается путем вызова TemporalField.adjustInto(Temporal, long) с передачей this в качестве аргумента. В этом случае поле определяет, следует ли корректировать момент времени и каким образом.

Этот экземпляр неизменяем, и вызов данного метода не влияет на него.

public LocalDate withYear(int year)

Возвращает копию этого LocalDate с измененным годом.

Если день месяца недопустим для этого года, он будет заменен последним допустимым днем месяца.

Этот экземпляр неизменяем, и вызов данного метода не влияет на него.

public LocalDate withMonth(int month)

Возвращает копию этого LocalDate с измененным месяцем года.

Если день месяца недопустим для этого года, он будет заменен последним допустимым днем месяца.

Этот экземпляр неизменяем, и вызов данного метода не влияет на него.

public LocalDate withDayOfMonth(int dayOfMonth)

Возвращает копию этого LocalDate с измененным днем месяца.

Если результирующая дата недопустима, выбрасывается исключение.

Этот экземпляр неизменяем, и вызов данного метода не влияет на него.

public LocalDate withDayOfYear(int dayOfYear)

Возвращает копию этого LocalDate с измененным днем года.

Если результирующая дата недопустима, выбрасывается исключение.

Этот экземпляр неизменяем, и вызов данного метода не влияет на него.

public LocalDate plus(TemporalAmount amountToAdd)

Возвращает копию этой даты с добавленной указанной величиной.

Возвращает LocalDate на основе этой даты с добавленной указанной величиной. Обычно величина представляет собой Period, но может иметь и другой тип, реализующий интерфейс TemporalAmount.

Вычисление делегируется объекту величины путем вызова TemporalAmount.addTo(Temporal). Реализация величины может выполнять сложение любым способом, однако обычно она вызывает plus(long, TemporalUnit). Чтобы определить, можно ли успешно добавить величину, обратитесь к документации ее реализации.

Этот экземпляр неизменяем, и вызов данного метода не влияет на него.

public LocalDate plus(long amountToAdd, TemporalUnit unit)

Возвращает копию этой даты с добавленной указанной величиной.

Возвращает LocalDate на основе этой даты с добавленной величиной в единицах указанной единицы измерения. Если добавить величину невозможно, поскольку единица измерения не поддерживается или по какой-либо другой причине, выбрасывается исключение.

В некоторых случаях добавление величины может привести к недопустимой результирующей дате. Например, добавление одного месяца к 31 января приведет к 31 февраля. В таких случаях за разрешение даты отвечает единица измерения. Обычно она выбирает предыдущую допустимую дату, то есть в этом примере последний допустимый день февраля.

Если поле является ChronoUnit, сложение выполняется здесь. Поддерживаемые поля ведут себя следующим образом:

• DAYS — возвращает LocalDate с добавленным указанным количеством дней. Эквивалентно plusDays(long).
• WEEKS — возвращает LocalDate с добавленным указанным количеством недель. Эквивалентно plusWeeks(long); продолжительность недели составляет 7 дней.
• MONTHS — возвращает LocalDate с добавленным указанным количеством месяцев. Эквивалентно plusMonths(long). День месяца не изменяется, если только он не окажется недопустимым для нового месяца и года. В этом случае день месяца корректируется до наибольшего допустимого значения для нового месяца и года.
• YEARS — возвращает LocalDate с добавленным указанным количеством лет. Эквивалентно plusYears(long). День месяца не изменяется, если только он не окажется недопустимым для нового месяца и года. В этом случае день месяца корректируется до наибольшего допустимого значения для нового месяца и года.
• DECADES — возвращает LocalDate с добавленным указанным количеством десятилетий. Эквивалентно вызову plusYears(long) с величиной, умноженной на 10. День месяца не изменяется, если только он не окажется недопустимым для нового месяца и года. В этом случае день месяца корректируется до наибольшего допустимого значения для нового месяца и года.
• CENTURIES — возвращает LocalDate с добавленным указанным количеством столетий. Эквивалентно вызову plusYears(long) с величиной, умноженной на 100. День месяца не изменяется, если только он не окажется недопустимым для нового месяца и года. В этом случае день месяца корректируется до наибольшего допустимого значения для нового месяца и года.
• MILLENNIA — возвращает LocalDate с добавленным указанным количеством тысячелетий. Эквивалентно вызову plusYears(long) с величиной, умноженной на 1 000. День месяца не изменяется, если только он не окажется недопустимым для нового месяца и года. В этом случае день месяца корректируется до наибольшего допустимого значения для нового месяца и года.
• ERAS — возвращает LocalDate с добавленным указанным количеством эр. Поддерживаются только две эры, поэтому величина должна быть равна единице, нулю или минус единице. Если величина не равна нулю, год изменяется так, чтобы год эры остался неизменным. День месяца не изменяется, если только он не окажется недопустимым для нового месяца и года. В этом случае день месяца корректируется до наибольшего допустимого значения для нового месяца и года.

Для всех остальных экземпляров ChronoUnit выбрасывается UnsupportedTemporalTypeException.

Если поле не является ChronoUnit, результат этого метода получается путем вызова TemporalUnit.addTo(Temporal, long) с передачей this в качестве аргумента. В этом случае единица измерения определяет, следует ли выполнять сложение и каким образом.

Этот экземпляр неизменяем, и вызов данного метода не влияет на него.

public LocalDate plusYears(long yearsToAdd)

Возвращает копию этого LocalDate с добавленным указанным количеством лет.

Этот метод добавляет указанную величину к полю года в три этапа:

1. Добавить введенное количество лет к полю года
2. Проверить, не будет ли результирующая дата недопустимой
3. При необходимости скорректировать день месяца до последнего допустимого дня

Например, добавление одного года к дате 2008-02-29 (високосный год) дало бы недопустимую дату 2009-02-29 (обычный год). Вместо возврата недопустимого результата выбирается последний допустимый день месяца — 2009-02-28.

Этот экземпляр неизменяем, и вызов данного метода не влияет на него.

public LocalDate plusMonths(long monthsToAdd)

Возвращает копию этого LocalDate с добавленным указанным количеством месяцев.

Этот метод добавляет указанную величину к полю месяца в три этапа:

1. Добавить введенное количество месяцев к полю месяца года
2. Проверить, не будет ли результирующая дата недопустимой
3. При необходимости скорректировать день месяца до последнего допустимого дня

Например, добавление одного месяца к дате 2007-03-31 дало бы недопустимую дату 2007-04-31. Вместо возврата недопустимого результата выбирается последний допустимый день месяца — 2007-04-30.

Этот экземпляр неизменяем, и вызов данного метода не влияет на него.

public LocalDate plusWeeks(long weeksToAdd)

Возвращает копию этого LocalDate с добавленным указанным количеством недель.

Этот метод добавляет указанную величину в неделях к полю дней, при необходимости увеличивая поля месяца и года, чтобы результат оставался допустимым. Результат становится недопустимым только при превышении максимального или минимального значения года.

Например, добавление одной недели к дате 2008-12-31 даст 2009-01-07.

Этот экземпляр неизменяем, и вызов данного метода не влияет на него.

public LocalDate plusDays(long daysToAdd)

Возвращает копию этого LocalDate с добавленным указанным количеством дней.

Этот метод добавляет указанную величину к полю дней, при необходимости увеличивая поля месяца и года, чтобы результат оставался допустимым. Результат становится недопустимым только при превышении максимального или минимального значения года.

Например, добавление одного дня к дате 2008-12-31 даст 2009-01-01.

Этот экземпляр неизменяем, и вызов данного метода не влияет на него.

public LocalDate minus(TemporalAmount amountToSubtract)

Возвращает копию этой даты с вычтенной указанной величиной.

Возвращает LocalDate на основе этой даты с вычтенной указанной величиной. Обычно величина представляет собой Period, но может иметь и другой тип, реализующий интерфейс TemporalAmount.

Вычисление делегируется объекту величины путем вызова TemporalAmount.subtractFrom(Temporal). Реализация величины может выполнять вычитание любым способом, однако обычно она вызывает minus(long, TemporalUnit). Чтобы определить, можно ли успешно вычесть величину, обратитесь к документации ее реализации.

Этот экземпляр неизменяем, и вызов данного метода не влияет на него.

public LocalDate minus(long amountToSubtract, TemporalUnit unit)

Возвращает копию этой даты с вычтенной указанной величиной.

Возвращает LocalDate на основе этой даты с вычтенной величиной в единицах указанной единицы измерения. Если вычесть величину невозможно, поскольку единица измерения не поддерживается или по какой-либо другой причине, выбрасывается исключение.

Этот метод эквивалентен plus(long, TemporalUnit) с величиной, взятой с противоположным знаком. Полное описание того, как работает сложение и, следовательно, вычитание, см. в документации этого метода.

Этот экземпляр неизменяем, и вызов данного метода не влияет на него.

public LocalDate minusYears(long yearsToSubtract)

Возвращает копию этого LocalDate с вычтенным указанным количеством лет.

Этот метод вычитает указанную величину из поля года в три этапа:

1. Вычесть введенное количество лет из поля года
2. Проверить, не будет ли результирующая дата недопустимой
3. При необходимости скорректировать день месяца до последнего допустимого дня

Например, вычитание одного года из даты 2008-02-29 (високосный год) дало бы недопустимую дату 2007-02-29 (обычный год). Вместо возврата недопустимого результата выбирается последний допустимый день месяца — 2007-02-28.

Этот экземпляр неизменяем, и вызов данного метода не влияет на него.

public LocalDate minusMonths(long monthsToSubtract)

Возвращает копию этого LocalDate с вычтенным указанным количеством месяцев.

Этот метод вычитает указанную величину из поля месяца в три этапа:

1. Вычесть введенное количество месяцев из поля месяца года
2. Проверить, не будет ли результирующая дата недопустимой
3. При необходимости скорректировать день месяца до последнего допустимого дня

Например, вычитание одного месяца из даты 2007-03-31 дало бы недопустимую дату 2007-02-31. Вместо возврата недопустимого результата выбирается последний допустимый день месяца — 2007-02-28.

Этот экземпляр неизменяем, и вызов данного метода не влияет на него.

public LocalDate minusWeeks(long weeksToSubtract)

Возвращает копию этого LocalDate с вычтенным указанным количеством недель.

Этот метод вычитает указанную величину в неделях из поля дней, при необходимости уменьшая поля месяца и года, чтобы результат оставался допустимым. Результат становится недопустимым только при превышении максимального или минимального значения года.

Например, вычитание одной недели из даты 2009-01-07 даст 2008-12-31.

Этот экземпляр неизменяем, и вызов данного метода не влияет на него.

public LocalDate minusDays(long daysToSubtract)

Возвращает копию этого LocalDate с вычтенным указанным количеством дней.

Этот метод вычитает указанную величину из поля дней, при необходимости уменьшая поля месяца и года, чтобы результат оставался допустимым. Результат становится недопустимым только при превышении максимального или минимального значения года.

Например, вычитание одного дня из даты 2009-01-01 даст 2008-12-31.

Этот экземпляр неизменяем, и вызов данного метода не влияет на него.

public <R> R query(TemporalQuery<R> query)

Выполняет запрос к этой дате с помощью указанного запроса.

Этот метод выполняет запрос к этой дате с помощью указанного объекта стратегии запроса. Объект TemporalQuery определяет логику получения результата. Чтобы понять, каким будет результат этого метода, ознакомьтесь с документацией запроса.

Результат этого метода получается путем вызова метода TemporalQuery.queryFrom(TemporalAccessor) для указанного запроса с передачей this в качестве аргумента.

public Temporal adjustInto(Temporal temporal)

Корректирует указанный временной объект так, чтобы его дата совпадала с датой этого объекта.

Возвращает временной объект того же наблюдаемого типа, что и входной, но с датой, измененной на дату этого объекта.

Корректировка эквивалентна использованию Temporal.with(TemporalField, long) с передачей ChronoField.EPOCH_DAY в качестве поля.

В большинстве случаев понятнее изменить порядок вызовов, используя Temporal.with(TemporalAdjuster):

  // these two lines are equivalent, but the second approach is recommended
  temporal = thisLocalDate.adjustInto(temporal);
  temporal = temporal.with(thisLocalDate);

Этот экземпляр неизменяем, и вызов данного метода не влияет на него.

public long until(Temporal endExclusive, TemporalUnit unit)

Вычисляет время до другой даты в единицах указанной единицы измерения.

Этот метод вычисляет время между двумя объектами LocalDate в единицах одной TemporalUnit. Начальной и конечной точками являются this и указанная дата. Результат будет отрицательным, если конечная дата предшествует начальной. Переданный этому методу объект Temporal преобразуется в LocalDate с помощью from(TemporalAccessor). Например, количество дней между двумя датами можно вычислить с помощью startDate.until(endDate, DAYS).

Вычисление возвращает целое число, представляющее количество полных единиц между двумя датами. Например, промежуток в месяцах между 2012-06-15 и 2012-08-14 составляет только один месяц, поскольку до двух месяцев не хватает одного дня.

Этот метод можно использовать двумя эквивалентными способами. Первый — вызвать этот метод. Второй — использовать TemporalUnit.between(Temporal, Temporal):

  // these two lines are equivalent
  amount = start.until(end, MONTHS);
  amount = MONTHS.between(start, end);

Выбор следует сделать исходя из того, какой вариант делает код более читаемым.

Вычисление реализовано в этом методе для ChronoUnit. Поддерживаются единицы DAYS, WEEKS, MONTHS, YEARS, DECADES, CENTURIES, MILLENNIA и ERAS. Другие значения ChronoUnit приведут к выбросу исключения.

Если единица не является ChronoUnit, результат этого метода получается вызовом TemporalUnit.between(Temporal, Temporal) с передачей this в качестве первого аргумента, а преобразованного входного временного объекта — в качестве второго.

Этот экземпляр неизменяем и не изменяется в результате вызова данного метода.

public Period until(ChronoLocalDate endDateExclusive)

Вычисляет период между этой датой и другой датой в виде Period.

Этот метод вычисляет период между двумя датами в годах, месяцах и днях. Начальной и конечной точками являются this и указанная дата. Результат будет отрицательным, если конечная дата предшествует начальной. Знак будет одинаковым для лет, месяцев и дней.

Вычисление выполняется с использованием календарной системы ISO. При необходимости входная дата преобразуется в формат ISO.

Начальная дата включается, а конечная — нет. Период вычисляется путем вычитания полных месяцев, затем вычисляется оставшееся количество дней с корректировкой, обеспечивающей одинаковый знак для обоих значений. После этого количество месяцев нормализуется в годы и месяцы исходя из того, что год состоит из 12 месяцев. Месяц считается полным, если день месяца конечной даты больше или равен дню месяца начальной даты. Например, промежуток от 2010-01-15 до 2011-03-18 составляет «1 год, 2 месяца и 3 дня».

Этот метод можно использовать двумя эквивалентными способами. Первый — вызвать этот метод. Второй — использовать Period.between(LocalDate, LocalDate):

  // these two lines are equivalent
  period = start.until(end);
  period = Period.between(start, end);

Выбор следует сделать исходя из того, какой вариант делает код более читаемым.

public Stream<LocalDate> datesUntil(LocalDate endExclusive)

Возвращает упорядоченный последовательный поток дат. Возвращаемый поток начинается с этой даты (включительно) и заканчивается endExclusive (не включительно), увеличиваясь на 1 день.

Этот метод эквивалентен datesUntil(endExclusive, Period.ofDays(1)).

public Stream<LocalDate> datesUntil(LocalDate endExclusive, Period step)

Возвращает упорядоченный последовательный поток дат с заданным шагом. Возвращаемый поток начинается с этой даты (включительно) и заканчивается endExclusive (не включительно).

n-я дата в потоке равна this.plus(step.multipliedBy(n)) (однако результат умножения шага никогда не вызывает переполнения). Например, если эта дата — 2015-01-31, конечная дата — 2015-05-01, а шаг равен 1 месяцу, поток содержит 2015-01-31, 2015-02-28, 2015-03-31 и 2015-04-30.

public String format(DateTimeFormatter formatter)

Форматирует эту дату с помощью указанного форматтера.

Эта дата передается форматтеру для создания строки.

public LocalDateTime atTime(LocalTime time)

Объединяет эту дату со временем, чтобы создать LocalDateTime.

Возвращает LocalDateTime, образованный этой датой и указанным временем. Допустимы все возможные сочетания даты и времени.

public LocalDateTime atTime(int hour, int minute)

Объединяет эту дату со временем, чтобы создать LocalDateTime.

Возвращает LocalDateTime, образованный этой датой и указанными часом и минутой. Значения секунд и наносекунд устанавливаются в ноль. Каждое отдельное поле времени должно находиться в допустимом диапазоне. Допустимы все возможные сочетания даты и времени.

public LocalDateTime atTime(int hour, int minute, int second)

Объединяет эту дату со временем, чтобы создать LocalDateTime.

Возвращает LocalDateTime, образованный этой датой и указанными часом, минутой и секундой. Значение наносекунд устанавливается в ноль. Каждое отдельное поле времени должно находиться в допустимом диапазоне. Допустимы все возможные сочетания даты и времени.

public LocalDateTime atTime(int hour, int minute, int second, int nanoOfSecond)

Объединяет эту дату со временем, чтобы создать LocalDateTime.

Возвращает LocalDateTime, образованный этой датой и указанными часом, минутой, секундой и наносекундой. Каждое отдельное поле времени должно находиться в допустимом диапазоне. Допустимы все возможные сочетания даты и времени.

public OffsetDateTime atTime(OffsetTime time)

Объединяет эту дату со временем со смещением, чтобы создать OffsetDateTime.

Возвращает OffsetDateTime, образованный этой датой и указанным временем. Допустимы все возможные сочетания даты и времени.

public LocalDateTime atStartOfDay()

Объединяет эту дату со временем полуночи, чтобы создать LocalDateTime в начале этой даты.

Возвращает LocalDateTime, образованный этой датой и временем полуночи — 00:00 — в начале этой даты.

public ZonedDateTime atStartOfDay(ZoneId zone)

Возвращает дату и время с часовым поясом, начиная с этой даты и с самого раннего допустимого времени согласно правилам часового пояса.

Правила часового пояса, например переход на летнее время, означают, что не всякие локальные дата и время допустимы для указанного часового пояса, поэтому локальное время может отличаться от полуночи.

В большинстве случаев для локальных даты и времени существует только одно допустимое смещение. При переходе часов назад существуют два допустимых смещения, и используется более раннее, соответствующее первому наступлению полуночи в эту дату. При пропуске времени дата и время с часовым поясом будут соответствовать моменту сразу после пропуска.

Если идентификатор часового пояса — это ZoneOffset, результат всегда будет содержать время полуночи.

Чтобы преобразовать дату и время в конкретное время в заданном часовом поясе, вызовите atTime(LocalTime), а затем LocalDateTime.atZone(ZoneId).

public long toEpochSecond(LocalTime time, ZoneOffset offset)

Преобразует этот LocalDate в количество секунд, прошедших с начала эпохи 1970-01-01T00:00:00Z.

Этот метод объединяет эту локальную дату с указанным временем и смещением для вычисления значения секунд эпохи — количества секунд, прошедших с 1970-01-01T00:00:00Z. Моменты на временной шкале после начала эпохи имеют положительное значение, а более ранние — отрицательное.

public int compareTo(ChronoLocalDate other)

Сравнивает эту дату с другой датой.

Сравнение выполняется прежде всего по дате, от самой ранней к самой поздней. Оно «согласовано с equals» в соответствии с определением Comparable.

Если все сравниваемые даты являются экземплярами LocalDate, сравнение будет полностью основано на дате. Если некоторые сравниваемые даты принадлежат к разным хронологиям, учитывается также хронология; см. ChronoLocalDate.compareTo(ChronoLocalDate).

public boolean isAfter(ChronoLocalDate other)

Проверяет, следует ли эта дата за указанной датой.

Проверяет, представляет ли эта дата момент на локальной временной шкале, следующий за другой датой.

  LocalDate a = LocalDate.of(2012, 6, 30);
  LocalDate b = LocalDate.of(2012, 7, 1);
  a.isAfter(b) == false
  a.isAfter(a) == false
  b.isAfter(a) == true

Этот метод учитывает только положение двух дат на локальной временной шкале. Он не учитывает хронологию или календарную систему. Это отличается от сравнения в compareTo(ChronoLocalDate), но соответствует подходу метода ChronoLocalDate.timeLineOrder().

public boolean isBefore(ChronoLocalDate other)

Проверяет, предшествует ли эта дата указанной дате.

Проверяет, представляет ли эта дата момент на локальной временной шкале, предшествующий другой дате.

  LocalDate a = LocalDate.of(2012, 6, 30);
  LocalDate b = LocalDate.of(2012, 7, 1);
  a.isBefore(b) == true
  a.isBefore(a) == false
  b.isBefore(a) == false

Этот метод учитывает только положение двух дат на локальной временной шкале. Он не учитывает хронологию или календарную систему. Это отличается от сравнения в compareTo(ChronoLocalDate), но соответствует подходу метода ChronoLocalDate.timeLineOrder().

public boolean isEqual(ChronoLocalDate other)

Проверяет, равна ли эта дата указанной дате.

Проверяет, представляет ли эта дата тот же момент на локальной временной шкале, что и другая дата.

  LocalDate a = LocalDate.of(2012, 6, 30);
  LocalDate b = LocalDate.of(2012, 7, 1);
  a.isEqual(b) == false
  a.isEqual(a) == true
  b.isEqual(a) == false

Этот метод учитывает только положение двух дат на локальной временной шкале. Он не учитывает хронологию или календарную систему. Это отличается от сравнения в compareTo(ChronoLocalDate), но соответствует подходу метода ChronoLocalDate.timeLineOrder().

public boolean equals(Object obj)

Проверяет, равна ли эта дата другой дате.

Сравнивает этот объект LocalDate с другим, проверяя совпадение дат.

Сравниваются только объекты типа LocalDate; для объектов других типов возвращается false. Чтобы сравнить даты двух экземпляров TemporalAccessor, в том числе даты из разных хронологий, используйте ChronoField.EPOCH_DAY в качестве компаратора.

public int hashCode()

Хеш-код этой даты.

public String toString()

Выводит эту дату в виде String, например 2007-12-03.

Результат будет представлен в формате ISO-8601 uuuu-MM-dd.