compact1, compact2, compact3

java.time

Класс ZoneOffset

java.lang. Объект

java.time. ZoneId

java.time. ZoneOffset

Все Реализованные Интерфейсы:

Сериализуемый, Сопоставимый <ZoneOffset>, TemporalAccessor, TemporalAdjuster

public final class ZoneOffset
extends ZoneId
implements TemporalAccessor, TemporalAdjuster, Comparable<ZoneOffset>, Serializable

Смещение часового пояса из Гринвича/UTC, такой как +02:00.

Смещение часового пояса является промежутком времени, что часовой пояс отличается от Гринвича/UTC. Это обычно - постоянное число часов и минут.

У различных частей мира есть различные смещения часового пояса. Правила для того, как смещения изменяются местом и время года, получаются в ZoneId class.

Например, Париж является одним часом перед Гринвичем/UTC зимой и два часа вперед летом. ZoneId экземпляр для Парижа сошлется два ZoneOffset экземпляры - a +01:00 экземпляр в течение зимы, и a +02:00 экземпляр в течение лета.

В 2008 часовой пояс смещает во всем мире расширенный от-12:00 до +14:00. Чтобы предотвратить любые проблемы с тем расширяемым диапазоном, и всё же обеспечьте проверку допустимости, диапазон смещений ограничивается-18:00 к 18:00 включительно.

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

Экземпляры ZoneOffset должен быть сравнен, используя equals(java.lang.Object). Реализации могут хотеть кэшировать определенные общие смещения, однако приложения не должны положиться на такое кэширование.

Требования реализации:

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

С тех пор:

1.8

См. Также:

Сериализированная Форма

Полевая Сводка

Поля

Модификатор и Тип	Поле и Описание
static ZoneOffset	МАКСИМАЛЬНЫЙ Постоянный для максимального поддерживаемого смещения.
static ZoneOffset	МИН Постоянный для максимального поддерживаемого смещения.
static ZoneOffset	UTC Смещение часового пояса для UTC, с ID 'Z'.

Поля, наследованные от class java.time. ZoneId

OLD_SHORT_IDS, SHORT_IDS

Сводка метода

Модификатор и Тип	Метод и Описание
Временный	adjustInto(Temporal temporal) Корректирует указанный временный объект иметь то же самое смещение как этот объект.
int	compareTo(ZoneOffset other) Сравнивает это смещение с другим смещением в порядке убывания.
boolean	equals(Object obj) Проверки, если это смещение равно другому смещению.
static ZoneOffset	from(TemporalAccessor temporal) Получает экземпляр ZoneOffset от временного объекта.
int	get(TemporalField field) Получает значение указанного поля от этого смещения как int.
Строка	getId() Получает нормализованный зональный ID смещения.
long	getLong(TemporalField field) Получает значение указанного поля от этого смещения как a long.
ZoneRules	getRules() Получает связанные правила часового пояса.
int	getTotalSeconds() Получает полное зональное смещение в секундах.
int	hashCode() Хэш-код для этого смещения.
boolean	isSupported(TemporalField field) Проверки, если указанное поле поддерживается.
static ZoneOffset	of(String offsetId) Получает экземпляр ZoneOffset использование ID.
static ZoneOffset	ofHours(int hours) Получает экземпляр ZoneOffset использование смещения в часах.
static ZoneOffset	ofHoursMinutes(int hours, int minutes) Получает экземпляр ZoneOffset использование смещения в часах и минутах.
static ZoneOffset	ofHoursMinutesSeconds(int hours, int minutes, int seconds) Получает экземпляр ZoneOffset используя смещение в часах, минутах и секундах.
static ZoneOffset	ofTotalSeconds(int totalSeconds) Получает экземпляр ZoneOffset определение полного смещения в секундах
<R> R	query(TemporalQuery<R> query) Запросы это смещение, используя указанный запрос.
ValueRange	range(TemporalField field) Получает диапазон допустимых значений для указанного поля.
Строка	toString() Выводит это смещение как a String, использование нормализованного ID.

Методы, наследованные от class java.time. ZoneId

getAvailableZoneIds, getDisplayName, normalized, of, systemDefault

Методы, наследованные от class java.lang. Объект

clone, finalize, getClass, notify, notifyAll, wait, wait, wait

Методы, наследованные от интерфейса java.time.temporal. TemporalAdjuster

