Класс LocalTime

public static final LocalTime MIN

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

public static final LocalTime MAX

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

public static final LocalTime MIDNIGHT

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

public static final LocalTime NOON

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

public static LocalTime now()

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

Это запрашивает system clock в часовом поясе по умолчанию для получения текущего времени.

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

public static LocalTime now(ZoneId zone)

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

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

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

public static LocalTime now(Clock clock)

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

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

public static LocalTime of(int hour, int minute)

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

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

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

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

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

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

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

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

public static LocalTime ofInstant(Instant instant, ZoneId zone)

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

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

public static LocalTime ofSecondOfDay(long secondOfDay)

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

Это возвращает LocalTime с указанной секундой дня. Поле наносекунда будет установлено в ноль.

public static LocalTime ofNanoOfDay(long nanoOfDay)

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

Это возвращает LocalTime с указанной наносекундой дня.

public static LocalTime from(TemporalAccessor temporal)

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

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

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

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

public static LocalTime parse(CharSequence text)

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

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

public static LocalTime parse(CharSequence text, DateTimeFormatter formatter)

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

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

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

Все остальные ChronoField объекты вернут false.

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

public boolean isSupported(TemporalUnit unit)

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

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

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

• NANOS
• MICROS
• MILLIS
• SECONDS
• MINUTES
• HOURS
• HALF_DAYS

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

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

public ValueRange range(TemporalField field)

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

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

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

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

public int get(TemporalField field)

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

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

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

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

public long getLong(TemporalField field)

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

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

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

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

public int getHour()

Возвращает поле час.

public int getMinute()

Возвращает поле минута.

public int getSecond()

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

public int getNano()

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

public LocalTime with(TemporalAdjuster adjuster)

Возвращает скопированное время, измененное на основе данного.

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

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

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

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

public LocalTime with(TemporalField field, long newValue)

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

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

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

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

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

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

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

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

public LocalTime withHour(int hour)

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

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

public LocalTime withMinute(int minute)

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

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

public LocalTime withSecond(int second)

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

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

public LocalTime withNano(int nanoOfSecond)

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

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

public LocalTime truncatedTo(TemporalUnit unit)

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

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

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

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

public LocalTime plus(TemporalAmount amountToAdd)

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

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

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

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

public LocalTime plus(long amountToAdd, TemporalUnit unit)

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

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

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

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

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

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

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

public LocalTime plusHours(long hoursToAdd)

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

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

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

public LocalTime plusMinutes(long minutesToAdd)

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

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

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

public LocalTime plusSeconds(long secondstoAdd)

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

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

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

public LocalTime plusNanos(long nanosToAdd)

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

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

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

public LocalTime minus(TemporalAmount amountToSubtract)

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

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

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

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

public LocalTime minus(long amountToSubtract, TemporalUnit unit)

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

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

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

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

public LocalTime minusHours(long hoursToSubtract)

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

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

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

public LocalTime minusMinutes(long minutesToSubtract)

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

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

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

public LocalTime minusSeconds(long secondsToSubtract)

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

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

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

public LocalTime minusNanos(long nanosToSubtract)

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

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

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

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

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

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

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

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);
 

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

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

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

public String format(DateTimeFormatter formatter)

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

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

public LocalDateTime atDate(LocalDate date)

Объединяет это время с датой для создания LocalDateTime.

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

public OffsetTime atOffset(ZoneOffset offset)

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

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

public int toSecondOfDay()

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

public long toNanoOfDay()

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

public long toEpochSecond(LocalDate date, ZoneOffset offset)

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

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

public int compareTo(LocalTime other)

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

Сравнение основано на позиции локальных времен на временной шкале в течение дня. Оно "согласуется с equals", как определено в Comparable.

public boolean isAfter(LocalTime other)

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

Сравнение основано на позиции времени на временной шкале в течение дня.

public boolean isBefore(LocalTime other)

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

Сравнение основано на позиции времени на временной шкале в течение дня.

public boolean equals(Object obj)

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

Сравнение основано на позиции времени на временной шкале в течение дня.

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

public int hashCode()

Код хэша для этого времени.

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

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