compact1, compact2, compact3

java.time.zone

Класс ZoneRules

java.lang. Объект

java.time.zone. ZoneRules

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

Сериализуемый

public final class ZoneRules
extends Object
implements Serializable

Определение правил, как зональное смещение изменяется для единственного часового пояса.

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

Правила загружаются через ZoneRulesProvider использование a ZoneId. Те же самые правила могут быть совместно использованы внутренне многократными зональными ID.

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

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

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

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

С тех пор:

1.8

См. Также:

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

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

Модификатор и Тип	Метод и Описание
boolean	equals(Object otherRules) Проверки, если этот ряд правил равняется другому.
Продолжительность	getDaylightSavings(Instant instant) Получает количество перехода на летнее время в использовании в течение указанного момента в этой зоне.
ZoneOffset	getOffset(Instant instant) Получает смещение, применимое в указанный момент в этих правилах.
ZoneOffset	getOffset(LocalDateTime localDateTime) Получает подходящее смещение для указанной локальной переменной, разовой датой в этих правилах.
ZoneOffset	getStandardOffset(Instant instant) Получает стандартное смещение в течение указанного момента в этой зоне.
ZoneOffsetTransition	getTransition(LocalDateTime localDateTime) Получает переход смещения, применимый в указанной локальной переменной, разовой датой в этих правилах.
List<ZoneOffsetTransitionRule>	getTransitionRules() Получает список правил перехода в течение многих лет вне определенных в списке перехода.
List<ZoneOffsetTransition>	getTransitions() Получает полный список полностью определенных переходов.
List<ZoneOffset>	getValidOffsets(LocalDateTime localDateTime) Получает смещение, применимое в указанной локальной переменной, разовой датой в этих правилах.
int	hashCode() Возвращает подходящий хэш-код, данный определение #equals.
boolean	isDaylightSavings(Instant instant) Проверки, если указанный момент находится в переходе на летнее время.
boolean	isFixedOffset() Проверки зональных правил фиксируются, так, что смещение никогда не изменяется.
boolean	isValidOffset(LocalDateTime localDateTime, ZoneOffset offset) Проверки, если разовое датой смещение допустимо для этих правил.
ZoneOffsetTransition	nextTransition(Instant instant) Получает следующий переход после указанного момента.
static ZoneRules	of(ZoneOffset offset) Получает экземпляр ZoneRules, который фиксировал зональные правила.
static ZoneRules	of(ZoneOffset baseStandardOffset, ZoneOffset baseWallOffset, List<ZoneOffsetTransition> standardOffsetTransitionList, List<ZoneOffsetTransition> transitionList, List<ZoneOffsetTransitionRule> lastRules) Получает экземпляр ZoneRules.
ZoneOffsetTransition	previousTransition(Instant instant) Получает предыдущий переход перед указанным моментом.
Строка	toString() Возвращает строку, описывающую этот объект.

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

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

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

из

public static ZoneRules of(ZoneOffset baseStandardOffset,
                           ZoneOffset baseWallOffset,
                           List<ZoneOffsetTransition> standardOffsetTransitionList,
                           List<ZoneOffsetTransition> transitionList,
                           List<ZoneOffsetTransitionRule> lastRules)

Получает экземпляр ZoneRules.

Параметры:

baseStandardOffset - стандартное смещение, чтобы использовать перед правовыми нормами было установлено, не нуль

baseWallOffset - стенное смещение, чтобы использовать перед правовыми нормами было установлено, не нуль

standardOffsetTransitionList - список изменений к стандартному смещению, не нуль

transitionList - список переходов, не нуль

lastRules - повторяющиеся последние правила, размер 16 или меньше, не нуль

Возвраты:

зональные правила, не нуль

из

public static ZoneRules of(ZoneOffset offset)

Получает экземпляр ZoneRules, который фиксировал зональные правила.

Параметры:

offset - смещение эта фиксированная зона правила основано на, не нуль

Возвраты:

зональные правила, не нуль

См. Также:

isFixedOffset()

isFixedOffset

public boolean isFixedOffset()

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

Возвраты:

истина, если часовой пояс фиксируется и смещение, никогда не изменяется

getOffset

public ZoneOffset getOffset(Instant instant)

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

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

Параметры:

instant - момент, чтобы найти смещение для, не нуль, но нуль может быть проигнорирован, если у правил есть единственное смещение в течение всех моментов

Возвраты:

смещение, не нуль

getOffset

public ZoneOffset getOffset(LocalDateTime localDateTime)

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

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

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

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

С тех пор, в случае Разрыва и Перекрытия, возвращенное смещение является "лучшим" значением, а не "корректным" значением, это должно быть обработано с заботой. Приложения, которые заботятся о корректном смещении, должны использовать комбинацию этого метода, getValidOffsets(LocalDateTime) и getTransition(LocalDateTime).

Параметры:

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

Возвраты:

наилучшее имеющееся смещение для разовой датой локальной переменной, не нулевой

getValidOffsets

public List<ZoneOffset> getValidOffsets(LocalDateTime localDateTime)

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

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

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

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

