Класс LocalDateTime

java.lang.Object

java.time.LocalDateTime

Все реализованные интерфейсы:: Serializable, Comparable<ChronoLocalDateTime<?>>, ChronoLocalDateTime<LocalDate>, Temporal, TemporalAccessor, TemporalAdjuster

public final class LocalDateTime extends Object implements Temporal, TemporalAdjuster, ChronoLocalDateTime<LocalDate>, Serializable

Дата-время без часового пояса в системе календаря ISO-8601, например 2007-12-03T10:15:30.

LocalDateTime — это неизменяемый объект дата-время, представляющий дату и время, часто рассматриваемый как год-месяц-день-час-минута-секунда. Также можно получить другие поля даты и времени, такие как день года, день недели и неделя года. Время представлено с точностью до наносекунд. Например, значение "2 октября 2007 года в 13:45:30.123456789" может быть сохранено в LocalDateTime.

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

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

Это безусловный класс; программисты должны рассматривать экземпляры, которые равны, как взаимозаменяемые и не должны использовать экземпляры для синхронизации, иначе может произойти непредсказуемое поведение. Например, в будущей версии синхронизация может не сработать. Для сравнений следует использовать метод equals.

Требования к реализации:

Этот класс неизменяемый и потокобезопасный.

С тех пор:

1.8

См. также:

Сериализованная форма

Краткое описание полей

Модификатор и тип	Поле	Описание
`static final LocalDateTime`	`MAX`	Максимально поддерживаемое `LocalDateTime`, '+999999999-12-31T23:59:59.999999999'.
`static final LocalDateTime`	`MIN`	Минимально поддерживаемое `LocalDateTime`, '-999999999-01-01T00:00:00'.

Краткое описание методов

