Класс ZoneOffset

Этот метод анализирует строковый идентификатор ZoneOffset и возвращает экземпляр. Анализатор принимает все форматы, создаваемые методом getId(), а также некоторые дополнительные форматы:

• Z - для UTC
• +h
• +hh
• +hh:mm
• -hh:mm
• +hhmm
• -hhmm
• +hh:mm:ss
• -hh:mm:ss
• +hhmmss
• -hhmmss

Идентификатор возвращённого смещения будет нормализован до одного из форматов, описанных методом getId().

Максимальный поддерживаемый диапазон — от +18:00 до -18:00 включительно.

Знаки компонентов часов и минут должны совпадать. Поэтому, если значение часов отрицательное, значение минут должно быть отрицательным или равным нулю. Если значение часов равно нулю, значение минут может быть положительным, отрицательным или равным нулю.

Знаки компонентов часов, минут и секунд должны совпадать. Поэтому, если значение часов отрицательное, значения минут и секунд должны быть отрицательными или равными нулю.

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

TemporalAccessor представляет некоторую форму сведений о дате и времени. Эта фабрика преобразует произвольный временной объект в экземпляр ZoneOffset.

Для преобразования используется запрос TemporalQueries.offset(), который извлекает поле OFFSET_SECONDS.

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

Смещение должно находиться в диапазоне от -18:00 до +18:00, что соответствует значениям от -64 800 до +64 800.

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

Идентификатор незначительно отличается от стандартной строки смещения в формате ISO-8601. Используются три формата:

• Z - для UTC (ISO-8601)
• +hh:mm или -hh:mm - если секунды равны нулю (ISO-8601)
• +hh:mm:ss или -hh:mm:ss - если секунды не равны нулю (не ISO-8601)

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

Проверяет, можно ли получить значение указанного поля для этого смещения. Если результат — false, вызов методов range и get приведёт к выбросу исключения.

Если поле является ChronoField, запрос обрабатывается здесь. Для поля OFFSET_SECONDS возвращается true. Для всех остальных экземпляров ChronoField возвращается false.

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

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

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

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

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

Если поле является ChronoField, запрос обрабатывается здесь. Для поля OFFSET_SECONDS возвращается значение смещения. Для всех остальных экземпляров ChronoField выбрасывается UnsupportedTemporalTypeException.

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

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

Если поле является ChronoField, запрос обрабатывается здесь. Для поля OFFSET_SECONDS возвращается значение смещения. Для всех остальных экземпляров ChronoField выбрасывается UnsupportedTemporalTypeException.

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

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

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

Метод возвращает временной объект того же наблюдаемого типа, что и входной, но с изменённым смещением, совпадающим с этим.

Это изменение эквивалентно вызову Temporal.with(TemporalField, long) с передачей ChronoField.OFFSET_SECONDS в качестве поля.

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

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

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

Смещения сравниваются в порядке их расположения в мире для одного и того же времени суток. Так, смещение +10:00 предшествует смещению +09:00, и далее до -18:00.

Сравнение «согласовано с equals» в соответствии с определением Comparable.

Сравнение выполняется по величине смещения в секундах. Это эквивалентно сравнению по идентификатору.