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

Модификатор и тип	Метод	Описание
`protected Object`	`clone()`	Создает и возвращает копию этого объекта.
`protected void`	`finalize()`	Устарело, будет удалено: этот элемент API подлежит удалению в будущей версии. Финализация устарела и подлежит удалению в одном из будущих выпусков.
`final Class<?>`	`getClass()`	Возвращает класс времени выполнения этого `Object`.
`final void`	`notify()`	Пробуждает один поток, ожидающий на мониторе этого объекта.
`final void`	`notifyAll()`	Пробуждает все потоки, ожидающие на мониторе этого объекта.
`final void`	`wait()`	Заставляет текущий поток ожидать пробуждения, обычно в результате вызова notify или interrupt.
`final void`	`wait(long timeoutMillis)`	Заставляет текущий поток ожидать пробуждения, обычно в результате вызова notify или interrupt, либо до истечения заданного интервала реального времени.
`final void`	`wait(long timeoutMillis, int nanos)`	Заставляет текущий поток ожидать пробуждения, обычно в результате вызова notify или interrupt, либо до истечения заданного интервала реального времени.

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

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, если объекты равны

См. также:

hashCode

public int hashCode()

Возвращает подходящий хеш-код.

Переопределяет:

hashCode в классе Object

Возвращает:

хеш-код

См. также:

toString

public String toString()

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

Переопределяет:: toString в классе Object
Возвращает:: строка для отладки; не null

© 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.