Класс ZoneRules

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

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

public static ZoneRules of(ZoneOffset offset)

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

public boolean isFixedOffset()

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

public ZoneOffset getOffset(Instant instant)

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

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

public ZoneOffset getOffset(LocalDateTime localDateTime)

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

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

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

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

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

public List<ZoneOffset> getValidOffsets(LocalDateTime localDateTime)

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

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

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

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

Существует несколько способов обработки преобразования из LocalDateTime. Один из подходов, использующий этот метод, был бы:

  List<ZoneOffset> validOffsets = rules.getValidOffsets(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 элементов.

public ZoneOffsetTransition getTransition(LocalDateTime localDateTime)

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

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

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

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

Существует несколько способов обработки преобразования из 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);
  }
 

public ZoneOffset getStandardOffset(Instant instant)

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

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

public Duration getDaylightSavings(Instant instant)

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

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

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

public boolean isDaylightSavings(Instant instant)

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

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

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

public boolean isValidOffset(LocalDateTime localDateTime, ZoneOffset offset)

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

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

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

public ZoneOffsetTransition nextTransition(Instant instant)

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

Возвращает сведения о следующем переходе после указанного момента времени. Например, если момент времени соответствует моменту, когда действует летнее время, то метод вернёт переход к следующему зимнему времени.

public ZoneOffsetTransition previousTransition(Instant instant)

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

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

public List<ZoneOffsetTransition> getTransitions()

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

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

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

public List<ZoneOffsetTransitionRule> getTransitionRules()

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

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

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

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

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

public boolean equals(Object otherRules)

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

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

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

public int hashCode()

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

public String toString()

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