TimeZone (Платформа Java SE 7)

java.lang. Объект
- java.util. TimeZone

Все Реализованные Интерфейсы:

Сериализуемый, Cloneable

Прямые Известные Подклассы:

SimpleTimeZone
```
public abstract class TimeZone
extends Object
implements Serializable, Cloneable
```
TimeZone представляет смещение часового пояса, и также выясняет переход на летнее время.
Как правило, Вы получаете a TimeZone использование getDefault который создает a TimeZone основанный на часовом поясе, куда программа работает. Например, для программы, работающей в Японии, getDefault создает a TimeZone основанный на объектах на японском Стандартном Времени.
Можно также получить a TimeZone использование getTimeZone наряду с ID часового пояса. Например, ID часового пояса для американской зоны Тихоокеанского времени является "America/Los_Angeles". Так, можно получить американское Тихоокеанское время TimeZone объект с:
```
 TimeZone tz = TimeZone.getTimeZone("America/Los_Angeles");
 
```
Можно использовать getAvailableIDs метод, чтобы выполнить итерации через все поддерживаемые ID часового пояса. Можно тогда выбрать поддерживаемый ID, чтобы получить a TimeZone. Если часовой пояс, который Вы хотите, не представляется одним из поддерживаемых ID, то пользовательский ID часового пояса может быть определен, чтобы произвести TimeZone. Синтаксис пользовательского ID часового пояса:
```
 CustomID:
         GMT Sign Hours : Minutes
         GMT Sign Hours Minutes
         GMT Sign Hours
 Sign: one of
         + -
 Hours:
         Digit
         Digit Digit
 Minutes:
         Digit Digit
 Digit: one of
         0 1 2 3 4 5 6 7 8 9
 
```
Часы должны быть между от 0 до 23, и Минуты должны быть между 00 к 59. Например, "GMT+10" и "GMT+0010" означают десять часов и десять минут перед GMT, соответственно.
Формат является независимой локалью, и цифры должны быть взяты от Основного латинского блока стандарта Unicode. Никакое расписание перехода летнего времени не может быть определено с пользовательским ID часового пояса. Если указанная строка не соответствует синтаксис, "GMT" используется.
Создавая a TimeZone, указанный пользовательский ID часового пояса нормализуется в следующем синтаксисе:
```
 NormalizedCustomID:
         GMT Sign TwoDigitHours : Minutes
 Sign: one of
         + -
 TwoDigitHours:
         Digit Digit
 Minutes:
         Digit Digit
 Digit: one of
         0 1 2 3 4 5 6 7 8 9
 
```
Например, TimeZone.getTimeZone ("GMT 8").getID () возвращает "GMT-08:00".
Трехбуквенные ID часового пояса
Для совместимости с JDK 1.1.x, также поддерживаются некоторые другие трехбуквенные ID часового пояса (такие как "PST", "CTT", "AST"). Однако, их использование осуждается, потому что то же самое сокращение часто используется для многократных часовых поясов (например, "CST" мог быть американским "Центральным Стандартным Временем" и "китайским Стандартным Временем"), и платформа Java может тогда только распознать одного из них.
С тех пор:

JDK1.1

См. Также:
Calendar, GregorianCalendar, SimpleTimeZone, Сериализированная Форма

Полевая Сводка

Поля
Модификатор и Тип	Поле и Описание
`static int`	`ДОЛГО` Спецификатор стиля для `getDisplayName()` указывая на длинное имя, такое как "Тихоокеанское время."
`static int`	`КОРОТКИЙ` Спецификатор стиля для `getDisplayName()` указывая на краткое название, такое как "PST".

Сводка конструктора

Конструкторы
Конструктор и Описание

TimeZone()
Единственный конструктор.

Конструкторы
Конструктор и Описание
`TimeZone()` Единственный конструктор.

Сводка метода