Есть различные способы обработать преобразование из a LocalDateTime. Один метод, используя этот метод, был бы:

  List<ZoneOffset> validOffsets = rules.getOffset(localDT);
  if (validOffsets.size() == 1) {
    // Normal case: only one valid offset
    zoneOffset = validOffsets.get(0);
  } else {
    // Gap or Overlap: determine what to do from transition (which will be non-null)
    ZoneOffsetTransition trans = rules.getTransition(localDT);
  }
 

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

Параметры:

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

Возвраты:

список допустимых смещений, может быть неизменным, не нулевым

getTransition

public ZoneOffsetTransition getTransition(LocalDateTime localDateTime)

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

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

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

Переход используется, чтобы смоделировать случаи Разрыва или Перекрытия. Нормальный случай возвратит нуль.

Есть различные способы обработать преобразование из a LocalDateTime. Один метод, используя этот метод, был бы:

  ZoneOffsetTransition trans = rules.getTransition(localDT);
  if (trans == null) {
    // Gap or Overlap: determine what to do from transition
  } else {
    // Normal case: only one valid offset
    zoneOffset = rule.getOffset(localDT);
  }
 

Параметры:

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

Возвраты:

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

getStandardOffset

public ZoneOffset getStandardOffset(Instant instant)

Получает стандартное смещение в течение указанного момента в этой зоне.

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

Параметры:

instant - момент, чтобы найти информацию о смещении для, не нуль, но нуль может быть проигнорирован, если у правил есть единственное смещение в течение всех моментов

Возвраты:

стандартное смещение, не нуль

getDaylightSavings

public Duration getDaylightSavings(Instant instant)

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

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

Эта реализация по умолчанию вычисляет продолжительность от actual и standard смещения.

Параметры:

instant - момент, чтобы найти переход на летнее время для, не нуль, но нуль может быть проигнорирован, если у правил есть единственное смещение в течение всех моментов

Возвраты:

различие между стандартным и фактическим смещением, не нуль

isDaylightSavings

public boolean isDaylightSavings(Instant instant)

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

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

Эта реализация по умолчанию сравнивается actual и standard смещения.

Параметры:

instant - момент, чтобы найти информацию о смещении для, не нуль, но нуль может быть проигнорирован, если у правил есть единственное смещение в течение всех моментов

Возвраты:

стандартное смещение, не нуль

isValidOffset

public boolean isValidOffset(LocalDateTime localDateTime,
                             ZoneOffset offset)

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

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

Эта реализация по умолчанию проверяет если getValidOffsets(java.time.LocalDateTime) содержит указанное смещение.

Параметры:

localDateTime - разовое датой, чтобы проверить, не нуль, но нуль может быть проигнорирован, если у правил есть единственное смещение в течение всех моментов

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

Возвраты:

истина, если разовое датой смещение допустимо для этих правил

nextTransition

public ZoneOffsetTransition nextTransition(Instant instant)

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

Это возвращает детали следующего перехода после указанного момента. Например, если момент представит точку, где "Летнее" летнее время применяется, тогда то метод возвратит переход следующему "Зимнему" разу.

Параметры:

instant - момент, чтобы получить следующий переход после, не нуль, но нуль может быть проигнорирован, если у правил есть единственное смещение в течение всех моментов

Возвраты:

следующий переход после указанного момента, нуль, если это после последнего перехода

previousTransition

public ZoneOffsetTransition previousTransition(Instant instant)

Получает предыдущий переход перед указанным моментом.

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

Параметры:

instant - момент, чтобы получить предыдущий переход после, не нуль, но нуль может быть проигнорирован, если у правил есть единственное смещение в течение всех моментов

Возвраты:

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

getTransitions

public List<ZoneOffsetTransition> getTransitions()

Получает полный список полностью определенных переходов.

Полный набор переходов для этого постановляет, что экземпляр определяется этим методом и getTransitionRules(). Этот метод возвращает те переходы, которые были полностью определены. Они являются обычно историческими, но могут быть в будущем.

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

Возвраты:

неизменный список полностью определенных переходов, не нуль

getTransitionRules

public List<ZoneOffsetTransitionRule> getTransitionRules()

Получает список правил перехода в течение многих лет вне определенных в списке перехода.

Полный набор переходов для этого постановляет, что экземпляр определяется этим методом и getTransitions(). Этот метод возвращает экземпляры ZoneOffsetTransitionRule это определяет алгоритм для того, когда переходы произойдут.

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

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

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

Возвраты:

неизменный список правил перехода, не нуль

равняется

public boolean equals(Object otherRules)

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

Два набора правила равны, если они будут всегда приводить к тому же самому выводу для какого-либо данного ввода, мгновенного или локального разовый датой. Правила от двух различных групп могут возвратить false, даже если они - фактически то же самое.

Это определение должно привести к реализациям, сравнивающим их все состояние.

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

equals в class Object

Параметры:

otherRules - другие правила, нуль возвращает false

Возвраты:

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

См. Также:

Object.hashCode(), HashMap

хэш-код

public int hashCode()

Возвращает подходящий хэш-код, данный определение #equals.

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

hashCode в class Object

Возвраты:

хэш-код

См. Также:

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

toString

public String toString()

Возвращает строку, описывающую этот объект.

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

toString в class Object

Возвраты:

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