Класс LocalTime

public static final LocalTime MIN

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

public static final LocalTime MAX

Максимальное поддерживаемое значение LocalTime, '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)

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

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

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

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