Класс LocalDateTime

public static final LocalDateTime MIN

Минимальное поддерживаемое значение LocalDateTime, '-999999999-01-01T00:00:00'. Это локальные дата и время полуночи в начале минимальной даты. Сочетает в себе LocalDate.MIN и LocalTime.MIN. Приложение может использовать это значение в качестве даты и времени в «далёком прошлом».

public static final LocalDateTime MAX

Максимальное поддерживаемое значение LocalDateTime, '+999999999-12-31T23:59:59.999999999'. Это локальные дата и время непосредственно перед полуночью в конце максимальной даты. Сочетает в себе LocalDate.MAX и LocalTime.MAX. Приложение может использовать это значение в качестве даты и времени в «далёком будущем».

public static LocalDateTime now()

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

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

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

public static LocalDateTime now(ZoneId zone)

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

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

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

public static LocalDateTime now(Clock clock)

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

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

public static LocalDateTime of(int year, Month month, int dayOfMonth, int hour, int minute)

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

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

public static LocalDateTime of(int year, Month month, int dayOfMonth, int hour, int minute, int second)

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

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

public static LocalDateTime of(int year, Month month, int dayOfMonth, int hour, int minute, int second, int nanoOfSecond)

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

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

public static LocalDateTime of(int year, int month, int dayOfMonth, int hour, int minute)

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

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

public static LocalDateTime of(int year, int month, int dayOfMonth, int hour, int minute, int second)

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

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

public static LocalDateTime of(int year, int month, int dayOfMonth, int hour, int minute, int second, int nanoOfSecond)

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

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

public static LocalDateTime of(LocalDate date, LocalTime time)

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

public static LocalDateTime ofInstant(Instant instant, ZoneId zone)

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

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

public static LocalDateTime ofEpochSecond(long epochSecond, int nanoOfSecond, ZoneOffset offset)

Создаёт экземпляр LocalDateTime, используя количество секунд с начала эпохи 1970-01-01T00:00:00Z.

Этот метод позволяет преобразовать поле epoch-second в локальные дату и время. Он предназначен главным образом для низкоуровневых преобразований, а не для общего использования в приложениях.

public static LocalDateTime from(TemporalAccessor temporal)

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

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

Метод извлекает и объединяет LocalDate и LocalTime из объекта временных данных. Реализации могут применять оптимизации, например обращаться к полям, эквивалентным соответствующим объектам.

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

public static LocalDateTime parse(CharSequence text)

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

Строка должна представлять допустимые дату и время; для её разбора используется DateTimeFormatter.ISO_LOCAL_DATE_TIME.

public static LocalDateTime parse(CharSequence text, DateTimeFormatter formatter)

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

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

public boolean isSupported(TemporalField field)

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

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

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

• NANO_OF_SECOND
• NANO_OF_DAY
• MICRO_OF_SECOND
• MICRO_OF_DAY
• MILLI_OF_SECOND
• MILLI_OF_DAY
• SECOND_OF_MINUTE
• SECOND_OF_DAY
• MINUTE_OF_HOUR
• MINUTE_OF_DAY
• HOUR_OF_AMPM
• CLOCK_HOUR_OF_AMPM
• HOUR_OF_DAY
• CLOCK_HOUR_OF_DAY
• AMPM_OF_DAY
• 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)

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

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

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

• NANOS
• MICROS
• MILLIS
• SECONDS
• MINUTES
• HOURS
• HALF_DAYS
• 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 возвращает допустимые значения на основе этих даты и времени, за исключением NANO_OF_DAY, MICRO_OF_DAY, 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 LocalDate toLocalDate()

Получает часть этих даты и времени, содержащую LocalDate.

Возвращает LocalDate с теми же годом, месяцем и днём, что и у этих даты и времени.

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 LocalTime toLocalTime()

Получает часть этих даты и времени, содержащую LocalTime.

Возвращает LocalTime с теми же часом, минутой, секундой и наносекундой, что и у этих даты и времени.

public int getHour()

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

public int getMinute()

Получает поле минуты часа.

public int getSecond()

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

public int getNano()

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

public LocalDateTime with(TemporalAdjuster adjuster)

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

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

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

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

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

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

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

Классы LocalDate и LocalTime реализуют TemporalAdjuster, поэтому этот метод можно использовать для изменения даты, времени или смещения:

 result = localDateTime.with(date);
 result = localDateTime.with(time);

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

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

public LocalDateTime with(TemporalField field, long newValue)

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

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

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

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

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

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

public LocalDateTime withYear(int year)

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

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

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

public LocalDateTime withMonth(int month)

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

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

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

public LocalDateTime withDayOfMonth(int dayOfMonth)

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

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

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

public LocalDateTime withDayOfYear(int dayOfYear)

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

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

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

public LocalDateTime withHour(int hour)

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

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