Модификатор и тип	Метод	Описание
`Temporal`	`adjustInto(Temporal temporal)`	Настраивает указанный временной объект так, чтобы его дата и время совпадали с этим объектом.
`OffsetDateTime`	`atOffset(ZoneOffset offset)`	Объединяет это время с смещением, чтобы создать `OffsetDateTime`.
`ZonedDateTime`	`atZone(ZoneId zone)`	Объединяет это время с часовым поясом, чтобы создать `ZonedDateTime`.
`int`	`compareTo(ChronoLocalDateTime<?> other)`	Сравнивает это время с другим временем.
`boolean`	`equals(Object obj)`	Проверяет, равно ли это время другому времени.
`String`	`format(DateTimeFormatter formatter)`	Форматирует это время с использованием указанного форматера.
`static LocalDateTime`	`from(TemporalAccessor temporal)`	Получает экземпляр `LocalDateTime` из временного объекта.
`int`	`get(TemporalField field)`	Получает значение указанного поля из этого времени как `int`.
`int`	`getDayOfMonth()`	Получает поле дня месяца.
`DayOfWeek`	`getDayOfWeek()`	Получает поле дня недели, которое является перечислением `DayOfWeek`.
`int`	`getDayOfYear()`	Получает поле дня года.
`int`	`getHour()`	Получает поле часа дня.
`long`	`getLong(TemporalField field)`	Получает значение указанного поля из этого времени как `long`.
`int`	`getMinute()`	Получает поле минуты часа.
`Month`	`getMonth()`	Получает поле месяца года, используя перечисление `Month`.
`int`	`getMonthValue()`	Получает поле месяца года от 1 до 12.
`int`	`getNano()`	Получает поле наносекунд.
`int`	`getSecond()`	Получает поле секунд минуты.
`int`	`getYear()`	Получает поле года.
`int`	`hashCode()`	Хеш-код для этого времени.
`boolean`	`isAfter(ChronoLocalDateTime<?> other)`	Проверяет, предшествует ли это время указанному времени.
`boolean`	`isBefore(ChronoLocalDateTime<?> other)`	Проверяет, следует ли это время за указанным временем.
`boolean`	`isEqual(ChronoLocalDateTime<?> other)`	Проверяет, равно ли это время указанному времени.
`boolean`	`isSupported(TemporalField field)`	Проверяет, поддерживается ли указанное поле.
`boolean`	`isSupported(TemporalUnit unit)`	Проверяет, поддерживается ли указанный единица.
`LocalDateTime`	`minus(long amountToSubtract, TemporalUnit unit)`	Возвращает копию этого времени, из которой вычтено указанное значение.
`LocalDateTime`	`minus(TemporalAmount amountToSubtract)`	Возвращает копию этого времени, из которой вычтено указанное значение.
`LocalDateTime`	`minusDays(long days)`	Возвращает копию этого `LocalDateTime` с вычтенным количеством дней.
`LocalDateTime`	`minusHours(long hours)`	Возвращает копию этого `LocalDateTime` с вычтенным количеством часов.
`LocalDateTime`	`minusMinutes(long minutes)`	Возвращает копию этого `LocalDateTime` с вычтенным количеством минут.
`LocalDateTime`	`minusMonths(long months)`	Возвращает копию этого `LocalDateTime` с вычтенным количеством месяцев.
`LocalDateTime`	`minusNanos(long nanos)`	Возвращает копию этого `LocalDateTime` с вычтенным количеством наносекунд.
`LocalDateTime`	`minusSeconds(long seconds)`	Возвращает копию этого `LocalDateTime` с вычтенным количеством секунд.
`LocalDateTime`	`minusWeeks(long weeks)`	Возвращает копию этого `LocalDateTime` с вычтенным количеством недель.
`LocalDateTime`	`minusYears(long years)`	Возвращает копию этого `LocalDateTime` с вычтенным количеством лет.
`static LocalDateTime`	`now()`	Получает текущее время из системных часов в стандартном часовом поясе.
`static LocalDateTime`	`now(Clock clock)`	Получает текущее время из указанных часов.
`static LocalDateTime`	`now(ZoneId zone)`	Получает текущее время из системных часов в указанном часовом поясе.
`static LocalDateTime`	`of(int year, int month, int dayOfMonth, int hour, int minute)`	Получает экземпляр `LocalDateTime` по году, месяцу, дню, часу и минуте, устанавливая секунды и наносекунды в ноль.
`static LocalDateTime`	`of(int year, int month, int dayOfMonth, int hour, int minute, int second)`	Получает экземпляр `LocalDateTime` по году, месяцу, дню, часу, минуте и секунде, устанавливая наносекунды в ноль.
`static LocalDateTime`	`of(int year, int month, int dayOfMonth, int hour, int minute, int second, int nanoOfSecond)`	Получает экземпляр `LocalDateTime` по году, месяцу, дню, часу, минуте, секунде и наносекунде.
`static LocalDateTime`	`of(int year, Month month, int dayOfMonth, int hour, int minute)`	Получает экземпляр `LocalDateTime` по году, месяцу, дню, часу и минуте, устанавливая секунды и наносекунды в ноль.
`static LocalDateTime`	`of(int year, Month month, int dayOfMonth, int hour, int minute, int second)`	Получает экземпляр `LocalDateTime` по году, месяцу, дню, часу, минуте и секунде, устанавливая наносекунды в ноль.
`static LocalDateTime`	`of(int year, Month month, int dayOfMonth, int hour, int minute, int second, int nanoOfSecond)`	Получает экземпляр `LocalDateTime` по году, месяцу, дню, часу, минуте, секунде и наносекунде.
`static LocalDateTime`	`of(LocalDate date, LocalTime time)`	Получает экземпляр `LocalDateTime` по дате и времени.
`static LocalDateTime`	`ofEpochSecond(long epochSecond, int nanoOfSecond, ZoneOffset offset)`	Получает экземпляр `LocalDateTime`, используя секунды от эпохи 1970-01-01T00:00:00Z.
`static LocalDateTime`	`ofInstant(Instant instant, ZoneId zone)`	Получает экземпляр `LocalDateTime` из `Instant` и идентификатора часового пояса.
`static LocalDateTime`	`parse(CharSequence text)`	Получает экземпляр `LocalDateTime` из текстовой строки, такой как `2007-12-03T10:15:30`.
`static LocalDateTime`	`parse(CharSequence text, DateTimeFormatter formatter)`	Получает экземпляр `LocalDateTime` из текстовой строки с использованием определенного форматера.
`LocalDateTime`	`plus(long amountToAdd, TemporalUnit unit)`	Возвращает копию этого времени, к которому добавлено указанное значение.
`LocalDateTime`	`plus(TemporalAmount amountToAdd)`	Возвращает копию этого времени, к которому добавлено указанное значение.
`LocalDateTime`	`plusDays(long days)`	Возвращает копию этого `LocalDateTime` с добавленным количеством дней.
`LocalDateTime`	`plusHours(long hours)`	Возвращает копию этого `LocalDateTime` с добавленным количеством часов.
`LocalDateTime`	`plusMinutes(long minutes)`	Возвращает копию этого `LocalDateTime` с добавленным количеством минут.
`LocalDateTime`	`plusMonths(long months)`	Возвращает копию этого `LocalDateTime` с добавленным количеством месяцев.
`LocalDateTime`	`plusNanos(long nanos)`	Возвращает копию этого `LocalDateTime` с добавленным количеством наносекунд.
`LocalDateTime`	`plusSeconds(long seconds)`	Возвращает копию этого `LocalDateTime` с добавленным количеством секунд.
`LocalDateTime`	`plusWeeks(long weeks)`	Возвращает копию этого `LocalDateTime` с добавленным количеством недель.
`LocalDateTime`	`plusYears(long years)`	Возвращает копию этого `LocalDateTime` с добавленным количеством лет.