dayOfWeekInMonth, firstDayOfMonth, firstDayOfNextMonth, firstDayOfNextYear, firstDayOfYear, firstInMonth, lastDayOfMonth, lastDayOfYear, lastInMonth, next, nextOrSame, ofDateAdjuster, previous, previousOrSame

Полевая Деталь

UTC

public static final ZoneOffset UTC

Смещение часового пояса для UTC, с ID 'Z'.

МИН

public static final ZoneOffset MIN

Постоянный для максимального поддерживаемого смещения.

МАКСИМАЛЬНЫЙ

public static final ZoneOffset MAX

Постоянный для максимального поддерживаемого смещения.

Деталь метода

из

public static ZoneOffset of(String offsetId)

Получает экземпляр ZoneOffset использование ID.

Этот метод анализирует строковый ID a ZoneOffset возвратить экземпляр. Парсинг принимает все форматы, сгенерированные getId(), плюс некоторые дополнительные форматы:

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

Отметьте что ± средств или плюс или минус символ.

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

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

Параметры:

offsetId - ID смещения, не нуль

Возвраты:

смещенный зоной, не нуль

Броски:

DateTimeException - если ID смещения недопустим

ofHours

public static ZoneOffset ofHours(int hours)

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

Параметры:

hours - смещение часового пояса в часах, от-18 до +18

Возвраты:

смещенный зоной, не нуль

Броски:

DateTimeException - если смещение не находится в необходимом диапазоне

ofHoursMinutes

public static ZoneOffset ofHoursMinutes(int hours,
                                        int minutes)

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

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

Параметры:

hours - смещение часового пояса в часах, от-18 до +18

minutes - смещение часового пояса в минутах, от 0 до ±59, подписывает часы соответствий

Возвраты:

смещенный зоной, не нуль

Броски:

DateTimeException - если смещение не находится в необходимом диапазоне

ofHoursMinutesSeconds

public static ZoneOffset ofHoursMinutesSeconds(int hours,
                                               int minutes,
                                               int seconds)

Получает экземпляр ZoneOffset используя смещение в часах, минутах и секундах.

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

Параметры:

hours - смещение часового пояса в часах, от-18 до +18

minutes - смещение часового пояса в минутах, от 0 до ±59, подписывает часы соответствий и секунды

seconds - смещение часового пояса в секундах, от 0 до ±59, подписывает часы соответствий и минуты

Возвраты:

смещенный зоной, не нуль

Броски:

DateTimeException - если смещение не находится в необходимом диапазоне

от

public static ZoneOffset from(TemporalAccessor temporal)

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

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

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

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

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

Параметры:

temporal - временный объект преобразовать, не нуль

Возвраты:

смещенный зоной, не нуль

Броски:

DateTimeException - если неспособный преобразовать в ZoneOffset

ofTotalSeconds

public static ZoneOffset ofTotalSeconds(int totalSeconds)

Получает экземпляр ZoneOffset определение полного смещения в секундах

Смещение должно быть в диапазоне -18:00 к +18:00, который соответствует-64800 к +64800.

Параметры:

totalSeconds - полное смещение часового пояса в секундах, от-64800 до +64800

Возвраты:

ZoneOffset, не нуль

Броски:

DateTimeException - если смещение не находится в необходимом диапазоне

getTotalSeconds

public int getTotalSeconds()

Получает полное зональное смещение в секундах.

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

Возвраты:

в секундах составляет полное зональное смещение

getId

public String getId()

Получает нормализованный зональный ID смещения.

ID является незначительным изменением к стандартному ISO 8601 отформатированная строка для смещения. Есть три формата:

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

Определенный:

getId в class ZoneId

Возвраты:

зональный ID смещения, не нуль

getRules

public ZoneRules getRules()

Получает связанные правила часового пояса.

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

Определенный:

getRules в class ZoneId

Возвраты:

правила, не нуль

isSupported

public boolean isSupported(TemporalField field)

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

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

Если поле является a ChronoField тогда запрос реализуется здесь. OFFSET_SECONDS поле возвращает true. Все другой ChronoField экземпляры возвратят false.

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

Определенный:

isSupported в интерфейсе TemporalAccessor

Параметры:

field - поле, чтобы проверить, обнулите, возвращает false

Возвраты:

истина, если поле поддерживается на этом смещении, ложь если нет

диапазон

