Класс LocalTime

java.lang.Object
- java.time.LocalTime

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

public final class LocalTime
extends Object
implements Temporal, TemporalAdjuster, Comparable<LocalTime>, Serializable

Время без часового пояса в системе календаря ISO-8601, например 10:15:30.

LocalTime — это неизменяемый объект даты и времени, представляющий время, часто отображаемое как час-минута-секунда. Время представлено с точностью до наносекунд. Например, значение "13:45.30.123456789" может быть сохранено в LocalTime.

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

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

Это значимый класс; использование операций, чувствительных к идентичности (включая равенство ссылок (==), хэш-код идентичности или синхронизацию) на экземплярах LocalTime может привести к непредсказуемым результатам и следует избегать. Для сравнения следует использовать метод equals.

Требования к реализации:: Этот класс неизменяемый и потокобезопасный.
С:: 1.8
См. также:: Сериализованная форма

Поля

Модификатор и тип	Поле	Описание
`static LocalTime`	`MAX`	Максимальное поддерживаемое время, '23:59:59.999999999'.
`static LocalTime`	`MIDNIGHT`	Время полуночи в начале дня, '00:00'.
`static LocalTime`	`MIN`	Минимальное поддерживаемое время, '00:00'.
`static LocalTime`	`NOON`	Время полдня, '12:00'.

Методы

