Класс LocalTime

public static final LocalTime MIN

public static final LocalTime MAX

public static final LocalTime MIDNIGHT

public static final LocalTime NOON

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 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 и выбрасывают DateTimeException. Все другие 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)

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

Возвращает 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 с указанным часом AM/PM. AM/PM, минута, секунда и наносекунды останутся неизменными.
• HOUR_OF_DAY - Возвращает LocalTime с указанным часом. Минута, секунда и наносекунды останутся неизменными.
• CLOCK_HOUR_OF_DAY - Возвращает LocalTime с указанным часом. Минута, секунда и наносекунды останутся неизменными.
• AMPM_OF_DAY - Возвращает LocalTime с указанным значением AM/PM. Час, минута, секунда и наносекунды останутся неизменными.

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

Все остальные 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)

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

Это возвращает LocalTime, основанный на этом, с добавленным указанным значением. Значение обычно является 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()

public long toNanoOfDay()

public int compareTo(LocalTime other)

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

Сравнение основано на временной позиции локального времени в течение дня. Оно «совместимо с равенством», как определено в 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

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