Spec-Zone.ru › OpenJDK 25

Класс ZoneOffsetTransitionRule

java.lang.Object
java.time.zone.ZoneOffsetTransitionRule
Все реализованные интерфейсы:
Serializable
public final class ZoneOffsetTransitionRule extends Object implements Serializable
Правило, описывающее создание перехода.

Этот класс позволяет задавать правила для определения будущих переходов. Правило может быть записано в разных формах:

  • 16 марта
  • воскресенье 16 марта или позже
  • воскресенье 16 марта или раньше
  • последнее воскресенье февраля
Эти различные типы правил можно задавать и запрашивать.
Требования к реализации:
Этот класс неизменяемый и потокобезопасный.
С момента появления:
1.8
См. также:
  • Сериализованная форма

Краткое описание вложенных классов

Модификатор и тип Класс Описание
static enum  ZoneOffsetTransitionRule.TimeDefinition
Определение способа преобразования местного времени в фактические дату и время перехода.

Краткое описание методов

Модификатор и тип Метод Описание
ZoneOffsetTransition createTransition(int year)
Создает экземпляр перехода для указанного года.
boolean equals(Object otherRule)
Проверяет, равен ли этот объект другому объекту.
int getDayOfMonthIndicator()
Возвращает индикатор дня месяца перехода.
DayOfWeek getDayOfWeek()
Возвращает день недели перехода.
LocalTime getLocalTime()
Возвращает местное время суток перехода; для проверки следует использовать isMidnightEndOfDay().
Month getMonth()
Возвращает месяц перехода.
ZoneOffset getOffsetAfter()
Возвращает смещение после перехода.
ZoneOffset getOffsetBefore()
Возвращает смещение до перехода.
ZoneOffset getStandardOffset()
Возвращает стандартное смещение, действующее во время перехода.
ZoneOffsetTransitionRule.TimeDefinition getTimeDefinition()
Возвращает определение времени, указывающее, как преобразовать время в момент времени.
int hashCode()
Возвращает подходящий хеш-код.
boolean isMidnightEndOfDay()
Проверяет, приходится ли местное время перехода на полночь в конце дня.
static ZoneOffsetTransitionRule of(Month month, int dayOfMonthIndicator, DayOfWeek dayOfWeek, LocalTime time, boolean timeEndOfDay, ZoneOffsetTransitionRule.TimeDefinition timeDefinition, ZoneOffset standardOffset, ZoneOffset offsetBefore, ZoneOffset offsetAfter)
Создает экземпляр, определяющий ежегодное правило создания переходов между двумя смещениями.
String toString()
Возвращает строку с описанием этого объекта.

Методы, объявленные в классе Object

clone, finalize, getClass, notify, notifyAll, wait, wait, wait

Подробное описание методов

of

public static ZoneOffsetTransitionRule of(Month month, int dayOfMonthIndicator, DayOfWeek dayOfWeek, LocalTime time, boolean timeEndOfDay, ZoneOffsetTransitionRule.TimeDefinition timeDefinition, ZoneOffset standardOffset, ZoneOffset offsetBefore, ZoneOffset offsetAfter)
Создает экземпляр, определяющий ежегодное правило создания переходов между двумя смещениями.

Обычно приложениям следует получать экземпляр из ZoneRules. Эта фабрика предназначена только для создания ZoneRules.

Параметры:
month — месяц даты месяца первого дня недели перехода, не null
dayOfMonthIndicator — день месяца даты перехода: положительное значение означает этот день или позже, отрицательное — этот день или раньше, отсчитывая от последнего дня месяца; от -28 до 31, кроме 0
dayOfWeek — требуемый день недели; null, если дату месяца не следует изменять
time — время перехода в смещении «до», не null
timeEndOfDay — указывает, является ли время полуночью в конце дня
timeDefinition — способ интерпретации перехода
standardOffset — стандартное смещение, действующее во время перехода, не null
offsetBefore — смещение до перехода, не null
offsetAfter — смещение после перехода, не null
Возвращает:
правило, не null
Вызывает исключение:
IllegalArgumentException — если индикатор дня месяца недопустим
IllegalArgumentException — если флаг конца дня имеет значение true, а время не является полуночью
IllegalArgumentException — если time.getNano() возвращает ненулевое значение

getMonth

public Month getMonth()
Возвращает месяц перехода.

Если правило задает точную дату, месяцом является месяц этой даты.

Если правило задает неделю, в течение которой может произойти переход, месяцем является месяц самой ранней или самой поздней возможной даты перехода.