`<R> R`	`query(TemporalQuery<R> query)`	Запрашивает эту дату и время с использованием указанного запроса.
`ValueRange`	`range(TemporalField field)`	Получает диапазон допустимых значений для указанного поля.
`LocalDate`	`toLocalDate()`	Получает часть `LocalDate` этой даты и времени.
`LocalTime`	`toLocalTime()`	Получает часть `LocalTime` этой даты и времени.
`String`	`toString()`	Выводит эту дату и время в виде `String`, например `2007-12-03T10:15:30`.
`LocalDateTime`	`truncatedTo(TemporalUnit unit)`	Возвращает копию этого `LocalDateTime` с обрезанным временем.
`long`	`until(Temporal endExclusive, TemporalUnit unit)`	Вычисляет количество времени до другой даты и времени в терминах указанного единицы измерения.
`LocalDateTime`	`with(TemporalAdjuster adjuster)`	Возвращает скорректированную копию этой даты и времени.
`LocalDateTime`	`with(TemporalField field, long newValue)`	Возвращает копию этой даты и времени с указанным полем, установленным на новое значение.
`LocalDateTime`	`withDayOfMonth(int dayOfMonth)`	Возвращает копию этого `LocalDateTime` с измененным днем месяца.
`LocalDateTime`	`withDayOfYear(int dayOfYear)`	Возвращает копию этого `LocalDateTime` с измененным днем года.
`LocalDateTime`	`withHour(int hour)`	Возвращает копию этого `LocalDateTime` с измененным часом.
`LocalDateTime`	`withMinute(int minute)`	Возвращает копию этого `LocalDateTime` с измененной минутой.
`LocalDateTime`	`withMonth(int month)`	Возвращает копию этого `LocalDateTime` с измененным месяцем.
`LocalDateTime`	`withNano(int nanoOfSecond)`	Возвращает копию этого `LocalDateTime` с измененными наносекундами.
`LocalDateTime`	`withSecond(int second)`	Возвращает копию этого `LocalDateTime` с измененной секундой.
`LocalDateTime`	`withYear(int year)`	Возвращает копию этого `LocalDateTime` с измененным годом.

Методы, объявленные в классе java.lang.Object

clone, finalize, getClass, notify, notifyAll, wait, wait, wait

Методы, объявленные в интерфейсе java.time.chrono.ChronoLocalDateTime

getChronology, toEpochSecond, toInstant

Краткое описание полей

MIN

public static final LocalDateTime MIN

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

MAX

public static final LocalDateTime MAX

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

Краткое описание методов

now

public static LocalDateTime now()

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

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

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

Возвращает:: текущую дату и время с использованием системных часов и часового пояса по умолчанию, не null

now

public static LocalDateTime now(ZoneId zone)

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

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

Параметры:: zone - идентификатор часового пояса, который нужно использовать, не null
Возвращает:: текущую дату и время с использованием системных часов, не null

now

public static LocalDateTime now(Clock clock)

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

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

Параметры:: clock - часы, которые нужно использовать, не null
Возвращает:: текущая дата и время, не null

of

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

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

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

Параметры:: year - год, который нужно представить, от MIN_YEAR до MAX_YEAR; month - месяц года, который нужно представить, не null; dayOfMonth - день месяца, который нужно представить, от 1 до 31; hour - час дня, который нужно представить, от 0 до 23; minute - минута часа, которую нужно представить, от 0 до 59
Возвращает:: локальная дата и время, не null
Выбрасывает:: DateTimeException - если значение любого поля находится вне допустимого диапазона, или если день месяца неверен для месяца и года

of

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

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

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

Параметры:: year - год, который нужно представить, от MIN_YEAR до MAX_YEAR; month - месяц года, который нужно представить, не null; dayOfMonth - день месяца, который нужно представить, от 1 до 31; hour - час дня, который нужно представить, от 0 до 23; minute - минута часа, которую нужно представить, от 0 до 59; second - секунда минуты, которую нужно представить, от 0 до 59
Возвращает:: локальная дата и время, не null
Выбрасывает:: DateTimeException - если значение любого поля находится вне допустимого диапазона, или если день месяца неверен для месяца и года

of

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

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

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

Параметры:: year - год, который нужно представить, от MIN_YEAR до MAX_YEAR; month - месяц года, который нужно представить, не null; dayOfMonth - день месяца, который нужно представить, от 1 до 31; hour - час дня, который нужно представить, от 0 до 23; minute - минута часа, которую нужно представить, от 0 до 59; second - секунда минуты, которую нужно представить, от 0 до 59; nanoOfSecond - наносекунда, которую нужно представить, от 0 до 999,999,999
Возвращает:: локальная дата и время, не null
Выбрасывает:: DateTimeException - если значение любого поля находится вне допустимого диапазона, или если день месяца неверен для месяца и года

of

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

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

