Spec-Zone .ru
спецификации, руководства, описания, API
|
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 часового пояса: Часы должны быть между от 0 до 23, и Минуты должны быть между 00 к 59. Например, "GMT+10" и "GMT+0010" означают десять часов и десять минут перед GMT, соответственно.CustomID:GMT
Sign Hours:
MinutesGMT
Sign Hours MinutesGMT
Sign Hours Sign: one of+ -
Hours: Digit Digit Digit Minutes: Digit Digit Digit: one of0 1 2 3 4 5 6 7 8 9
Формат является независимой локалью, и цифры должны быть взяты от Основного латинского блока стандарта Unicode. Никакое расписание перехода летнего времени не может быть определено с пользовательским ID часового пояса. Если указанная строка не соответствует синтаксис, "GMT"
используется.
Создавая a TimeZone
, указанный пользовательский ID часового пояса нормализуется в следующем синтаксисе:
Например, TimeZone.getTimeZone ("GMT 8").getID () возвращает "GMT-08:00".NormalizedCustomID:GMT
Sign TwoDigitHours:
Minutes Sign: one of+ -
TwoDigitHours: Digit Digit Minutes: Digit Digit Digit: one of0 1 2 3 4 5 6 7 8 9
Calendar
, GregorianCalendar
, SimpleTimeZone
, Сериализированная ФормаМодификатор и Тип | Поле и Описание |
---|---|
static int |
ДОЛГО
Спецификатор стиля для
getDisplayName() указывая на длинное имя, такое как "Тихоокеанское время." |
static int |
КОРОТКИЙ
Спецификатор стиля для
getDisplayName() указывая на краткое название, такое как "PST". |
Конструктор и Описание |
---|
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. |
static TimeZone |
getTimeZone(ZoneId zoneId)
Добирается
TimeZone для данного zoneId . |
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.
|
ZoneId |
toZoneId()
Преобразовывает это
TimeZone возразите против a ZoneId . |
abstract boolean |
useDaylightTime()
Запросы, если это
TimeZone Летнее время использования. |
public static final int SHORT
getDisplayName()
указывая на краткое название, такое как "PST".LONG
, Постоянные Значения полейpublic static final int LONG
getDisplayName()
указывая на длинное имя, такое как "Тихоокеанское время."SHORT
, Постоянные Значения полейpublic TimeZone()
public abstract int getOffset(int era, int year, int month, int day, int dayOfWeek, int milliseconds)
Этот метод возвращает исторически корректное смещение если базовое TimeZone
подкласс реализации поддерживает историческое расписание Летнего времени и изменения смещения GMT.
era
- эра данной даты.year
- год в данной дате.month
- месяц в данной дате. Месяц на основе 0. например, 0 на январь.day
- день-в-месячном данной даты.dayOfWeek
- день-недельного данной даты.milliseconds
- миллисекунды в день в стандартное местное время.Calendar.ZONE_OFFSET
, Calendar.DST_OFFSET
public int getOffset(long date)
Этот метод возвращает исторически корректное значение смещения, если базовый подкласс реализации TimeZone поддерживает историческое расписание Летнего времени и изменения смещения GMT.
date
- дата, представленная в миллисекундах с 1 января 1970 GMT 0:00:00Calendar.ZONE_OFFSET
, Calendar.DST_OFFSET
public abstract void setRawOffset(int offsetMillis)
Если базовое TimeZone
подкласс реализации поддерживает исторические изменения смещения GMT, указанное смещение GMT устанавливается как последнее смещение GMT, и различие от известного последнего значения смещения GMT используется, чтобы скорректировать все исторические значения смещения GMT.
offsetMillis
- данное смещение зоны норматива времени к GMT.public abstract int getRawOffset()
Если базовое TimeZone
подкласс реализации поддерживает исторические изменения смещения GMT, метод возвращает необработанное значение смещения текущей даты. В Гонолулу, например, его необработанное смещение, измененное от GMT-10:30 до GMT-10:00 в 1947, и этого метода всегда, возвращает-36000000 миллисекунд (то есть,-10 часов).
Calendar.ZONE_OFFSET
public String getID()
public void setID(String ID)
ID
- новый ID часового пояса.public final String getDisplayName()
TimeZone
подходящий для представления пользователю в локали значения по умолчанию. Этот метод эквивалентен:
getDisplayName(false,LONG
, Locale.getDefault(Locale.Category.DISPLAY
))
getDisplayName(boolean, int, Locale)
, Locale.getDefault(Locale.Category)
, Locale.Category
public final String getDisplayName(Locale locale)
TimeZone
подходящий для представления пользователю в указанном locale
. Этот метод эквивалентен:
getDisplayName(false,LONG
, locale)
locale
- локаль, в которой можно предоставить имя дисплея.NullPointerException
- если locale
null
.getDisplayName(boolean, int, Locale)
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
недопустимо.getDisplayName(boolean, int, Locale)
, Locale.getDefault(Locale.Category)
, Locale.Category
, DateFormatSymbols.getZoneStrings()
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
.DateFormatSymbols.getZoneStrings()
public int getDSTSavings()
Реализация по умолчанию возвращает 3600000 миллисекунд (то есть, один час) если звонок useDaylightTime()
возвраты true
. Иначе, 0 (нуль) возвращается.
Если базовое TimeZone
подкласс реализации поддерживает исторические и будущие изменения расписания Летнего времени, этот метод возвращает количество того, чтобы экономить время последнего известного правила Летнего времени, которое может быть будущим прогнозом.
Если количество того, чтобы экономить время в любой момент времени штампует, требуется, создайте a Calendar
с этим TimeZone
и метка времени, и вызов Calendar.get
(
Calendar.DST_OFFSET
)
.
inDaylightTime(Date)
, getOffset(long)
, getOffset(int,int,int,int,int,int)
, Calendar.ZONE_OFFSET
public abstract boolean useDaylightTime()
TimeZone
Летнее время использования. Если базовое TimeZone
подкласс реализации поддерживает исторические и будущие изменения расписания Летнего времени, этот метод ссылается на последнее известное правило Летнего времени, которое может быть будущим прогнозом и, возможно, не является тем же самым как текущим правилом. Рассмотрите вызов observesDaylightTime()
если текущее правило должно также быть принято во внимание.
true
если это TimeZone
Летнее время использования, false
, иначе.inDaylightTime(Date)
, Calendar.DST_OFFSET
public boolean observesDaylightTime()
true
если это TimeZone
находится в настоящий момент в Летнее время, или если переход со Стандартного Времени до Летнего времени происходит в какое-либо будущее время. Возвраты реализации по умолчанию true
если useDaylightTime()
или inDaylightTime(new Date())
возвраты true
.
true
если это TimeZone
находится в настоящий момент в Летнее время, или если переход со Стандартного Времени до Летнего времени происходит в какое-либо будущее время; false
иначе.useDaylightTime()
, inDaylightTime(Date)
, Calendar.DST_OFFSET
public abstract boolean inDaylightTime(Date date)
date
находится в Летнее время в этом часовом поясе.date
- данная Дата.true
если данная дата находится в Летнее время, false
, иначе.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 не может быть понят.public static TimeZone getTimeZone(ZoneId zoneId)
TimeZone
для данного zoneId
.zoneId
- a ZoneId
из которого получается ID часового поясаTimeZone
, или зона GMT, если данный ID не может быть понят.NullPointerException
- если zoneId
null
public ZoneId toZoneId()
TimeZone
возразите против a ZoneId
.ZoneId
представление того же самого часового пояса как это TimeZone
public static String[] getAvailableIDs(int rawOffset)
rawOffset
- данный GMT часового пояса смещается в миллисекундах.getRawOffset()
public static String[] getAvailableIDs()
public static TimeZone getDefault()
TimeZone
для этого узла. Источник значения по умолчанию TimeZone
может меняться в зависимости от реализации.TimeZone
.setDefault(java.util.TimeZone)
public static void setDefault(TimeZone zone)
TimeZone
это возвращается getDefault
метод. Если zone
нуль, сбросьте значение по умолчанию к значению, которое это имело первоначально когда VM, сначала запущенный.zone
- новый часовой пояс значения по умолчаниюgetDefault()
public boolean hasSameRules(TimeZone other)
other
- TimeZone
объект быть по сравнению с
Для дальнейшей ссылки API и документации разработчика, см. Java Документация SE. Та документация содержит более подробные, предназначенные разработчиком описания, с концептуальными краткими обзорами, определениями сроков, обходных решений, и рабочих примеров кода.
Авторское право © 1993, 2013, Oracle и/или его филиалы. Все права защищены.
Проект сборка-b92