Класс ZoneRules

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

public static ZoneRules of(ZoneOffset offset)

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.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 записей.

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()

public String toString()