Параметры:: year - год, который нужно представить, от MIN_YEAR до MAX_YEAR; month - месяц года, который нужно представить, от 1 (январь) до 12 (декабрь); dayOfMonth - день месяца, который нужно представить, от 1 до 31; hour - час дня, который нужно представить, от 0 до 23; minute - минута часа, которую нужно представить, от 0 до 59
Возвращает:: локальная дата и время, не null
Выбрасывает:: DateTimeException - если значение любого поля находится вне допустимого диапазона, или если день месяца неверен для месяца и года

of

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

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

Параметры:: year - год, который нужно представить, от MIN_YEAR до MAX_YEAR; month - месяц года, который нужно представить, от 1 (январь) до 12 (декабрь); dayOfMonth - день месяца, который нужно представить, от 1 до 31; hour - час дня, который нужно представить, от 0 до 23; minute - минута часа, которую нужно представить, от 0 до 59; second - секунда минуты, которую нужно представить, от 0 до 59
Возвращает:: локальная дата и время, не null
Выбрасывает:: DateTimeException - если значение любого поля находится вне допустимого диапазона, или если день месяца неверен для месяца и года

of

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

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

Параметры:: year - год, который нужно представить, от MIN_YEAR до MAX_YEAR; month - месяц года, который нужно представить, от 1 (январь) до 12 (декабрь); dayOfMonth - день месяца, который нужно представить, от 1 до 31; hour - час дня, который нужно представить, от 0 до 23; minute - минута часа, которую нужно представить, от 0 до 59; second - секунда минуты, которую нужно представить, от 0 до 59; nanoOfSecond - наносекунда, которую нужно представить, от 0 до 999,999,999
Возвращает:: локальная дата и время, не null
Выбрасывает:: DateTimeException - если значение любого поля находится вне допустимого диапазона, или если день месяца неверен для месяца и года

of

public static LocalDateTime of(LocalDate date, LocalTime time)

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

Параметры:: date - локальная дата, не null; time - локальное время, не null
Возвращает:: локальная дата и время, не null

ofInstant

public static LocalDateTime ofInstant(Instant instant, ZoneId zone)

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

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

Parameters:: instant - мгновение для создания даты и времени, не null; zone - часовой пояс, который может быть смещением, не null
Returns:: локальная дата и время, не null
Throws:: DateTimeException - если результат выходит за пределы поддерживаемого диапазона

ofEpochSecond

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

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

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

Parameters:: epochSecond - количество секунд с эпохи 1970-01-01T00:00:00Z; nanoOfSecond - наносекунды в секунде, от 0 до 999 999 999; offset - смещение часового пояса, не null
Returns:: локальная дата и время, не null
Throws:: DateTimeException - если результат выходит за пределы поддерживаемого диапазона или если наносекунды некорректны

from

public static LocalDateTime from(TemporalAccessor temporal)

Получает экземпляр LocalDateTime из временного объекта.

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

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

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

Parameters:

temporal - временной объект для преобразования, не null

Returns:

локальная дата и время, не null

Throws:

DateTimeException - если невозможно выполнить преобразование в LocalDateTime

See Also:

Chronology.localDateTime(TemporalAccessor)

parse

public static LocalDateTime parse(CharSequence text)

Получает экземпляр LocalDateTime из текстовой строки, такой как 2007-12-03T10:15:30.

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

Parameters:: text - текст для анализа, например "2007-12-03T10:15:30", не null
Returns:: проанализированная локальная дата и время, не null
Throws:: DateTimeParseException - если текст не может быть проанализирован

parse

public static LocalDateTime parse(CharSequence text, DateTimeFormatter formatter)

Получает экземпляр LocalDateTime из текстовой строки с использованием указанного форматера.

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

Parameters:: text - текст для анализа, не null; formatter - используемый форматер, не null
Returns:: проанализированная локальная дата и время, не null
Throws:: DateTimeParseException - если текст не может быть проанализирован

isSupported

public boolean isSupported(TemporalField field)

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

Проверяет, можно ли запросить у этой даты и времени указанное поле. Если false, то вызов методов 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 в качестве аргумента. Поддерживается ли поле, определяется полем.

Specified by:: isSupported в интерфейсе ChronoLocalDateTime<LocalDate>
Specified by:: isSupported в интерфейсе TemporalAccessor
Parameters:: field - поле для проверки, null возвращает false
Returns:: true, если поле поддерживается в этой дате и времени, false в противном случае

isSupported

public boolean isSupported(TemporalUnit unit)

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

Проверяет, может ли к этой дате и времени быть добавлен или вычтен указанный интервал. Если false, то вызов методов 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 в качестве аргумента. Поддерживается ли интервал, определяется интервалом.

Specified by:: isSupported в интерфейсе ChronoLocalDateTime<LocalDate>
Specified by:: isSupported в интерфейсе Temporal
Parameters:: unit - интервал для проверки, null возвращает false
Returns:: true, если интервал может быть добавлен/вычтен, false в противном случае

range

public ValueRange range(TemporalField field)

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

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

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

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

