Класс SimpleTimeZone

public class SimpleTimeZone
extends TimeZone

SimpleTimeZone является конкретным подклассом TimeZone, представляющим часовой пояс для использования с григорианским календарём. Класс хранит смещение от GMT, называемое *сырым смещением*, и правила начала и окончания летнего времени. Поскольку он хранит только отдельные значения для каждого, он не может обрабатывать исторические изменения смещения от GMT и графика летнего времени, за исключением того, что метод setStartYear может указать год, когда график летнего времени начинает действовать.

Для создания SimpleTimeZone с графиком летнего времени график может быть описан набором правил, *правило начала* и *правило окончания*. День, когда летнее время начинается или заканчивается, задаётся комбинацией значений *месяц*, *день месяца* и *день недели*. Значение *месяц* представлено значением поля календаря MONTH, например, Calendar.MARCH. Значение *день недели* представлено значением поля календаря DAY_OF_WEEK, например, SUNDAY. Значения комбинаций значений имеют следующие смыслы.

• Точный день месяца
  Для указания точного дня месяца установите *месяц* и *день месяца* в точное значение, а *день недели* в ноль. Например, для указания 1 марта установите *месяц* в MARCH, *день месяца* в 1 и *день недели* в 0.
• День недели на или после дня месяца
  Для указания дня недели на или после точного дня месяца установите *месяц* в точное значение месяца, *день месяца* в день, на или после которого применяется правило, а *день недели* в отрицательное значение поля DAY_OF_WEEK. Например, для указания второго воскресенья апреля установите *месяц* в APRIL, *день месяца* в 8 и *день недели* в -SUNDAY.
• День недели на или до дня месяца
  Для указания дня недели на или до точного дня месяца установите *день месяца* и *день недели* в отрицательное значение. Например, для указания последней среды на или до 21 марта, установите *месяц* в MARCH, *день месяца* в -21 и *день недели* в -WEDNESDAY.
• Последний день недели месяца
  Для указания последнего дня недели месяца установите *день недели* в значение DAY_OF_WEEK и *день месяца* в -1. Например, для указания последнего воскресенья октября, установите *месяц* в OCTOBER, *день недели* в SUNDAY и *день месяца* в -1.

Время суток, в которое летнее время начинается или заканчивается, задаётся значением миллисекунд в течение дня. Существуют три типа *режимов* для указания времени: WALL_TIME, STANDARD_TIME и UTC_TIME. Например, если летнее время заканчивается в 2:00 утра по местному времени, его можно указать как 7200000 миллисекунд в режиме WALL_TIME. В этом случае время по местному времени для *правила окончания* означает то же, что и время летнего времени.

Ниже приведены примеры параметров для построения объектов часовых поясов.

// Base GMT offset: -8:00
      // DST starts:      at 2:00am in standard time
      //                  on the first Sunday in April
      // DST ends:        at 2:00am in daylight time
      //                  on the last Sunday in October
      // Save:            1 hour
      SimpleTimeZone(-28800000,
                     "America/Los_Angeles",
                     Calendar.APRIL, 1, -Calendar.SUNDAY,
                     7200000,
                     Calendar.OCTOBER, -1, Calendar.SUNDAY,
                     7200000,
                     3600000)

      // Base GMT offset: +1:00
      // DST starts:      at 1:00am in UTC time
      //                  on the last Sunday in March
      // DST ends:        at 1:00am in UTC time
      //                  on the last Sunday in October
      // Save:            1 hour
      SimpleTimeZone(3600000,
                     "Europe/Paris",
                     Calendar.MARCH, -1, Calendar.SUNDAY,
                     3600000, SimpleTimeZone.UTC_TIME,
                     Calendar.OCTOBER, -1, Calendar.SUNDAY,
                     3600000, SimpleTimeZone.UTC_TIME,
                     3600000)

Эти правила параметров также применимы к методам установки правил, таким как setStartRule.

Поля

WALL_TIME

public static final int WALL_TIME

Константа для режима начала или окончания времени, указанного как время по часам. Время по часам — это стандартное время для правила начала и летнее время для правила окончания.

С момента:

1.4

См. также:

Значения постоянных полей

STANDARD_TIME

public static final int STANDARD_TIME

Константа для режима начала или окончания времени, указанного как стандартное время.

С момента:

1.4

См. также:

Значения постоянных полей

UTC_TIME

public static final int UTC_TIME