Модификатор и тип	Метод	Описание
`Temporal`	`adjustInto(Temporal temporal)`	Настраивает указанный временной объект на совпадение времени с этим объектом.
`LocalDateTime`	`atDate(LocalDate date)`	Объединяет это время с датой для создания `LocalDateTime`.
`OffsetTime`	`atOffset(ZoneOffset offset)`	Объединяет это время со смещением для создания `OffsetTime`.
`int`	`compareTo(LocalTime other)`	Сравнивает это время с другим временем.
`boolean`	`equals(Object obj)`	Проверяет, равно ли это время другому времени.
`String`	`format(DateTimeFormatter formatter)`	Форматирует это время с использованием указанного форматировщика.
`static LocalTime`	`from(TemporalAccessor temporal)`	Получает экземпляр `LocalTime` из временного объекта.
`int`	`get(TemporalField field)`	Получает значение указанного поля из этого времени как `int`.
`int`	`getHour()`	Получает поле часа.
`long`	`getLong(TemporalField field)`	Получает значение указанного поля из этого времени как `long`.
`int`	`getMinute()`	Получает поле минуты.
`int`	`getNano()`	Получает поле наносекунд.
`int`	`getSecond()`	Получает поле секунды.
`int`	`hashCode()`	Хеш-код для этого времени.
`boolean`	`isAfter(LocalTime other)`	Проверяет, предшествует ли это время указанному времени.
`boolean`	`isBefore(LocalTime other)`	Проверяет, следует ли это время после указанного времени.
`boolean`	`isSupported(TemporalField field)`	Проверяет, поддерживается ли указанное поле.
`boolean`	`isSupported(TemporalUnit unit)`	Проверяет, поддерживается ли указанная единица.
`LocalTime`	`minus(long amountToSubtract, TemporalUnit unit)`	Возвращает копию этого времени с вычетом указанного значения.
`LocalTime`	`minus(TemporalAmount amountToSubtract)`	Возвращает копию этого времени с вычетом указанного значения.
`LocalTime`	`minusHours(long hoursToSubtract)`	Возвращает копию этого `LocalTime` с вычетом указанного количества часов.
`LocalTime`	`minusMinutes(long minutesToSubtract)`	Возвращает копию этого `LocalTime` с вычетом указанного количества минут.
`LocalTime`	`minusNanos(long nanosToSubtract)`	Возвращает копию этого `LocalTime` с вычетом указанного количества наносекунд.
`LocalTime`	`minusSeconds(long secondsToSubtract)`	Возвращает копию этого `LocalTime` с вычетом указанного количества секунд.
`static LocalTime`	`now()`	Получает текущее время с системных часов в часовом поясе по умолчанию.
`static LocalTime`	`now(Clock clock)`	Получает текущее время с указанных часов.
`static LocalTime`	`now(ZoneId zone)`	Получает текущее время с системных часов в указанном часовом поясе.
`static LocalTime`	`of(int hour, int minute)`	Получает экземпляр `LocalTime` из часа и минуты.
`static LocalTime`	`of(int hour, int minute, int second)`	Получает экземпляр `LocalTime` из часа, минуты и секунды.
`static LocalTime`	`of(int hour, int minute, int second, int nanoOfSecond)`	Получает экземпляр `LocalTime` из часа, минуты, секунды и наносекунды.
`static LocalTime`	`ofInstant(Instant instant, ZoneId zone)`	Получает экземпляр `LocalTime` из `Instant` и идентификатора часового пояса.
`static LocalTime`	`ofNanoOfDay(long nanoOfDay)`	Получает экземпляр `LocalTime` из значения наносекунд в сутках.
`static LocalTime`	`ofSecondOfDay(long secondOfDay)`	Получает экземпляр `LocalTime` из значения секунд в сутках.
`static LocalTime`	`parse(CharSequence text)`	Получает экземпляр `LocalTime` из строковой переменной, например, `10:15`.
`static LocalTime`	`parse(CharSequence text, DateTimeFormatter formatter)`	Получает экземпляр `LocalTime` из строковой переменной с использованием определенного форматировщика.
`LocalTime`	`plus(long amountToAdd, TemporalUnit unit)`	Возвращает копию этого времени с добавлением указанного значения.
`LocalTime`	`plus(TemporalAmount amountToAdd)`	Возвращает копию этого времени с добавлением указанного значения.
`LocalTime`	`plusHours(long hoursToAdd)`	Возвращает копию этого `LocalTime` с добавлением указанного количества часов.
`LocalTime`	`plusMinutes(long minutesToAdd)`	Возвращает копию этого `LocalTime` с добавлением указанного количества минут.
`LocalTime`	`plusNanos(long nanosToAdd)`	Возвращает копию этого `LocalTime` с добавлением указанного количества наносекунд.
`LocalTime`	`plusSeconds(long secondstoAdd)`	Возвращает копию этого `LocalTime` с добавлением указанного количества секунд.
`<R> R`	`query(TemporalQuery<R> query)`	Обрабатывает это время с использованием указанного запроса.
`ValueRange`	`range(TemporalField field)`	Получает диапазон допустимых значений для указанного поля.
`long`	`toEpochSecond(LocalDate date, ZoneOffset offset)`	Преобразует это `LocalTime` в количество секунд с начала эпохи 1970-01-01T00:00:00Z.
`long`	`toNanoOfDay()`	Извлекает время как наносекунды в сутках, от `0` до `24 * 60 * 60 * 1,000,000,000 - 1`.
`int`	`toSecondOfDay()`	Извлекает время как секунды в сутках, от `0` до `24 * 60 * 60 - 1`.
`String`	`toString()`	Выводит это время как `String`, например, `10:15`.
`LocalTime`	`truncatedTo(TemporalUnit unit)`	Возвращает копию этого `LocalTime` с усеченным временем.
`long`	`until(Temporal endExclusive, TemporalUnit unit)`	Вычисляет время до другого времени в указанных единицах.
`LocalTime`	`with(TemporalAdjuster adjuster)`	Возвращает скорректированную копию этого времени.
`LocalTime`	`with(TemporalField field, long newValue)`	Возвращает копию этого времени с указанным полем, установленным на новое значение.
`LocalTime`	`withHour(int hour)`	Возвращает копию этого `LocalTime` с измененным часом.
`LocalTime`	`withMinute(int minute)`	Возвращает копию этого `LocalTime` с измененной минутой.
`LocalTime`	`withNano(int nanoOfSecond)`	Возвращает копию этого `LocalTime` с измененной наносекундой.
`LocalTime`	`withSecond(int second)`	Возвращает копию этого `LocalTime` с измененной секундой.

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

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

Поля

MIN

public static final LocalTime MIN

Минимальное поддерживаемое значение времени, '00:00'. Это время полуночи в начале дня.

MAX

public static final LocalTime MAX

Максимальное поддерживаемое значение времени, '23:59:59.999999999'. Это время непосредственно перед полуночью в конце дня.

MIDNIGHT

public static final LocalTime MIDNIGHT

Время полуночи в начале дня, '00:00'.

NOON

public static final LocalTime NOON

Время полудня в середине дня, '12:00'.

Методы

now

public static LocalTime now()

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

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

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

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

now

public static LocalTime now(ZoneId zone)

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

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

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

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