Методы
Модификатор и Тип	Метод и Описание
`Объект`	`clone()` Создает копию этого `TimeZone`.
`static String[]`	`getAvailableIDs()` Получает все доступные поддерживаемые ID.
`static String[]`	`getAvailableIDs(int rawOffset)` Получает доступные ID согласно данному смещению часового пояса в миллисекундах.
`static TimeZone`	`getDefault()` Получает значение по умолчанию `TimeZone` для этого узла.
`Строка`	`getDisplayName()` Возвращает длинное стандартное имя времени этого `TimeZone` подходящий для представления пользователю в локали по умолчанию.
`Строка`	`getDisplayName(boolean daylight, int style)` Возвращает имя в указанном `style` из этого `TimeZone` подходящий для представления пользователю в локали по умолчанию.
`Строка`	`getDisplayName(boolean daylight, int style, Locale locale)` Возвращает имя в указанном `style` из этого `TimeZone` подходящий для представления пользователю в указанном `locale`.
`Строка`	`getDisplayName(Locale locale)` Возвращает длинное стандартное имя времени этого `TimeZone` подходящий для представления пользователю в указанном `locale`.
`int`	`getDSTSavings()` Возвращает количество времени, которое будет добавлено к локальному стандартному времени, чтобы добраться, локальная стена показывают время.
`Строка`	`getID()` Получает ID этого часового пояса.
`abstract int`	`getOffset(int era, int year, int month, int day, int dayOfWeek, int milliseconds)` Смещали часовой пояс, для текущей даты, измененной в случае перехода на летнее время.
`int`	`getOffset(long date)` Возвращает смещение этого часового пояса от UTC в указанной дате.
`abstract int`	`getRawOffset()` Возвращает количество времени в миллисекундах, чтобы добавить к UTC, чтобы получить стандартное время в этом часовом поясе.
`static TimeZone`	`getTimeZone(String ID)` Добирается `TimeZone` для данного ID.
`boolean`	`hasSameRules(TimeZone other)` Возвращает true, если у этой зоны есть то же самое правило и смещение как другая зона.
`abstract boolean`	`inDaylightTime(Date date)` Запросы, если данный `date` находится в Летнее время в этом часовом поясе.
`boolean`	`observesDaylightTime()` Возвраты `true` если это `TimeZone` находится в настоящий момент в Летнее время, или если переход со Стандартного Времени до Летнего времени происходит в какое-либо будущее время.
`static void`	`setDefault(TimeZone zone)` Наборы `TimeZone` это возвращается `getDefault` метод.
`void`	`setID(String ID)` Устанавливает ID часового пояса.
`abstract void`	`setRawOffset(int offsetMillis)` Устанавливает смещение зоны норматива времени в GMT.
`abstract boolean`	`useDaylightTime()` Запросы, если это `TimeZone` Летнее время использования.

Методы java.lang унаследованный от класса. Объект
equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

- Полевая Деталь
  - КОРОТКИЙ
```
public static final int SHORT
```
    Спецификатор стиля для getDisplayName() указывая на краткое название, такое как "PST".
    
    С тех пор:
    
    1.2
    
    См. Также:
    LONG, Постоянные Значения полей
  - ДОЛГО
```
public static final int LONG
```
    Спецификатор стиля для getDisplayName() указывая на длинное имя, такое как "Тихоокеанское время."
    
    С тех пор:
    
    1.2
    
    См. Также:
    SHORT, Постоянные Значения полей
- Деталь конструктора
  - TimeZone
```
public TimeZone()
```
    Единственный конструктор. (Для вызова конструкторами подкласса, обычно неявными.)
- Деталь метода
  - getOffset
```
public abstract int getOffset(int era,
            int year,
            int month,
            int day,
            int dayOfWeek,
            int milliseconds)
```
    Смещали часовой пояс, для текущей даты, измененной в случае перехода на летнее время. Это - смещение, чтобы добавить к UTC, чтобы получить местное время.
    Этот метод возвращает исторически корректное смещение если базовое TimeZone подкласс реализации поддерживает историческое расписание Летнего времени и изменения смещения GMT.
    
    Параметры:
    era - эра данной даты.
    year - год в данной дате.
    month - месяц в данной дате. Месяц на основе 0. например, 0 на январь.
    day - день-в-месячном данной даты.
    dayOfWeek - день-недельного данной даты.
    milliseconds - миллисекунды в день в стандартное местное время.
    
    Возвраты:
    смещение в миллисекундах, чтобы добавить к GMT, чтобы получить местное время.
    См. Также:
    Calendar.ZONE_OFFSET, Calendar.DST_OFFSET
  - getOffset
