Spec-Zone.ru › OpenJDK 17

Класс 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, если объекты равны
См. также:
  • Object.hashCode()
  • HashMap

hashCode

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

toString

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

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

Spec-Zone.ru

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