Возвращает:
месяц перехода, не null

getDayOfMonthIndicator

public int getDayOfMonthIndicator()
Возвращает индикатор дня месяца перехода.

Если правило задает точную дату, днем является день этой даты.

Если правило задает неделю, в течение которой может произойти переход, день определяет начало или конец недели перехода.

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

Если значение отрицательное, оно обозначает количество дней от конца месяца, где -1 — последний день месяца. В этом случае указанный день является самой поздней возможной датой перехода.

Возвращает:
индикатор дня месяца от -28 до 31, кроме 0

getDayOfWeek

public DayOfWeek getDayOfWeek()
Возвращает день недели перехода.

Если правило задает точную дату, возвращается null.

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

Возвращает:
день недели, на который приходится переход; null, если правило задает точную дату

getLocalTime

public LocalTime getLocalTime()
Возвращает местное время суток перехода; для проверки следует использовать isMidnightEndOfDay().

Время преобразуется в момент времени с использованием определения времени.

Возвращает:
местное время суток перехода, не null

isMidnightEndOfDay

public boolean isMidnightEndOfDay()
Проверяет, приходится ли местное время перехода на полночь в конце дня.

Переход может быть представлен как происходящий в 24:00.

Возвращает:
указывает, приходится ли местное время, равное полуночи, на начало или конец дня

getTimeDefinition

public ZoneOffsetTransitionRule.TimeDefinition getTimeDefinition()
Возвращает определение времени, указывающее, как преобразовать время в момент времени.

Местное время можно преобразовать в момент времени с использованием стандартного смещения, смещения по настенным часам или UTC.

Возвращает:
определение времени, не null

getStandardOffset

public ZoneOffset getStandardOffset()
Возвращает стандартное смещение, действующее во время перехода.
Возвращает:
стандартное смещение, не null

getOffsetBefore

public ZoneOffset getOffsetBefore()
Возвращает смещение до перехода.
Возвращает:
смещение до перехода, не null

getOffsetAfter

public ZoneOffset getOffsetAfter()
Возвращает смещение после перехода.
Возвращает:
смещение после перехода, не null

createTransition

public ZoneOffsetTransition createTransition(int year)
Создает экземпляр перехода для указанного года.

Вычисления выполняются с использованием хронологии ISO-8601.

Параметры:
year — год, для которого создается переход, не null
Возвращает:
экземпляр перехода, не null

equals

public boolean equals(Object otherRule)
Проверяет, равен ли этот объект другому объекту.

Сравнивается все состояние объекта.

Переопределяет:
equals в классе Object
Параметры:
otherRule — объект для сравнения; null возвращает false
Возвращает:
true, если объекты равны
См. также:
  • Object.hashCode()
  • HashMap

hashCode

public int hashCode()
Возвращает подходящий хеш-код.
Переопределяет:
hashCode в классе Object
Возвращает:
хеш-код
См. также:
  • Object.equals(java.lang.Object)
  • System.identityHashCode(Object)

toString

public String toString()
Возвращает строку с описанием этого объекта.
Переопределяет:
toString в классе Object
Возвращает:
строку для отладки, не null

Сообщить об ошибке или предложить улучшение
Дополнительные справочные материалы по API и документацию для разработчиков см. в документации Java SE, содержащей более подробные описания для разработчиков, включая концептуальные обзоры, определения терминов, обходные решения и работающие примеры кода. Другие версии.
Java является товарным знаком или зарегистрированным товарным знаком Oracle и/или ее аффилированных лиц в США и других странах.
Авторское право © 1993, 2025, Oracle и/или ее аффилированные лица, 500 Oracle Parkway, Redwood Shores, CA 94065 USA.
Все права защищены. Использование регулируется условиями лицензии и политикой распространения документации.

© 1993, 2025, Oracle and/or its affiliates. All rights reserved.
Documentation extracted from Debian's OpenJDK Development Kit package.
Licensed under the GNU General Public License, version 2, with the Classpath Exception.
Various third party code in OpenJDK is licensed under different licenses (see Debian package).
Java and OpenJDK are trademarks or registered trademarks of Oracle and/or its affiliates.
https://docs.oracle.com/en/java/javase/25/docs/api/java.base/java/time/zone/ZoneOffsetTransitionRule.html

Spec-Zone.ru

Настройки Оффлайн Что нового Помощь О нас
Spec-Zone .ru
спецификации, руководства, описания, API