```
public int getOffset(long date)
```
    Возвращает смещение этого часового пояса от UTC в указанной дате. Если Летнее время в действительности в указанной дате, значение смещения корректируется с количеством перехода на летнее время.
    Этот метод возвращает исторически корректное значение смещения, если базовый подкласс реализации TimeZone поддерживает историческое расписание Летнего времени и изменения смещения GMT.
    
    Параметры:
    date - дата, представленная в миллисекундах с 1 января 1970 GMT 0:00:00
    
    Возвраты:
    количество времени в миллисекундах, чтобы добавить к UTC, чтобы получить местное время.
    С тех пор:
    
    1.4
    
    См. Также:
    Calendar.ZONE_OFFSET, Calendar.DST_OFFSET
  - setRawOffset
```
public abstract void setRawOffset(int offsetMillis)
```
    Устанавливает смещение зоны норматива времени в GMT. Это - смещение, чтобы добавить к UTC, чтобы получить местное время.
    Если базовое TimeZone подкласс реализации поддерживает исторические изменения смещения GMT, указанное смещение GMT устанавливается как последнее смещение GMT, и различие от известного последнего значения смещения GMT используется, чтобы скорректировать все исторические значения смещения GMT.
    
    Параметры:
    offsetMillis - данное смещение зоны норматива времени к GMT.
  - getRawOffset
```
public abstract int getRawOffset()
```
    Возвращает количество времени в миллисекундах, чтобы добавить к UTC, чтобы получить стандартное время в этом часовом поясе. Поскольку на это значение не влияют, днем экономя время, его вызывают необработанным смещением.
    Если базовое TimeZone подкласс реализации поддерживает исторические изменения смещения GMT, метод возвращает необработанное значение смещения текущей даты. В Гонолулу, например, его необработанное смещение, измененное от GMT-10:30 до GMT-10:00 в 1947, и этого метода всегда, возвращает-36000000 миллисекунд (то есть,-10 часов).
    
    Возвраты:
    количество необработанного времени смещения в миллисекундах, чтобы добавить к UTC.
    См. Также:
    Calendar.ZONE_OFFSET
  - getID
```
public String getID()
```
    Получает ID этого часового пояса.
    
    Возвраты:
    ID этого часового пояса.
  - setID
```
public void setID(String ID)
```
    Устанавливает ID часового пояса. Это не изменяет никакие другие данные в объекте часового пояса.
    
    Параметры:
    ID - новый ID часового пояса.
  - getDisplayName
```
public final String getDisplayName()
```
    Возвращает длинное стандартное имя времени этого TimeZone подходящий для представления пользователю в локали по умолчанию.
    Этот метод эквивалентен:
```
 getDisplayName(false, LONG,
                Locale.getDefault(Locale.Category.DISPLAY))
 
```
    Возвраты:
    удобочитаемое имя этого часового пояса в локали по умолчанию.
    С тех пор:
    
    1.2
    
    См. Также:
    getDisplayName(boolean, int, Locale), Locale.getDefault(Locale.Category), Locale.Category
  - getDisplayName
```
public final String getDisplayName(Locale locale)
```
    Возвращает длинное стандартное имя времени этого TimeZone подходящий для представления пользователю в указанном locale.
    Этот метод эквивалентен:
```
 getDisplayName(false, LONG, locale)
 
```
    Параметры:
    locale - локаль, в которой можно предоставить имя дисплея.
    
    Возвраты:
    удобочитаемое имя этого часового пояса в данной локали.
    
    Броски:
    
    NullPointerException - если locale null.
    С тех пор:
    
    1.2
    
    См. Также:
    getDisplayName(boolean, int, Locale)
  - getDisplayName
```
public final String getDisplayName(boolean daylight,
                    int style)
```
    Возвращает имя в указанном style из этого TimeZone подходящий для представления пользователю в локали по умолчанию. Если указанное daylight true, имя Летнего времени возвращается (даже если это TimeZone не наблюдает Летнее время). Иначе, Стандартное имя Времени возвращается.
    Этот метод эквивалентен:
