Класс 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
hashCode
toString
© 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://docs.oracle.com/en/java/javase/25/docs/api/java.base/java/time/zone/ZoneOffsetTransitionRule.html