Класс OffsetTime

public static final OffsetTime MIN

public static final OffsetTime MAX

public static OffsetTime now()

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

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

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

public static OffsetTime now(ZoneId zone)

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

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

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

public static OffsetTime now(Clock clock)

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

Будет запрошен указанный объект часов для получения текущего времени. Смещение будет вычислено из часового пояса в часах.

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

public static OffsetTime of(LocalTime time,
                            ZoneOffset offset)

public static OffsetTime of(int hour,
                            int minute,
                            int second,
                            int nanoOfSecond,
                            ZoneOffset offset)

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

Создаёт время со смещением с четырьмя указанными полями.

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

public static OffsetTime ofInstant(Instant instant,
                                   ZoneId zone)

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

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

Компонент даты из мгновения отбрасывается во время преобразования. Это означает, что преобразование никогда не может завершиться неудачно из-за того, что мгновение находится вне допустимого диапазона дат.

public static OffsetTime from(TemporalAccessor temporal)

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

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

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

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

public static OffsetTime parse(CharSequence text)

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

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

public static OffsetTime parse(CharSequence text,
                               DateTimeFormatter formatter)

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

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

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
• OFFSET_SECONDS

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

Получает смещение зоны, например, '+01:00'.

Это смещение локального времени от UTC/Гринвича.

public OffsetTime withOffsetSameLocal(ZoneOffset offset)

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

Этот метод возвращает объект с тем же LocalTime и указанным ZoneOffset. Вычисления не требуются и не выполняются. Например, если это время представляет 10:30+02:00 и указанное смещение - +03:00, то этот метод вернет 10:30+03:00.

Для учета разницы во временных зонах и корректировки полей времени используйте withOffsetSameInstant(java.time.ZoneOffset).

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

public OffsetTime withOffsetSameInstant(ZoneOffset offset)

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

Этот метод возвращает объект с указанным ZoneOffset и LocalTime скорректированным на разницу между двумя смещениями. В результате старый и новый объекты будут представлять тот же момент времени в неявный день. Это полезно для определения локального времени в другом смещении. Например, если это время представляет 10:30+02:00 и указанное смещение - +03:00, то этот метод вернет 11:30+03:00.

Для изменения смещения без корректировки локального времени используйте withOffsetSameLocal(java.time.ZoneOffset).

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

public LocalTime toLocalTime()

Получает часть LocalTime этой даты и времени.

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

public int getHour()

public int getMinute()

public int getSecond()

public int getNano()

public OffsetTime with(TemporalAdjuster adjuster)

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

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

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

Классы LocalTime и ZoneOffset реализуют TemporalAdjuster, поэтому этот метод можно использовать для изменения времени или смещения:

result = offsetTime.with(time);
  result = offsetTime.with(offset);

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

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

public OffsetTime with(TemporalField field,
                       long newValue)

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

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

Если поле является ChronoField, то коррекция выполняется здесь.

Поле OFFSET_SECONDS вернёт время с указанным смещением. Локальное время не изменяется. Если новое значение смещения выходит за пределы допустимого диапазона, будет выброшено исключение DateTimeException.

Другие supported fields будут вести себя в соответствии с соответствующим методом в LocalTime.with(TemporalField, long) LocalTime}. В этом случае смещение не участвует в расчётах и останется неизменным.

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

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

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

public OffsetTime withHour(int hour)

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

Смещение не влияет на вычисление и будет таким же в результате.

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

public OffsetTime withMinute(int minute)

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

Смещение не влияет на вычисление и будет таким же в результате.

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

public OffsetTime withSecond(int second)

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

Смещение не влияет на вычисление и будет таким же в результате.

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

public OffsetTime withNano(int nanoOfSecond)

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

Смещение не влияет на вычисление и будет таким же в результате.

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

public OffsetTime truncatedTo(TemporalUnit unit)

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

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

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