Specified by:: range в интерфейсе TemporalAccessor
Parameters:: field - поле для запроса диапазона, не null
Returns:: диапазон допустимых значений для поля, не null
Throws:: DateTimeException - если диапазон для поля получить невозможно; UnsupportedTemporalTypeException - если поле не поддерживается

получить

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 в качестве аргумента. Возможность получения значения и то, что оно представляет, определяется полем.

Определено в:: get в интерфейсе TemporalAccessor
Параметры:: field - поле для получения, не null
Возвращает:: значение для поля
Исключение:: DateTimeException - если значение для поля получить невозможно или значение находится вне диапазона допустимых значений для поля; UnsupportedTemporalTypeException - если поле не поддерживается или диапазон значений превышает int; ArithmeticException - если происходит переполнение числового типа

получитьДолго

public long getLong(TemporalField field)

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

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

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

Определено в:: getLong в интерфейсе TemporalAccessor
Параметры:: field - поле для получения, не null
Возвращает:: значение для поля
Исключение:: DateTimeException - если значение для поля получить невозможно; UnsupportedTemporalTypeException - если поле не поддерживается; ArithmeticException - если происходит переполнение числового типа

toLocalDate

public LocalDate toLocalDate()

Получает часть LocalDate этой даты и времени.

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

Определено в:: toLocalDate в интерфейсе ChronoLocalDateTime<LocalDate>
Возвращает:: часть даты этой даты и времени, не null

год

public int getYear()

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

Этот метод возвращает примитивное значение int для года.

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

Возвращает:: год, от MIN_YEAR до MAX_YEAR

месяц

public int getMonthValue()

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

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

Возвращает:

месяц, от 1 до 12

См. также:

getMonth()

месяц

public Month getMonth()

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

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

Возвращает:

месяц, не null

См. также:

getMonthValue()

деньМесяца

public int getDayOfMonth()

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

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

Возвращает:: день месяца, от 1 до 31

деньГода

public int getDayOfYear()

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

Этот метод возвращает примитивное значение int для дня года.

Возвращает:: день года, от 1 до 365 или 366 в високосном году

деньНедели

public DayOfWeek getDayOfWeek()

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

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

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

Возвращает:: день недели, не null

toLocalTime

public LocalTime toLocalTime()

Получает часть LocalTime этой даты и времени.

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

Определено в:: toLocalTime в интерфейсе ChronoLocalDateTime<LocalDate>
Возвращает:: часть времени этой даты и времени, не null

час

public int getHour()

Получает поле часа.

Возвращает:: час, от 0 до 23

минута

public int getMinute()

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

Возвращает:: минута, от 0 до 59

секунда

public int getSecond()

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

Возвращает:: секунда, от 0 до 59

наносекунда

public int getNano()

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

Возвращает:: наносекунда, от 0 до 999 999 999

с

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 в качестве аргумента.

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

Определено в:: with в интерфейсе ChronoLocalDateTime<LocalDate>
Определено в:: with в интерфейсе Temporal
Параметры:: adjuster - корректировщик для использования, не null
Возвращает:: дата и время, на основе this с выполненной корректировкой, не null
Исключение:: DateTimeException - если коррекция не может быть выполнена; ArithmeticException - если происходит переполнение числового типа

with

public LocalDateTime with(TemporalField field, long newValue)

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

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

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

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

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

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

Определено в:: with в интерфейсе ChronoLocalDateTime<LocalDate>
Определено в:: with в интерфейсе Temporal
Параметры:: field - поле для установки в результате, не null; newValue - новое значение поля в результате
Возвращает:: копия LocalDateTime на основе this с установленным указанным полем, не null
Исключения:: DateTimeException - если поле не может быть установлено; UnsupportedTemporalTypeException - если поле не поддерживается; ArithmeticException - если происходит переполнение числовых значений

withYear

public LocalDateTime withYear(int year)

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

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

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

Параметры:: year - год для установки в результате, от MIN_YEAR до MAX_YEAR
Возвращает:: копия LocalDateTime на основе этой даты и времени с запрошенным годом, не null
Исключения:: DateTimeException - если значение года некорректно

withMonth

public LocalDateTime withMonth(int month)

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

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

Параметры:: month - месяц года для установки в результате, от 1 (январь) до 12 (декабрь)
Возвращает:: копия LocalDateTime на основе этой даты и времени с запрошенным месяцем, не null
Исключения:: DateTimeException - если значение месяца года некорректно

withDayOfMonth

public LocalDateTime withDayOfMonth(int dayOfMonth)

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

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

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

Параметры:: dayOfMonth - день месяца для установки в результате, от 1 до 28-31
Возвращает:: копия LocalDateTime на основе этой даты и времени с запрошенным днём, не null
Исключения:: DateTimeException - если значение дня месяца некорректно или если день месяца некорректен для месяца и года

withDayOfYear