Константа для режима начала или окончания времени, указанного как UTC. Например, правила Европейского союза указаны как время UTC.

С момента:

1.4

См. также:

Значения постоянных полей

Конструкторы

SimpleTimeZone

public SimpleTimeZone(int rawOffset,
                      String ID)

Создаёт SimpleTimeZone с заданным смещением часового пояса от GMT и идентификатором часового пояса без расписания летнего времени.

Параметры:

rawOffset - Смещение базового часового пояса в миллисекундах от GMT.

ID - Имя часового пояса, которое присваивается этому экземпляру.

SimpleTimeZone

public SimpleTimeZone(int rawOffset,
                      String ID,
                      int startMonth,
                      int startDay,
                      int startDayOfWeek,
                      int startTime,
                      int endMonth,
                      int endDay,
                      int endDayOfWeek,
                      int endTime)

Создаёт SimpleTimeZone с заданным смещением базового часового пояса от GMT, идентификатором часового пояса и правилами начала и окончания летнего времени. Оба startTime и endTime указаны как представленные в местном времени по часам. Величина летнего времени предполагается равной 3600000 миллисекундам (т. е. одному часу). Этот конструктор эквивалентен:

SimpleTimeZone(rawOffset,
                    ID,
                    startMonth,
                    startDay,
                    startDayOfWeek,
                    startTime,
                    SimpleTimeZone.WALL_TIME,
                    endMonth,
                    endDay,
                    endDayOfWeek,
                    endTime,
                    SimpleTimeZone.WALL_TIME,
                    3600000)

Параметры:

rawOffset - Заданное смещение базового часового пояса от GMT.

ID - Идентификатор часового пояса, который присваивается этому объекту.

startMonth - Месяц начала летнего времени. Месяц — это значение поля MONTH (нумерация с 0. Например, 0 для января).

startDay - День месяца, в который начинается летнее время. См. описание класса для особых случаев этого параметра.

startDayOfWeek - День недели начала летнего времени. См. описание класса для особых случаев этого параметра.

startTime - Время начала летнего времени в местном времени по часам (в миллисекундах в течение дня), которое в этом случае является местным стандартным временем.

endMonth - Месяц окончания летнего времени. Месяц — это значение поля MONTH (нумерация с 0. Например, 9 для октября).

endDay - День месяца, в который заканчивается летнее время. См. описание класса для особых случаев этого параметра.

endDayOfWeek - День недели окончания летнего времени. См. описание класса для особых случаев этого параметра.

endTime - Время окончания летнего времени в местном времени по часам (в миллисекундах в течение дня), которое в этом случае является местным летним временем.

Исключения:

IllegalArgumentException - если значения месяца, дня, дня недели или времени выходят за пределы диапазона для правила начала или окончания

SimpleTimeZone

public SimpleTimeZone(int rawOffset,
                      String ID,
                      int startMonth,
                      int startDay,
                      int startDayOfWeek,
                      int startTime,
                      int endMonth,
                      int endDay,
                      int endDayOfWeek,
                      int endTime,
                      int dstSavings)

Создаёт SimpleTimeZone с заданным смещением базового часового пояса от GMT, идентификатором часового пояса и правилами начала и окончания летнего времени. Оба startTime и endTime предполагаются представленными в местном времени по часам. Этот конструктор эквивалентен:

SimpleTimeZone(rawOffset,
                    ID,
                    startMonth,
                    startDay,
                    startDayOfWeek,
                    startTime,
                    SimpleTimeZone.WALL_TIME,
                    endMonth,
                    endDay,
                    endDayOfWeek,
                    endTime,
                    SimpleTimeZone.WALL_TIME,
                    dstSavings)

Параметры:

rawOffset - Заданное смещение базового часового пояса от GMT.

ID - Идентификатор часового пояса, который присваивается этому объекту.

startMonth - Месяц начала летнего времени. Месяц — это значение поля MONTH (нумерация с 0. Например, 0 для января).

startDay - День месяца, в который начинается летнее время. См. описание класса для особых случаев этого параметра.

startDayOfWeek - День недели начала летнего времени. См. описание класса для особых случаев этого параметра.

startTime - Время начала летнего времени в местном времени по часам, которое в этом случае является местным стандартным временем.

endMonth - Месяц окончания летнего времени. Месяц — это значение поля MONTH (нумерация с 0. Например, 9 для октября).

endDay - День месяца, в который заканчивается летнее время. См. описание класса для особых случаев этого параметра.