public LocalDateTime withMinute(int minute)

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

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

public LocalDateTime withSecond(int second)

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

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

public LocalDateTime withNano(int nanoOfSecond)

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

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

public LocalDateTime truncatedTo(TemporalUnit unit)

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

Усечение возвращает копию исходной даты и времени, в которой поля, меньшие указанной единицы измерения, установлены в ноль. Например, усечение до minutes установит поля секунды минуты и наносекунды секунды в ноль.

Длительность единицы измерения должна делить продолжительность стандартных суток без остатка. К таким единицам относятся все предоставляемые единицы времени из ChronoUnit и DAYS. Для других единиц выбрасывается исключение.

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

public LocalDateTime plus(TemporalAmount amountToAdd)

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

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

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

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

public LocalDateTime plus(long amountToAdd, TemporalUnit unit)

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

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

Если поле является ChronoUnit, сложение выполняется здесь. Сложение единиц даты выполняется так же, как в LocalDate.plus(long, TemporalUnit). Сложение единиц времени выполняется так же, как в LocalTime.plus(long, TemporalUnit), при этом переполнение по дням обрабатывается так же, как при использовании plusDays(long).

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

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

public LocalDateTime plusYears(long years)

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

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

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

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

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

public LocalDateTime plusMonths(long months)

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

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

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

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

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

public LocalDateTime plusWeeks(long weeks)

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

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

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

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

public LocalDateTime plusDays(long days)

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

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

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

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

public LocalDateTime plusHours(long hours)

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

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

public LocalDateTime plusMinutes(long minutes)

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

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

public LocalDateTime plusSeconds(long seconds)

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

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

public LocalDateTime plusNanos(long nanos)

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

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

public LocalDateTime minus(TemporalAmount amountToSubtract)

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

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

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

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

public LocalDateTime minus(long amountToSubtract, TemporalUnit unit)

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

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

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

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

public LocalDateTime minusYears(long years)

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

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

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

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

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

public LocalDateTime minusMonths(long months)

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

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

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

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

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

public LocalDateTime minusWeeks(long weeks)

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

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

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

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

public LocalDateTime minusDays(long days)

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

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

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

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

public LocalDateTime minusHours(long hours)

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

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

public LocalDateTime minusMinutes(long minutes)

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

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

public LocalDateTime minusSeconds(long seconds)

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

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

public LocalDateTime minusNanos(long nanos)

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

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

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

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

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

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

public Temporal adjustInto(Temporal temporal)

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

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

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

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

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

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

public long until(Temporal endExclusive, TemporalUnit unit)

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

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

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

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

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

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

Вычисление реализовано в этом методе для ChronoUnit. Поддерживаются единицы NANOS, MICROS, MILLIS, SECONDS, MINUTES, HOURS и HALF_DAYS, DAYS, WEEKS, MONTHS, YEARS, DECADES, CENTURIES, MILLENNIA и ERAS. При передаче других значений ChronoUnit будет выброшено исключение.

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

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

public String format(DateTimeFormatter formatter)

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

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

public OffsetDateTime atOffset(ZoneOffset offset)

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

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

public ZonedDateTime atZone(ZoneId zone)

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

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

Локальная дата и время сопоставляются с единственным моментом на временной шкале. Для этого для локальной даты и времени определяется допустимое смещение относительно UTC/Гринвича согласно rules идентификатора часового пояса.

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

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

Чтобы получить более позднее смещение при переходе на зимнее время, вызовите ZonedDateTime.withLaterOffsetAtOverlap() для результата этого метода. Чтобы при разрыве или наложении было выброшено исключение, используйте ZonedDateTime.ofStrict(LocalDateTime, ZoneOffset, ZoneId).

public int compareTo(ChronoLocalDateTime<?> other)

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

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

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

public boolean isAfter(ChronoLocalDateTime<?> other)

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

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

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

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

public boolean isBefore(ChronoLocalDateTime<?> other)

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

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

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

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

public boolean isEqual(ChronoLocalDateTime<?> other)

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

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

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

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

public boolean equals(Object obj)

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

Сравнивает этот LocalDateTime с другим, проверяя совпадение даты и времени. Сравниваются только объекты типа LocalDateTime; для объектов других типов возвращается false.

public int hashCode()

Хеш-код этой даты и времени.

public String toString()

Представляет эту дату и время в виде String, например 2007-12-03T10:15:30.

Результат будет иметь один из следующих форматов ISO-8601:

• uuuu-MM-dd'T'HH:mm
• uuuu-MM-dd'T'HH:mm:ss
• uuuu-MM-dd'T'HH:mm:ss.SSS
• uuuu-MM-dd'T'HH:mm:ss.SSSSSS
• uuuu-MM-dd'T'HH:mm:ss.SSSSSSSSS

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