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