endDayOfWeek - День недели окончания летнего времени. См. описание класса для особых случаев этого параметра.

endTime - Время окончания летнего времени в местном времени по часам, которое в этом случае является местным летним временем.

dstSavings - Количество времени в миллисекундах, сэкономленное во время летнего времени.

Исключения:

IllegalArgumentException - если значения месяца, дня, дня недели или времени выходят за пределы диапазона для правила начала или окончания

С момента:

1.2

SimpleTimeZone

public SimpleTimeZone(int rawOffset,
                      String ID,
                      int startMonth,
                      int startDay,
                      int startDayOfWeek,
                      int startTime,
                      int startTimeMode,
                      int endMonth,
                      int endDay,
                      int endDayOfWeek,
                      int endTime,
                      int endTimeMode,
                      int dstSavings)

Создаёт SimpleTimeZone с заданным смещением базового часового пояса от GMT, идентификатором часового пояса и правилами начала и окончания летнего времени. Этот конструктор принимает полный набор параметров правил начала и окончания, включая режимы startTime и endTime. Режим указывает либо wall time, либо standard time, либо UTC time.

Параметры:

rawOffset - Заданное смещение базового часового пояса от GMT.

ID - Идентификатор часового пояса, который присваивается этому объекту.

startMonth - Месяц начала летнего времени. Месяц — это значение поля MONTH (нумерация с 0. Например, 0 для января).

startDay - День месяца, в который начинается летнее время. См. описание класса для особых случаев этого параметра.

startDayOfWeek - День недели начала летнего времени. См. описание класса для особых случаев этого параметра.

startTime - Время начала летнего времени в режиме времени, указанном в startTimeMode.

startTimeMode - Режим времени начала, указанный в startTime.

endMonth - Месяц окончания летнего времени. Месяц — это значение поля MONTH (нумерация с 0. Например, 9 для октября).

endDay - День месяца, в который заканчивается летнее время. См. описание класса для особых случаев этого параметра.

endDayOfWeek - День недели окончания летнего времени. См. описание класса для особых случаев этого параметра.

endTime - Время окончания летнего времени в режиме времени, указанном в endTimeMode.

endTimeMode - Режим времени окончания, указанный в endTime.

dstSavings - Количество времени в миллисекундах, сэкономленное во время летнего времени.

Исключения:

IllegalArgumentException - если значения месяца, дня, дня недели, режима времени или времени выходят за пределы диапазона для правила начала или окончания, или если значение режима времени некорректно.

С момента:

1.4

См. также:

WALL_TIME, STANDARD_TIME, UTC_TIME

Методы

setStartYear

public void setStartYear(int year)

Устанавливает год начала летнего времени.

Параметры:

year - Год начала летнего времени.

setStartRule

public void setStartRule(int startMonth,
                         int startDay,
                         int startDayOfWeek,
                         int startTime)

Устанавливает правило начала летнего времени. Например, если летнее время начинается в первое воскресенье апреля в 2 часа по местному времени по часам, можно установить правило начала, вызвав:

setStartRule(Calendar.APRIL, 1, Calendar.SUNDAY, 2*60*60*1000);

Параметры:

startMonth - Месяц начала летнего времени. Месяц — это значение поля MONTH (нумерация с 0. Например, 0 для января).

startDay - День месяца, в который начинается летнее время. См. описание класса для особых случаев этого параметра.

startDayOfWeek - День недели начала летнего времени. См. описание класса для особых случаев этого параметра.

startTime - Время начала летнего времени в местном времени по часам, которое в этом случае является местным стандартным временем.

Исключения:

IllegalArgumentException - если значения startMonth, startDay, startDayOfWeek, или startTime выходят за пределы диапазона

setStartRule

public void setStartRule(int startMonth,
                         int startDay,
                         int startTime)

Устанавливает правило начала летнего времени на фиксированную дату в месяце. Этот метод эквивалентен:

setStartRule(startMonth, startDay, 0, startTime)

Параметры:

startMonth - Месяц начала летнего времени. Месяц — это значение поля MONTH (нумерация с 0. Например, 0 для января).

startDay - День месяца, в который начинается летнее время.

startTime - Время начала летнего времени в местном времени по часам, которое в этом случае является местным стандартным временем. См. описание класса для особых случаев этого параметра.

Исключения:

IllegalArgumentException - если значения startMonth, startDayOfMonth, или startTime выходят за пределы диапазона

С момента:

1.2

setStartRule

