Класс ZoneOffsetTransitionRule
- Все реализуемые интерфейсы:
Serializable
public final class ZoneOffsetTransitionRule extends Object implements Serializable
Этот класс позволяет выразить правила для определения будущих переходов. Правило может быть записано в различных формах:
- 16 марта
- воскресенье на или после 16 марта
- воскресенье на или до 16 марта
- последнее воскресенье февраля
- Требования к реализации:
- Этот класс неизменяемый и потокобезопасный.
- С:
- 1.8
- См. также:
Краткое описание вложенных классов
| Модификатор и тип | Класс | Описание |
|---|---|---|
static enum |
ZoneOffsetTransitionRule.TimeDefinition |
Определение способа преобразования локального времени в фактическую дату и время перехода. |
Краткое описание методов
| Модификатор и тип | Метод | Описание |
|---|---|---|
ZoneOffsetTransition |
createTransition |
Создает экземпляр перехода для указанного года. |
boolean |
equals |
Проверяет, равен ли этот объект другому. |
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 |
Получает экземпляр, определяющий ежегодное правило для создания переходов между двумя смещениями. |
String |
toString() |
Возвращает строку, описывающую этот объект. |
Подробное описание методов
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, 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