```
 getDisplayName(daylight, style,
                Locale.getDefault(Locale.Category.DISPLAY))
 
```
    Параметры:
    daylight - true определение имени Летнего времени, или false определение Стандартного имени Времени
    style - также LONG или SHORT
    
    Возвраты:
    удобочитаемое имя этого часового пояса в локали по умолчанию.
    
    Броски:
    
    IllegalArgumentException - если style недопустимо.
    С тех пор:
    
    1.2
    
    См. Также:
    getDisplayName(boolean, int, Locale), Locale.getDefault(Locale.Category), Locale.Category, DateFormatSymbols.getZoneStrings()
  - getDisplayName
```
public String getDisplayName(boolean daylight,
                    int style,
                    Locale locale)
```
    Возвращает имя в указанном style из этого TimeZone подходящий для представления пользователю в указанном locale. Если указанное daylight true, имя Летнего времени возвращается (даже если это TimeZone не наблюдает Летнее время). Иначе, Стандартное имя Времени возвращается.
    Ища имя часового пояса, значение по умолчанию Locale путь поиска ResourceBundle полученный из указанного locale используется. (Никакая нейтрализация Locale поиск выполняется.), Если имя часового пояса в любом Locale из пути поиска, включая Locale.ROOT, находится, имя возвращается. Иначе, строка в нормализованном пользовательском формате ID возвращается.
    
    Параметры:
    daylight - true определение имени Летнего времени, или false определение Стандартного имени Времени
    style - также LONG или SHORT
    locale - локаль, в которой можно предоставить имя дисплея.
    
    Возвраты:
    удобочитаемое имя этого часового пояса в данной локали.
    
    Броски:
    
    IllegalArgumentException - если style недопустимо.
    
    NullPointerException - если locale null.
    С тех пор:
    
    1.2
    
    См. Также:
    DateFormatSymbols.getZoneStrings()
  - getDSTSavings
```
public int getDSTSavings()
```
    Возвращает количество времени, которое будет добавлено к локальному стандартному времени, чтобы добраться, локальная стена показывают время.
    Реализация по умолчанию возвращает 3600000 миллисекунд (то есть, один час) если звонок useDaylightTime() возвраты true. Иначе, 0 (нуль) возвращается.
    Если базовое TimeZone подкласс реализации поддерживает исторические и будущие изменения расписания Летнего времени, этот метод возвращает количество того, чтобы экономить время последнего известного правила Летнего времени, которое может быть будущим прогнозом.
    Если количество того, чтобы экономить время в любой момент времени штампует, требуется, создайте a Calendar с этим TimeZone и метка времени, и вызов Calendar.get(Calendar.DST_OFFSET).
    
    Возвраты:
    количество того, чтобы экономить время в миллисекундах
    С тех пор:
    
    1.4
    
    См. Также:
    inDaylightTime(Date), getOffset(long), getOffset(int,int,int,int,int,int), Calendar.ZONE_OFFSET
  - useDaylightTime
```
public abstract boolean useDaylightTime()
```
    Запросы, если это TimeZone Летнее время использования.
    Если базовое TimeZone подкласс реализации поддерживает исторические и будущие изменения расписания Летнего времени, этот метод ссылается на последнее известное правило Летнего времени, которое может быть будущим прогнозом и, возможно, не является тем же самым как текущим правилом. Рассмотрите вызов observesDaylightTime() если текущее правило должно также быть принято во внимание.
    
    Возвраты:
    true если это TimeZone Летнее время использования, false, иначе.
    См. Также:
    inDaylightTime(Date), Calendar.DST_OFFSET
  - observesDaylightTime
```
public boolean observesDaylightTime()
```
    Возвраты true если это TimeZone находится в настоящий момент в Летнее время, или если переход со Стандартного Времени до Летнего времени происходит в какое-либо будущее время.
    Возвраты реализации по умолчанию true если useDaylightTime() или inDaylightTime(new Date()) возвраты true.
    
    Возвраты:
    true если это TimeZone находится в настоящий момент в Летнее время, или если переход со Стандартного Времени до Летнего времени происходит в какое-либо будущее время; false иначе.
    С тех пор:
    
    1.7
    
    См. Также:
    useDaylightTime(), inDaylightTime(Date), Calendar.DST_OFFSET
  - inDaylightTime