now

public static LocalTime now(Clock clock)

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

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

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

of

public static LocalTime of(int hour,
                           int minute)

Получает экземпляр LocalTime из часа и минуты.

Это возвращает LocalTime со специфицированным часом и минутой. Секунды и наносекунды будут установлены в ноль.

Параметры:: hour - час, от 0 до 23; minute - минута, от 0 до 59
Возвращает:: местное время, не null
Исключения:: DateTimeException - если значение любого поля выходит за пределы диапазона

of

public static LocalTime of(int hour,
                           int minute,
                           int second)

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

Это возвращает LocalTime со специфицированными часом, минутой и секундой. Наносекунды будут установлены в ноль.

Параметры:: hour - час, от 0 до 23; minute - минута, от 0 до 59; second - секунда, от 0 до 59
Возвращает:: местное время, не null
Исключения:: DateTimeException - если значение любого поля выходит за пределы диапазона

of

public static LocalTime of(int hour,
                           int minute,
                           int second,
                           int nanoOfSecond)

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

Это возвращает LocalTime со специфицированными часом, минутой, секундой и наносекундами.

Параметры:: hour - час, от 0 до 23; minute - минута, от 0 до 59; second - секунда, от 0 до 59; nanoOfSecond - наносекунды, от 0 до 999 999 999
Возвращает:: местное время, не null
Исключения:: DateTimeException - если значение любого поля выходит за пределы диапазона

ofInstant

public static LocalTime ofInstant(Instant instant,
                                  ZoneId zone)

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

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

Параметры:: instant - момент времени для создания времени, не null; zone - часовой пояс, который может быть смещением, не null
Возвращает:: местное время, не null
С тех пор:: 9

ofSecondOfDay

public static LocalTime ofSecondOfDay(long secondOfDay)

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

Это возвращает LocalTime со специфицированной секундой дня. Наносекунды будут установлены в ноль.

Параметры:: secondOfDay - секунда дня, от 0 до 24 * 60 * 60 - 1
Возвращает:: местное время, не null
Исключения:: DateTimeException - если значение секунды дня неверно

ofNanoOfDay

public static LocalTime ofNanoOfDay(long nanoOfDay)

Получает экземпляр LocalTime из значения наносекунд дня.

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

Параметры:: nanoOfDay - наносекунды дня, от 0 до 24 * 60 * 60 * 1,000,000,000 - 1
Возвращает:: местное время, не null
Исключения:: DateTimeException - если значение наносекунд дня неверно

from

public static LocalTime from(TemporalAccessor temporal)

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

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

Преобразование использует запрос TemporalQueries.localTime(), который полагается на извлечение поля NANO_OF_DAY.

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

Параметры:: temporal - временной объект для преобразования, не null
Возвращает:: местное время, не null
Исключения:: DateTimeException - если невозможно преобразовать в LocalTime

parse

public static LocalTime parse(CharSequence text)

Получает экземпляр LocalTime из текстовой строки, такой как 10:15.

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

Параметры:: text - текст для разбора, например, "10:15:30", не null
Возвращает:: разбор местного времени, не null
Исключения:: DateTimeParseException - если текст не может быть обработан

parse

public static LocalTime parse(CharSequence text,
                              DateTimeFormatter formatter)

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

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

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

isSupported

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

Все другие ChronoField объекты вернут ложь.

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

Определено в:: isSupported в интерфейсе TemporalAccessor
Параметры:: field - поле для проверки, null возвращает ложь
Возвращает:: истина, если поле поддерживается, ложь, если нет

isSupported

public boolean isSupported(TemporalUnit unit)

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

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

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

NANOS
MICROS
MILLIS
SECONDS
MINUTES
HOURS
HALF_DAYS

Все другие ChronoUnit объекты вернут ложь.

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

Определено в:: isSupported в интерфейсе Temporal
Параметры:: unit - интервал для проверки, null возвращает ложь
Возвращает:: истина, если интервал может быть добавлен/вычтен, ложь, если нет

range

public ValueRange range(TemporalField field)

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

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

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

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

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

get

public int get(TemporalField field)

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

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

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

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

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

getLong

public long getLong(TemporalField field)

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

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

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

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

getHour

public int getHour()

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

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

getMinute

public int getMinute()

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

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

getSecond

public int getSecond()

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

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