public void setStartRule(int startMonth,
                         int startDay,
                         int startDayOfWeek,
                         int startTime,
                         boolean after)

Устанавливает правило начала летнего времени на день недели до или после заданной даты в месяце, например, на первый понедельник на или после 8-го числа.

Параметры:

startMonth - Месяц начала летнего времени. Месяц — значение поля MONTH (нумерация с нуля. Например, 0 для января).

startDay - Число месяца, в который начинается летнее время.

startDayOfWeek - День недели начала летнего времени.

startTime - Время начала летнего времени в местном времени, в этом случае — местное стандартное время.

after - Если true, правило выбирает первое dayOfWeek число или после dayOfMonth. Если false, правило выбирает последнее dayOfWeek число или до dayOfMonth.

Исключения:

IllegalArgumentException - если параметры startMonth, startDay, startDayOfWeek, или startTime выходят за пределы допустимого диапазона

С версии:

1.2

setEndRule

public void setEndRule(int endMonth,
                       int endDay,
                       int endDayOfWeek,
                       int endTime)

Устанавливает правило окончания летнего времени. Например, если летнее время заканчивается в последнюю субботу октября в 2 часа по местному времени, вы можете установить правило окончания, вызвав: setEndRule(Calendar.OCTOBER, -1, Calendar.SUNDAY, 2*60*60*1000);

Параметры:

endMonth - Месяц окончания летнего времени. Месяц — значение поля MONTH (нумерация с нуля. Например, 9 для октября).

endDay - Число месяца, в который заканчивается летнее время. См. описание класса для особых случаев этого параметра.

endDayOfWeek - День недели окончания летнего времени. См. описание класса для особых случаев этого параметра.

endTime - Время окончания летнего времени в местном времени (в миллисекундах в течение дня), в этом случае — местное летнее время.

Исключения:

IllegalArgumentException - если параметры endMonth, endDay, endDayOfWeek, или endTime выходят за пределы допустимого диапазона

setEndRule

public void setEndRule(int endMonth,
                       int endDay,
                       int endTime)

Устанавливает правило окончания летнего времени на фиксированную дату в месяце. Этот метод эквивалентен:

setEndRule(endMonth, endDay, 0, endTime)

Параметры:

endMonth - Месяц окончания летнего времени. Месяц — значение поля MONTH (нумерация с нуля. Например, 9 для октября).

endDay - Число месяца, в который заканчивается летнее время.

endTime - Время окончания летнего времени в местном времени (в миллисекундах в течение дня), в этом случае — местное летнее время.

Исключения:

IllegalArgumentException - параметры endMonth, endDay, или endTime выходят за пределы допустимого диапазона

С версии:

1.2

setEndRule

public void setEndRule(int endMonth,
                       int endDay,
                       int endDayOfWeek,
                       int endTime,
                       boolean after)

Устанавливает правило окончания летнего времени на день недели до или после указанной даты в месяце, например, первый понедельник на или после 8 числа.

Параметры:

endMonth - Месяц окончания летнего времени. Месяц — значение поля MONTH (нумерация с нуля. Например, 9 для октября).

endDay - Число месяца, в который заканчивается летнее время.

endDayOfWeek - День недели окончания летнего времени.

endTime - Время окончания летнего времени в местном времени (в миллисекундах в течение дня), в этом случае — местное летнее время.

after - Если true, правило выбирает первый endDayOfWeek день или после endDay. Если false, правило выбирает последний endDayOfWeek день или до endDay числа месяца.

Исключения:

IllegalArgumentException - параметры endMonth, endDay, endDayOfWeek, или endTime выходят за пределы допустимого диапазона

С версии:

1.2

getOffset

public int getOffset(long date)

Возвращает смещение этого часового пояса от UTC в заданное время. Если в заданное время действует летнее время, значение смещения корректируется с учётом летнего времени.

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

getOffset в классе TimeZone

Параметры:

date - время, для которого требуется смещение часового пояса

Возвращает:

значение времени в миллисекундах, которое нужно добавить к UTC, чтобы получить местное время.

С версии:

1.4

См. также:

Calendar.ZONE_OFFSET, Calendar.DST_OFFSET

getOffset

public int getOffset(int era,
                     int year,
                     int month,
                     int day,
                     int dayOfWeek,
                     int millis)

Задано в:

getOffset в классе TimeZone

Параметры:

era - Эра заданной даты.

year - Год в заданной дате.

month - Месяц в заданной дате. Месяц нумеруется с 0. Например, 0 для января.