Смещение не влияет на вычисление и будет таким же в результате.

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

public OffsetTime plus(TemporalAmount amountToAdd)

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

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

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

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

public OffsetTime plus(long amountToAdd,
                       TemporalUnit unit)

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

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

Если поле является ChronoUnit, то добавление реализуется с помощью LocalTime.plus(long, TemporalUnit). Смещение не является частью вычисления и останется неизменным в результате.

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

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

public OffsetTime plusHours(long hours)

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

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

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

public OffsetTime plusMinutes(long minutes)

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

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

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

public OffsetTime plusSeconds(long seconds)

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

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

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

public OffsetTime plusNanos(long nanos)

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

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

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

public OffsetTime minus(TemporalAmount amountToSubtract)

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

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

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

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

public OffsetTime minus(long amountToSubtract,
                        TemporalUnit unit)

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

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

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

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

public OffsetTime minusHours(long hours)

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

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

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

public OffsetTime minusMinutes(long minutes)

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

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

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

public OffsetTime minusSeconds(long seconds)

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

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

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

public OffsetTime minusNanos(long nanos)

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

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

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

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 и ChronoField.OFFSET_SECONDS в качестве полей.

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

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

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

public long until(Temporal endExclusive,
                  TemporalUnit unit)

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

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

Temporal , переданный в этот метод, преобразуется в OffsetTime с помощью from(TemporalAccessor). Если смещение отличается между двумя временами, указанное конечное время нормализуется, чтобы иметь то же смещение, что и текущее время.

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

Существует два эквивалентных способа использования этого метода. Первый - вызвать этот метод. Второй - использовать 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 OffsetDateTime atDate(LocalDate date)

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

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

public int compareTo(OffsetTime other)

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

Сравнение основано вначале на мгновении времени, эквивалентном UTC, а затем на локальное время. Оно "согласовано с equals", как определено в Comparable.

Например, порядок сравнения:

1. 10:30+01:00
2. 11:00+01:00
3. 12:00+02:00
4. 11:30+01:00
5. 12:00+01:00
6. 12:30+01:00

Значения #2 и #3 представляют одно и то же мгновение времени на временной шкале. Когда два значения представляют одно и то же мгновение, сравнивается локальное время, чтобы отличить их. Этот шаг необходим для согласования порядка с equals().

Чтобы сравнить базовое локальное время двух TemporalAccessor экземпляров, используйте ChronoField.NANO_OF_DAY в качестве компаратора.

public boolean isAfter(OffsetTime other)

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

Этот метод отличается от сравнения в compareTo(java.time.OffsetTime) тем, что он сравнивает только момент времени. Это эквивалентно преобразованию обоих моментов времени в момент времени с использованием той же даты и сравнения моментов времени.

public boolean isBefore(OffsetTime other)

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

Этот метод отличается от сравнения в compareTo(java.time.OffsetTime) тем, что он сравнивает только момент времени. Это эквивалентно преобразованию обоих моментов времени в момент времени с использованием той же даты и сравнения моментов времени.

public boolean isEqual(OffsetTime other)

Проверяет, равен ли момент времени этого OffsetTime моменту времени указанного времени, применяя оба времени к общей дате.

Этот метод отличается от сравнения в compareTo(java.time.OffsetTime) и equals(java.lang.Object) тем, что он сравнивает только момент времени. Это эквивалентно преобразованию обоих моментов времени в момент времени с использованием той же даты и сравнения моментов времени.

public boolean equals(Object obj)

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

Сравнение основано на локальном времени и смещении. Чтобы сравнить моменты времени на временной шкале, используйте isEqual(OffsetTime).

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

public int hashCode()

public String toString()

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

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

• HH:mmXXXXX
• HH:mm:ssXXXXX
• HH:mm:ss.SSSXXXXX
• HH:mm:ss.SSSSSSXXXXX
• HH:mm:ss.SSSSSSSSSXXXXX

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