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

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

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

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

equals в классе Object

Параметры:

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

Возвращает:

true, если объекты равны

См. также:

hashCode

public int hashCode()

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

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

hashCode в классе Object

Возвращает:

хэш-код

См. также:

toString

public String toString()

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

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

© 1993, 2023, 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/21/docs/api/java.base/java/time/zone/ZoneOffsetTransitionRule.html