Класс 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)

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

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

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

Результат этого метода получается путем вызова метода 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)

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

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

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

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)

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

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

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

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

public LocalTime minus(long amountToSubtract, TemporalUnit unit)

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

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

Этот метод эквивалентен 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

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