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

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

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

Это определение предполагает, что реализации сравнивают всё своё состояние.

public int hashCode()

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

public String toString()

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