day - День месяца заданной даты.

dayOfWeek - День недели заданной даты.

millis - Миллисекунды в течение дня в стандартном местном времени.

Возвращает:

Миллисекунды, которые нужно добавить к UTC, чтобы получить местное время.

Исключения:

IllegalArgumentException - параметры era, month, day, dayOfWeek, или millis выходят за пределы допустимого диапазона

См. также:

Calendar.ZONE_OFFSET, Calendar.DST_OFFSET

getRawOffset

public int getRawOffset()

Получает смещение GMT для этого часового пояса.

Задано в:

getRawOffset в классе TimeZone

Возвращает:

значение смещения GMT в миллисекундах

См. также:

setRawOffset(int)

setRawOffset

public void setRawOffset(int offsetMillis)

Устанавливает базовое смещение часового пояса от GMT. Это смещение, которое нужно добавить к UTC, чтобы получить местное время.

Задано в:

setRawOffset в классе TimeZone

Параметры:

offsetMillis - заданное базовое смещение часового пояса от GMT.

См. также:

getRawOffset()

setDSTSavings

public void setDSTSavings(int millisSavedDuringDST)

Устанавливает величину смещения времени в миллисекундах, на которую часы переводятся вперёд в летнее время.

Параметры:

millisSavedDuringDST - количество миллисекунд, на которое время переводится вперёд относительно стандартного времени, когда действуют правила летнего времени. Положительное число, обычно один час (3600000).

С версии:

1.2

См. также:

getDSTSavings()

getDSTSavings

public int getDSTSavings()

Возвращает величину смещения времени в миллисекундах, на которую часы переводятся вперёд в летнее время.

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

getDSTSavings в классе TimeZone

Возвращает:

количество миллисекунд, на которое время переводится вперёд относительно стандартного времени, когда действуют правила летнего времени, или 0 (ноль), если в этом часовом поясе нет летнего времени.

С версии:

1.2

См. также:

setDSTSavings(int)

useDaylightTime

public boolean useDaylightTime()

Определяет, использует ли этот часовой пояс летнее время.

Задано в:

useDaylightTime в классе TimeZone

Возвращает:

true, если этот часовой пояс использует летнее время; false в противном случае.

См. также:

TimeZone.inDaylightTime(Date), Calendar.DST_OFFSET

observesDaylightTime

public boolean observesDaylightTime()

Возвращает true, если этот часовой пояс использует летнее время. Этот метод эквивалентен useDaylightTime().

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

observesDaylightTime в классе TimeZone

Возвращает:

true если этот часовой пояс использует летнее время; false в противном случае.

С версии:

1.7

См. также:

TimeZone.useDaylightTime(), TimeZone.inDaylightTime(Date), Calendar.DST_OFFSET

inDaylightTime

public boolean inDaylightTime(Date date)

Определяет, находится ли заданная дата в летнем времени.

Задано в:

inDaylightTime в классе TimeZone

Параметры:

date - заданная дата.

Возвращает:

true, если в указанную дату действует летнее время; false в противном случае.

clone

public Object clone()

Возвращает копию этого экземпляра SimpleTimeZone.

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

clone в классе TimeZone

Возвращает:

копию этого экземпляра.

См. также:

Cloneable

hashCode

public int hashCode()

Генерирует хэш-код для объекта SimpleDateFormat.

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

hashCode в классе Object

Возвращает:

хэш-код этого объекта

См. также:

Object.equals(java.lang.Object), System.identityHashCode(java.lang.Object)

equals

public boolean equals(Object obj)

Сравнивает равенство двух объектов SimpleTimeZone.

Overrides:

equals в классе Object

Parameters:

obj - Объект SimpleTimeZone для сравнения.

Returns:

True, если заданный объект obj идентичен данному объекту SimpleTimeZone; иначе false.

See Also:

Object.hashCode(), HashMap

hasSameRules

public boolean hasSameRules(TimeZone other)

Возвращает true, если у данной зоны одинаковые правила и смещение по времени, что и у другой зоны.

Overrides:

hasSameRules в классе TimeZone

Parameters:

other - объект TimeZone для сравнения

Returns:

true, если заданная зона является SimpleTimeZone и имеет одинаковые правила и смещение по времени, что и текущая

Since:

1.2

toString

public String toString()

Возвращает строковое представление этой временной зоны.

Overrides:

toString в классе Object

Returns:

строковое представление этой временной зоны.