getNano

public int getNano()

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

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

with

public LocalTime with(TemporalAdjuster adjuster)

Возвращает скопированное время с внесённой корректировкой.

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

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

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

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

Определено в:: with в интерфейсе Temporal
Параметры:: adjuster - используемый корректировщик, не null
Возвращает:: экземпляр LocalTime на основе this с произведённой корректировкой, не null
Исключение:: DateTimeException - если корректировка не может быть произведена; ArithmeticException - если произошёл численный переполнение

with

public LocalTime with(TemporalField field,
                      long newValue)

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

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

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

NANO_OF_SECOND - Возвращает LocalTime с указанной наносекундой. Час, минута и секунда не изменятся.
NANO_OF_DAY - Возвращает LocalTime с указанным числом наносекунд в течение дня. Это полностью заменяет время и эквивалентно ofNanoOfDay(long).
MICRO_OF_SECOND - Возвращает LocalTime с наносекундами, заменёнными указанными микросекундами, умноженными на 1000. Час, минута и секунда не изменятся.
MICRO_OF_DAY - Возвращает LocalTime с указанным числом микросекунд в течение дня. Это полностью заменяет время и эквивалентно использованию ofNanoOfDay(long) с микросекундами, умноженными на 1000.
MILLI_OF_SECOND - Возвращает LocalTime с наносекундами, заменёнными указанными миллисекундами, умноженными на 1 000 000. Час, минута и секунда не изменятся.
MILLI_OF_DAY - Возвращает LocalTime с указанными миллисекундами в течение дня. Это полностью заменяет время и эквивалентно использованию ofNanoOfDay(long) с миллисекундами, умноженными на 1 000 000.
SECOND_OF_MINUTE - Возвращает LocalTime с указанной секундой. Час, минута и наносекунда не изменятся.
SECOND_OF_DAY - Возвращает LocalTime с указанной секундой в течение дня. Наносекунда не изменится.
MINUTE_OF_HOUR - Возвращает LocalTime с указанной минутой. Час, секунда и наносекунда не изменятся.
MINUTE_OF_DAY - Возвращает LocalTime с указанной минутой в течение дня. Секунда и наносекунда не изменятся.
HOUR_OF_AMPM - Возвращает LocalTime с указанным часом (AM/PM). AM/PM, минута, секунда и наносекунда не изменятся.
CLOCK_HOUR_OF_AMPM - Возвращает LocalTime с указанным часом (24-часовой формат). AM/PM, минута, секунда и наносекунда не изменятся.
HOUR_OF_DAY - Возвращает LocalTime с указанным часом. Минута, секунда и наносекунда не изменятся.
CLOCK_HOUR_OF_DAY - Возвращает LocalTime с указанным 24-часовым часом. Минута, секунда и наносекунда не изменятся.
AMPM_OF_DAY - Возвращает LocalTime с указанным значением AM/PM. Час (AM/PM), минута, секунда и наносекунда не изменятся.

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

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

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

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

Определено в:: with в интерфейсе Temporal
Параметры:: field - поле для установки в результате, не null; newValue - новое значение поля в результате
Возвращает:: экземпляр LocalTime на основе this с установленным полем, не null
Исключение:: DateTimeException - если поле нельзя установить; UnsupportedTemporalTypeException - если поле не поддерживается; ArithmeticException - если произошёл численный переполнение

withHour

public LocalTime withHour(int hour)

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

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

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

withMinute

public LocalTime withMinute(int minute)

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

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

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

withSecond

public LocalTime withSecond(int second)

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

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

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

withNano

public LocalTime withNano(int nanoOfSecond)

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

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

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

truncatedTo

public LocalTime truncatedTo(TemporalUnit unit)

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

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

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

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

Параметры:: unit - единица измерения для усечения, не null
Возвращает:: объект LocalTime на основе этого времени с усечённым временем, не null
Выбрасывает:: DateTimeException - если усечение невозможно; UnsupportedTemporalTypeException - если единица измерения не поддерживается

plus

public LocalTime plus(TemporalAmount amountToAdd)

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

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

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

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

Определено в:: plus в интерфейсе Temporal
Параметры:: amountToAdd - количество для добавления, не null
Возвращает:: объект LocalTime на основе этого времени с произведённым добавлением, не null
Выбрасывает:: DateTimeException - если добавление невозможно; ArithmeticException - если произошёл переполнение числовых значений

