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

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

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)

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

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

Согласно этому определению, реализации должны сравнивать все свое состояние.

public int hashCode()

Возвращает подходящий хеш-код согласно определению #equals.

public String toString()

Возвращает строковое описание этого объекта.