Класс 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()

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