plus

public LocalTime plus(long amountToAdd,
                      TemporalUnit unit)

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

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

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

NANOS - Возвращает LocalTime с добавлением указанного количества наносекунд. Это эквивалентно plusNanos(long).
MICROS - Возвращает LocalTime с добавлением указанного количества микросекунд. Это эквивалентно plusNanos(long) с количеством, умноженным на 1000.
MILLIS - Возвращает LocalTime с добавлением указанного количества миллисекунд. Это эквивалентно plusNanos(long) с количеством, умноженным на 1 000 000.
SECONDS - Возвращает LocalTime с добавлением указанного количества секунд. Это эквивалентно plusSeconds(long).
MINUTES - Возвращает LocalTime с добавлением указанного количества минут. Это эквивалентно plusMinutes(long).
HOURS - Возвращает LocalTime с добавлением указанного количества часов. Это эквивалентно plusHours(long).
HALF_DAYS - Возвращает LocalTime с добавлением указанного количества полусуток. Это эквивалентно plusHours(long) с количеством, умноженным на 12.

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

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

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

Определено в:: plus в интерфейсе Temporal
Параметры:: amountToAdd - количество единицы измерения для добавления в результат, может быть отрицательным; unit - единица измерения количества для добавления, не null
Возвращает:: объект LocalTime на основе этого времени с добавлением указанного количества, не null
Выбрасывает:: DateTimeException - если добавление невозможно; UnsupportedTemporalTypeException - если единица измерения не поддерживается; ArithmeticException - если произошёл переполнение числовых значений

plusHours

public LocalTime plusHours(long hoursToAdd)

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

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

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

Параметры:: hoursToAdd - часы для добавления, могут быть отрицательными
Возвращает:: объект LocalTime на основе этого времени с добавленными часами, не null

plusMinutes

public LocalTime plusMinutes(long minutesToAdd)

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

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

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

Параметры:: minutesToAdd - минуты для добавления, могут быть отрицательными
Возвращает:: объект LocalTime на основе этого времени с добавленными минутами, не null

plusSeconds

public LocalTime plusSeconds(long secondstoAdd)

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

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

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

Параметры:: secondstoAdd - секунды для добавления, могут быть отрицательными
Возвращает:: объект LocalTime на основе этого времени с добавленными секундами, не null

plusNanos

public LocalTime plusNanos(long nanosToAdd)

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

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

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

Параметры:: nanosToAdd - наносекунды для добавления, могут быть отрицательными
Возвращает:: объект LocalTime на основе этого времени с добавленными наносекундами, не null

minus

public LocalTime minus(TemporalAmount amountToSubtract)

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

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

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

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

Specified by:: minus in interface Temporal
Parameters:: amountToSubtract - величина для вычитания, не null
Returns:: a LocalTime на основе этого времени с выполненным вычитанием, не null
Throws:: DateTimeException - если вычитание не может быть выполнено; ArithmeticException - если происходит переполнение числового типа

minus

public LocalTime minus(long amountToSubtract,
                       TemporalUnit unit)

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

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

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

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

Specified by:: minus in interface Temporal
Parameters:: amountToSubtract - величина единицы для вычитания из результата, может быть отрицательной; unit - единица величины для вычитания, не null
Returns:: a LocalTime на основе этого времени с вычтенной указанной величиной, не null
Throws:: DateTimeException - если вычитание не может быть выполнено; UnsupportedTemporalTypeException - если единица не поддерживается; ArithmeticException - если происходит переполнение числового типа

minusHours

public LocalTime minusHours(long hoursToSubtract)

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

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

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

Parameters:: hoursToSubtract - часы для вычитания, могут быть отрицательными
Returns:: a LocalTime на основе этого времени с вычтенными часами, не null

minusMinutes

public LocalTime minusMinutes(long minutesToSubtract)

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

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

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

Parameters:: minutesToSubtract - минуты для вычитания, могут быть отрицательными
Returns:: a LocalTime на основе этого времени с вычтенными минутами, не null

minusSeconds

public LocalTime minusSeconds(long secondsToSubtract)

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

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

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

Parameters:: secondsToSubtract - секунды для вычитания, могут быть отрицательными
Returns:: a LocalTime на основе этого времени с вычтенными секундами, не null

