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