```
public abstract boolean inDaylightTime(Date date)
```
    Запросы, если данный date находится в Летнее время в этом часовом поясе.
    
    Параметры:
    date - данная Дата.
    
    Возвраты:
    true если данная дата находится в Летнее время, false, иначе.
  - getTimeZone
```
public static TimeZone getTimeZone(String ID)
```
    Добирается TimeZone для данного ID.
    
    Параметры:
    ID - ID для a TimeZone, или сокращение, такое как "PST", полное имя, такое как "America/Los_Angeles", или пользовательский ID, такой как "GMT-8:00". Отметьте, что поддержка сокращений для JDK 1.1.x, совместимость только и полные имена должны использоваться.
    
    Возвраты:
    указанное TimeZone, или зона GMT, если данный ID не может быть понят.
  - getAvailableIDs
```
public static String[] getAvailableIDs(int rawOffset)
```
    Получает доступные ID согласно данному смещению часового пояса в миллисекундах.
    
    Параметры:
    rawOffset - данный GMT часового пояса смещается в миллисекундах.
    
    Возвраты:
    массив ID, где часовому поясу для того ID смещали указанный GMT. Например, "Америка/Финикс" и "Америка/Денвер" оба имеют GMT-07:00, но отличаются по поведению перехода на летнее время.
    См. Также:
    getRawOffset()
  - getAvailableIDs
```
public static String[] getAvailableIDs()
```
    Получает все доступные поддерживаемые ID.
    
    Возвраты:
    массив ID.
  - getDefault
```
public static TimeZone getDefault()
```
    Получает значение по умолчанию TimeZone для этого узла. Источник значения по умолчанию TimeZone может меняться в зависимости от реализации.
    
    Возвраты:
    значение по умолчанию TimeZone.
    См. Также:
    setDefault(java.util.TimeZone)
  - setDefault
```
public static void setDefault(TimeZone zone)
```
    Наборы TimeZone это возвращается getDefault метод. Если zone нуль, сбросьте значение по умолчанию к значению, которое это имело первоначально когда VM, сначала запущенный.
    
    Параметры:
    zone - новый часовой пояс по умолчанию
    См. Также:
    getDefault()
  - hasSameRules
```
public boolean hasSameRules(TimeZone other)
```
    Возвращает true, если у этой зоны есть то же самое правило и смещение как другая зона. Таким образом, если эта зона отличается только по ID, если вообще. Возвращает false, если другая зона является нулем.
    
    Параметры:
    other - TimeZone объект быть по сравнению с
    
    Возвраты:
    истина, если другая зона не является нулем и является тем же самым как этим с возможным исключением ID
    С тех пор:
    
    1.2
  - клон
```
public Object clone()
```
    Создает копию этого TimeZone.
    
    Переопределения:
    
    clone в классе Object
    
    Возвраты:
    клон этого TimeZone
    См. Также:
    Cloneable

Представьте ошибку или функцию
Для дальнейшей ссылки API и документации разработчика, см. Java Документация SE. Та документация содержит более подробные, предназначенные разработчиком описания, с концептуальными краткими обзорами, определениями сроков, обходных решений, и рабочих примеров кода.
Авторское право © 1993, 2011, Oracle и/или его филиалы. Все права защищены.

Класс TimeZone

Трехбуквенные ID часового пояса

Полевая Сводка

Сводка конструктора

Сводка метода

Методы java.lang унаследованный от класса. Объект

Полевая Деталь

КОРОТКИЙ

ДОЛГО

Деталь конструктора

TimeZone

Деталь метода

getOffset

getOffset

setRawOffset

getRawOffset

getID

setID

getDisplayName

getDisplayName

getDisplayName

getDisplayName

getDSTSavings

useDaylightTime

observesDaylightTime

inDaylightTime

getTimeZone

getAvailableIDs

getAvailableIDs

getDefault

setDefault

hasSameRules

клон