Класс 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()`	Возвращает строку, описывающую этот объект.

Методы, объявленные в классе java.lang.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)

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

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

Overrides:

equals в классе Object

Параметры:

otherRule - другой объект для сравнения, null возвращает false

Возвращает:

true, если равны

См. также:

hashCode

public int hashCode()

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

Overrides:

hashCode в классе Object

Возвращает:

хэш-код

См. также:

toString

public String toString()

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

Overrides:: 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.
https://download.java.net/java/early_access/jdk24/docs/api/java.base/java/time/zone/ZoneOffsetTransitionRule.html