public LocalDateTime withDayOfYear(int dayOfYear)

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

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

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

Параметры:: dayOfYear - день года для установки в результате, от 1 до 365-366
Возвращает:: копия LocalDateTime на основе этой даты с запрошенным днём, не null
Исключения:: DateTimeException - если значение дня года некорректно или если день года некорректен для года

withHour

public LocalDateTime withHour(int hour)

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

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

Параметры:: hour - час для установки в результате, от 0 до 23
Возвращает:: копия LocalDateTime на основе этой даты и времени с запрошенным часом, не null
Исключения:: DateTimeException - если значение часа некорректно

withMinute

public LocalDateTime withMinute(int minute)

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

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

Параметры:: minute - минута для установки в результате, от 0 до 59
Возвращает:: копия LocalDateTime на основе этой даты и времени с запрошенной минутой, не null
Исключения:: DateTimeException - если значение минуты некорректно

withSecond

public LocalDateTime withSecond(int second)

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

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

Параметры:: second - секунда для установки в результате, от 0 до 59
Возвращает:: копия LocalDateTime на основе этой даты и времени с запрошенной секундой, не null
Исключения:: DateTimeException - если значение секунды некорректно

withNano

public LocalDateTime withNano(int nanoOfSecond)

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

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

Параметры:: nanoOfSecond - наносекунда для установки в результате, от 0 до 999 999 999
Возвращает:: копия LocalDateTime на основе этой даты и времени с запрошенной наносекундой, не null
Исключения:: DateTimeException - если значение наносекунды некорректно

truncatedTo

public LocalDateTime truncatedTo(TemporalUnit unit)

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

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

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

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

Параметры:: unit - тип для обрезки, не null
Возвращает:: копия LocalDateTime на основе этой даты и времени с обрезкой времени, не null
Исключения:: DateTimeException - если обрезка невозможна; UnsupportedTemporalTypeException - если тип не поддерживается

plus

public LocalDateTime plus(TemporalAmount amountToAdd)

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

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

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

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

Определено в:: plus в интерфейсе ChronoLocalDateTime<LocalDate>
Определено в:: plus в интерфейсе Temporal
Параметры:: amountToAdd - количество для добавления, не null
Возвращает:: копия LocalDateTime на основе этой даты и времени с произведённым добавлением, не null
Исключения:: DateTimeException - если добавление невозможно; ArithmeticException - если происходит переполнение числовых значений

plus

public LocalDateTime plus(long amountToAdd, TemporalUnit unit)

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

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

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

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

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

Specified by:: plus в интерфейсе ChronoLocalDateTime<LocalDate>
Specified by:: plus в интерфейсе Temporal
Parameters:: amountToAdd - количество единиц для добавления к результату, может быть отрицательным; unit - единица измерения количества для добавления, не null
Returns:: копия DateTime, основанная на этом объекте, с добавлением указанного количества, не null
Throws:: DateTimeException - если добавление невозможно; UnsupportedTemporalTypeException - если единица измерения не поддерживается; ArithmeticException - если происходит числовое переполнение

plusYears

public LocalDateTime plusYears(long years)

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

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

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

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

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

Parameters:: years - количество лет для добавления, может быть отрицательным
Returns:: копия DateTime, основанная на этом объекте, с добавленными годами, не null
Throws:: DateTimeException - если результат выходит за пределы поддерживаемого диапазона дат

plusMonths

public LocalDateTime plusMonths(long months)

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

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

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

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

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

Parameters:: months - количество месяцев для добавления, может быть отрицательным
Returns:: копия DateTime, основанная на этом объекте, с добавленными месяцами, не null
Throws:: DateTimeException - если результат выходит за пределы поддерживаемого диапазона дат

plusWeeks

public LocalDateTime plusWeeks(long weeks)

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

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

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

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

Parameters:: weeks - количество недель для добавления, может быть отрицательным
Returns:: копия DateTime, основанная на этом объекте, с добавленными неделями, не null
Throws:: DateTimeException - если результат выходит за пределы поддерживаемого диапазона дат

plusDays

public LocalDateTime plusDays(long days)

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

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

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

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

Parameters:: days - количество дней для добавления, может быть отрицательным
Returns:: копия DateTime, основанная на этом объекте, с добавленными днями, не null
Throws:: DateTimeException - если результат выходит за пределы поддерживаемого диапазона дат

plusHours

public LocalDateTime plusHours(long hours)

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

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

Parameters:: hours - количество часов для добавления, может быть отрицательным
Returns:: копия DateTime, основанная на этом объекте, с добавленными часами, не null
Throws:: DateTimeException - если результат выходит за пределы поддерживаемого диапазона дат

plusMinutes

public LocalDateTime plusMinutes(long minutes)

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

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

Parameters:: minutes - количество минут для добавления, может быть отрицательным
Returns:: копия DateTime, основанная на этом объекте, с добавленными минутами, не null
Throws:: DateTimeException - если результат выходит за пределы поддерживаемого диапазона дат