minusNanos

public LocalTime minusNanos(long nanosToSubtract)

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

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

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

Parameters:: nanosToSubtract - наносекунды для вычитания, могут быть отрицательными
Returns:: a LocalTime на основе этого времени с вычтенными наносекундами, не null

query

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

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

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

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

Specified by:: query in interface TemporalAccessor
Type Parameters:: R - тип результата
Parameters:: query - запрос для вызова, не null
Returns:: результат запроса, может быть возвращено null (определяется запросом)
Throws:: DateTimeException - если запрос не может быть выполнен (определяется запросом); ArithmeticException - если происходит переполнение числового типа (определяется запросом)

adjustInto

public Temporal adjustInto(Temporal temporal)

Корректирует указанный временной объект, чтобы он имел такое же время, как и этот объект.

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

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

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

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

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

Specified by:: adjustInto in interface TemporalAdjuster
Parameters:: temporal - целевой объект для корректировки, не null
Returns:: скорректированный объект, не null
Throws:: DateTimeException - если корректировку выполнить невозможно; ArithmeticException - если происходит переполнение числового типа

until

public long until(Temporal endExclusive,
                  TemporalUnit unit)

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

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

Расчет возвращает целое число, представляющее количество полных единиц между двумя временами. Например, количество часов между 11:30 и 13:29 будет только один час, так как это на одну минуту меньше двух часов.

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

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

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

Расчет реализован в этом методе для ChronoUnit. Поддерживаются единицы NANOS, MICROS, MILLIS, SECONDS, MINUTES, HOURS и HALF_DAYS. Другие значения ChronoUnit приведут к исключению.

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

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

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

format

public String format(DateTimeFormatter formatter)

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

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

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

atDate

public LocalDateTime atDate(LocalDate date)

Сочетает это время с датой для создания LocalDateTime.

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

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

atOffset

public OffsetTime atOffset(ZoneOffset offset)

Сочетает это время со смещением для создания OffsetTime.

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

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

toSecondOfDay

public int toSecondOfDay()

Извлекает время как секунды дня, от 0 до 24 * 60 * 60 - 1.

Returns:: эквивалент этого времени в секундах дня

toNanoOfDay

public long toNanoOfDay()

Извлекает время как наносекунды дня, от 0 до 24 * 60 * 60 * 1,000,000,000 - 1.

Returns:: эквивалент этого времени в наносекундах дня

toEpochSecond

public long toEpochSecond(LocalDate date,
                          ZoneOffset offset)

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

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

Параметры:: date - локальная дата, не null; offset - смещение часового пояса, не null
Возвращает:: количество секунд с начала эпохи 1970-01-01T00:00:00Z, может быть отрицательным
С:: 9

compareTo

public int compareTo(LocalTime other)

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

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

Определено в:: compareTo в интерфейсе Comparable<LocalTime>
Параметры:: other - другое время для сравнения, не null
Возвращает:: значение компаратора, отрицательное, если меньше, положительное, если больше

isAfter

public boolean isAfter(LocalTime other)

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

Сравнение основано на временной позиции времени в течение суток.

Параметры:: other - другое время для сравнения, не null
Возвращает:: true, если это время после указанного

isBefore

public boolean isBefore(LocalTime other)

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

Сравнение основано на временной позиции времени в течение суток.

Параметры:: other - другое время для сравнения, не null
Возвращает:: true, если этот момент времени до указанного

equals

public boolean equals(Object obj)

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

Сравнение основано на временной позиции времени в течение суток.

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

Переопределяет:: equals в классе Object
Параметры:: obj - объект для проверки, null возвращает false
Возвращает:: true, если это время равно другому времени
См. также:: Object.hashCode(), HashMap

hashCode

public int hashCode()

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

Переопределяет:: hashCode в классе Object
Возвращает:: подходящий хеш-код
См. также:: Object.equals(java.lang.Object), System.identityHashCode(java.lang.Object)

toString

public String toString()

Выводит это время как String, например 10:15.

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

HH:mm
HH:mm:ss
HH:mm:ss.SSS
HH:mm:ss.SSSSSS
HH:mm:ss.SSSSSSSSS

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

Переопределяет:: toString в классе Object
Возвращает:: строковое представление этого времени, не null

© 1993, 2020, 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/11/docs/api/java.base/java/time/LocalTime.html