public ValueRange range(TemporalField field)

Получает диапазон допустимых значений для указанного поля.

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

Если поле является a ChronoField тогда запрос реализуется здесь. supported fields возвратит соответствующие экземпляры диапазона. Все другой ChronoField экземпляры бросят UnsupportedTemporalTypeException.

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

Определенный:

range в интерфейсе TemporalAccessor

Параметры:

field - поле, чтобы запросить диапазон для, не нуль

Возвраты:

диапазон допустимых значений для поля, не нуль

Броски:

DateTimeException - если диапазон для поля не может быть получен

UnsupportedTemporalTypeException - если поле не поддерживается

добраться

public int get(TemporalField field)

Получает значение указанного поля от этого смещения как int.

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

Если поле является a ChronoField тогда запрос реализуется здесь. OFFSET_SECONDS поле возвращает значение смещения. Все другой ChronoField экземпляры бросят UnsupportedTemporalTypeException.

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

Определенный:

get в интерфейсе TemporalAccessor

Параметры:

field - поле, чтобы получить, не нуль

Возвраты:

значение для поля

Броски:

DateTimeException - если значение для поля не может быть получено, или значение вне диапазона допустимых значений для поля

UnsupportedTemporalTypeException - если поле не поддерживается, или диапазон значений превышает int

ArithmeticException - если числовое переполнение происходит

getLong

public long getLong(TemporalField field)

Получает значение указанного поля от этого смещения как a long.

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

Если поле является a ChronoField тогда запрос реализуется здесь. OFFSET_SECONDS поле возвращает значение смещения. Все другой ChronoField экземпляры бросят UnsupportedTemporalTypeException.

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

Определенный:

getLong в интерфейсе TemporalAccessor

Параметры:

field - поле, чтобы получить, не нуль

Возвраты:

значение для поля

Броски:

DateTimeException - если значение для поля не может быть получено

UnsupportedTemporalTypeException - если поле не поддерживается

ArithmeticException - если числовое переполнение происходит

запрос

public <R> R query(TemporalQuery<R> query)

Запросы это смещение, используя указанный запрос.

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

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

Определенный:

query в интерфейсе TemporalAccessor

Введите Параметры:

R - тип результата

Параметры:

query - запрос, чтобы вызвать, не нуль

Возвраты:

результат запроса, нуль может быть возвращен (определенный запросом)

Броски:

DateTimeException - если неспособный запрашивать (определенный запросом)

ArithmeticException - если числовое переполнение происходит (определенный запросом)

adjustInto

public Temporal adjustInto(Temporal temporal)

Корректирует указанный временный объект иметь то же самое смещение как этот объект.

Это возвращает временный объект того же самого заметного типа как ввод со смещением, измененным, чтобы быть тем же самым как этим.

Корректировка эквивалентна использованию 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);
 

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

Определенный:

adjustInto в интерфейсе TemporalAdjuster

Параметры:

temporal - целевой объект, который будет скорректирован, не нуль

Возвраты:

скорректированный объект, не нуль

Броски:

DateTimeException - если неспособный вносить корректировку

ArithmeticException - если числовое переполнение происходит

compareTo

public int compareTo(ZoneOffset other)

Сравнивает это смещение с другим смещением в порядке убывания.

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

Сравнение является "непротиворечивым с, равняется", как определено Comparable.

Определенный:

compareTo в интерфейсе Comparable<ZoneOffset>

Параметры:

other - другая дата, чтобы сравнить с, не нуль

Возвраты:

значение компаратора, отрицательное, если меньше, postive если больше

Броски:

NullPointerException - если other нуль

равняется

public boolean equals(Object obj)

Проверки, если это смещение равно другому смещению.

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

Переопределения:

equals в class ZoneId

Параметры:

obj - объект проверить, обнулите, возвращает false

Возвраты:

истина, если это равно другому смещению

См. Также:

Object.hashCode(), HashMap

хэш-код

public int hashCode()

Хэш-код для этого смещения.

Переопределения:

hashCode в class ZoneId

Возвраты:

подходящий хэш-код

См. Также:

Object.equals(java.lang.Object), System.identityHashCode(java.lang.Object)

toString

public String toString()

Выводит это смещение как a String, использование нормализованного ID.

Переопределения:

toString в class ZoneId

Возвраты:

строковое представление этого смещения, не нуль