plusSeconds

public LocalDateTime plusSeconds(long seconds)

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

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

Parameters:: seconds - количество секунд для добавления, может быть отрицательным
Returns:: копия DateTime, основанная на этом объекте, с добавленными секундами, не null
Throws:: DateTimeException - если результат выходит за пределы поддерживаемого диапазона дат

plusNanos

public LocalDateTime plusNanos(long nanos)

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

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

Parameters:: nanos - количество наносекунд для добавления, может быть отрицательным
Returns:: копия DateTime, основанная на этом объекте, с добавленными наносекундами, не null
Throws:: DateTimeException - если результат выходит за пределы поддерживаемого диапазона дат

minus

public LocalDateTime minus(TemporalAmount amountToSubtract)

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

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

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

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

Specified by:: minus в интерфейсе ChronoLocalDateTime<LocalDate>
Specified by:: minus в интерфейсе Temporal
Parameters:: amountToSubtract - количество для вычитания, не null
Returns:: копия DateTime, основанная на этом объекте, с вычитанием, не null
Throws:: DateTimeException - если вычитание невозможно; ArithmeticException - если происходит числовое переполнение

minus

public LocalDateTime minus(long amountToSubtract, TemporalUnit unit)

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

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

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

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

Определено в:: minus в интерфейсе ChronoLocalDateTime<LocalDate>
Определено в:: minus в интерфейсе Temporal
Параметры:: amountToSubtract - количество единиц, которые необходимо вычесть из результата, может быть отрицательным; unit - единица величины, которую необходимо вычесть, не null
Возвращает:: копия этой даты и времени с указанным значением, вычтенным, не null
Использует:: DateTimeException - если вычитание невозможно; UnsupportedTemporalTypeException - если единица не поддерживается; ArithmeticException - если происходит переполнение числового значения

minusYears

public LocalDateTime minusYears(long years)

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

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

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

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

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

Параметры:: years - годы для вычитания, может быть отрицательным
Возвращает:: копия LocalDateTime на основе этой даты и времени с вычтенными годами, не null
Использует:: DateTimeException - если результат выходит за поддерживаемый диапазон дат

minusMonths

public LocalDateTime minusMonths(long months)

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

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

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

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

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

Параметры:: months - месяцы для вычитания, может быть отрицательным
Возвращает:: копия LocalDateTime на основе этой даты и времени с вычтенными месяцами, не null
Использует:: DateTimeException - если результат выходит за поддерживаемый диапазон дат

minusWeeks

public LocalDateTime minusWeeks(long weeks)

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

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

Например, 2009-01-07 минус одна неделя даст 2008-12-31.

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

Параметры:: weeks - недели для вычитания, может быть отрицательным
Возвращает:: копия LocalDateTime на основе этой даты и времени с вычтенными неделями, не null
Использует:: DateTimeException - если результат выходит за поддерживаемый диапазон дат

minusDays

public LocalDateTime minusDays(long days)

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

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

Например, 2009-01-01 минус один день даст 2008-12-31.

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

Параметры:: days - дни для вычитания, может быть отрицательным
Возвращает:: копия LocalDateTime на основе этой даты и времени с вычтенными днями, не null
Использует:: DateTimeException - если результат выходит за поддерживаемый диапазон дат

minusHours

public LocalDateTime minusHours(long hours)

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

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

Параметры:: hours - часы для вычитания, может быть отрицательным
Возвращает:: копия LocalDateTime на основе этой даты и времени с вычтенными часами, не null
Использует:: DateTimeException - если результат выходит за поддерживаемый диапазон дат

minusMinutes

public LocalDateTime minusMinutes(long minutes)

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

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

Параметры:: minutes - минуты для вычитания, может быть отрицательным
Возвращает:: копия LocalDateTime на основе этой даты и времени с вычтенными минутами, не null
Использует:: DateTimeException - если результат выходит за поддерживаемый диапазон дат

minusSeconds

public LocalDateTime minusSeconds(long seconds)

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

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

Параметры:: seconds - секунды для вычитания, может быть отрицательным
Возвращает:: копия LocalDateTime на основе этой даты и времени с вычтенными секундами, не null
Использует:: DateTimeException - если результат выходит за поддерживаемый диапазон дат

minusNanos

public LocalDateTime minusNanos(long nanos)

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

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

Параметры:: nanos - наносекунды для вычитания, может быть отрицательным
Возвращает:: копия LocalDateTime на основе этой даты и времени с вычтенными наносекундами, не null
Использует:: DateTimeException - если результат выходит за поддерживаемый диапазон дат

query

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

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

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

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

