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