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

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