Определено в:: query в интерфейсе ChronoLocalDateTime<LocalDate>
Определено в:: query в интерфейсе TemporalAccessor
Параметры типа:: R - тип результата
Параметры:: query - запрос для вызова, не null
Возвращает:: результат запроса, может быть null (определено запросом)
Использует:: DateTimeException - если запрос невозможен (определено запросом); ArithmeticException - если происходит переполнение числового значения (определено запросом)

adjustInto

public Temporal adjustInto(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);

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

Определено в:: adjustInto в интерфейсе ChronoLocalDateTime<LocalDate>
Определено в:: adjustInto в интерфейсе TemporalAdjuster
Параметры:: temporal - целевой объект для корректировки, не null
Возвращает:: откорректированный объект, не null
Использует:: DateTimeException - если корректировка невозможна; ArithmeticException - если происходит переполнение числового значения

until

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 в качестве первого аргумента и преобразованный входной временной параметр — в качестве второго.

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

Specified by:: until в интерфейсе Temporal
Parameters:: endExclusive - конечная дата, исключая, которая преобразуется в LocalDateTime, не null; unit - единица измерения количества, не null
Returns:: количество времени между этой датой-временем и конечной датой-временем
Throws:: DateTimeException - если количество нельзя вычислить или конечную временную точку нельзя преобразовать в LocalDateTime; UnsupportedTemporalTypeException - если единица не поддерживается; ArithmeticException - если происходит переполнение числовых данных

format

public String format(DateTimeFormatter formatter)

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

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

Specified by:: format в интерфейсе ChronoLocalDateTime<LocalDate>
Parameters:: formatter - используемый форматер, не null
Returns:: строка отформатированной даты-времени, не null
Throws:: DateTimeException - если во время печати произошла ошибка

atOffset

public OffsetDateTime atOffset(ZoneOffset offset)

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

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

Parameters:: offset - смещение для объединения, не null
Returns:: дата-время со смещением, сформированная из этой даты-времени и указанного смещения, не null

atZone

public ZonedDateTime atZone(ZoneId zone)

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

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

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

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

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

Specified by:: atZone в интерфейсе ChronoLocalDateTime<LocalDate>
Parameters:: zone - используемый часовой пояс, не null
Returns:: зоновая дата-время, сформированная из этой даты-времени, не null

compareTo

public int compareTo(ChronoLocalDateTime<?> other)

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

Сравнение в основном основано на дате-времени, от наираньшей к наипозднейшей. Оно «совместимо с equals», как определено в Comparable.

Если все сравниваемые даты-времена являются экземплярами LocalDateTime, то сравнение будет основано исключительно на дате-времени. Если некоторые сравниваемые даты находятся в разных хронологиях, то учитывается и хронология, см. ChronoLocalDateTime.compareTo(java.time.chrono.ChronoLocalDateTime<?>).

Specified by:: compareTo в интерфейсе ChronoLocalDateTime<LocalDate>
Specified by:: compareTo в интерфейсе Comparable<ChronoLocalDateTime<?>>
Parameters:: other - другая дата-время для сравнения, не null
Returns:: значение компаратора, отрицательное, если меньше, положительное, если больше

isAfter

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().

Specified by:: isAfter в интерфейсе ChronoLocalDateTime<LocalDate>
Parameters:: other - другая дата-время для сравнения, не null
Returns:: true, если эта дата-время находится после указанной даты-времени

isBefore

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

Specified by:: isBefore в интерфейсе ChronoLocalDateTime<LocalDate>
Parameters:: other - другая дата-время для сравнения, не null
Returns:: true, если эта дата-время находится до указанной даты-времени

isEqual

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

Specified by:: isEqual в интерфейсе ChronoLocalDateTime<LocalDate>
Parameters:: other - другая дата-время для сравнения, не null
Returns:: true, если эта дата-время равна указанной дате-времени

equals

public boolean equals(Object obj)

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

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

Specified by:

equals в интерфейсе ChronoLocalDateTime<LocalDate>

Overrides:

equals в классе Object

Parameters:

obj - проверяемый объект, null возвращает false

Returns:

true, если это равно другой дате-времени

See Also:

END_OF_DOCUMENT_MARKER

hashCode

public int hashCode()

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

Определено в:

hashCode в интерфейсе ChronoLocalDateTime<LocalDate>

Переопределяет:

hashCode в классе Object

Возвращает:

подходящий хэш-код

См. также:

toString

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

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

Определено в:: toString в интерфейсе ChronoLocalDateTime<LocalDate>
Переопределяет:: toString в классе Object
Возвращает:: строковое представление этого времени, не null

© 1993, 2021, Oracle and/or its affiliates. All rights reserved.
Documentation extracted from Debian's OpenJDK Development Kit package.
Licensed under the GNU General Public License, version 2, with the Classpath Exception.
Various third party code in OpenJDK is licensed under different licenses (see Debian package).
Java and OpenJDK are trademarks or registered trademarks of Oracle and/or its affiliates.
https://docs.oracle.com/en/java/javase/17/docs/api/java.base/java/time/LocalDateTime.html