Класс TimeZone

TimeZone представляет смещение часового пояса, а также определяет летнее время.

Обычно вы получаете TimeZone с помощью getDefault, который создаёт TimeZone на основе часового пояса, в котором работает программа. Например, для программы, работающей в Японии, getDefault создаёт объект TimeZone на основе японского стандартного времени.

Вы также можете получить TimeZone с помощью getTimeZone вместе с идентификатором часового пояса. Например, идентификатор часового пояса для Тихоокеанского времени США — "America/Los_Angeles". Таким образом, вы можете получить объект TimeZone Тихоокеанского времени США с помощью:

TimeZone tz = TimeZone.getTimeZone("America/Los_Angeles");

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

Формат независим от локали, и цифры должны быть взяты из блока Basic Latin стандарта Unicode. С пользовательским идентификатором часового пояса нельзя указать график перехода на летнее время. Если указанная строка не соответствует синтаксису, используется "GMT".

При создании TimeZone, указанный пользовательский идентификатор часового пояса нормализуется в следующем синтаксисе:

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

Идентификаторы часовых поясов из трёх букв

Поля

SHORT

public static final int SHORT

Спецификатор стиля для getDisplayName(), указывающий короткое имя, например, "PST".

С момента:

1.2

См. также:

LONG, Значения константных полей

LONG

public static final int LONG

Спецификатор стиля для getDisplayName(), указывающий полное имя, например, "Pacific Standard Time".

С момента:

1.2

См. также:

SHORT, Значения константных полей

Конструкторы

TimeZone

public TimeZone()

Единственный конструктор. (Для вызова конструкторами подклассов, обычно неявным).

Методы

getOffset

public abstract int getOffset(int era,
                              int year,
                              int month,
                              int day,
                              int dayOfWeek,
                              int milliseconds)

Параметры:

era - эра заданной даты.

year - год в заданной дате.

month - месяц в заданной дате. Месяц нумеруется с 0. Например, 0 для января.

day - день месяца в заданной дате.

dayOfWeek - день недели в заданной дате.

milliseconds - миллисекунды в дне в стандартном местном времени.

Возвращает:

смещение в миллисекундах, которое нужно добавить к GMT для получения местного времени.

См. также:

Calendar.ZONE_OFFSET, Calendar.DST_OFFSET

getOffset

public int getOffset(long date)

Параметры:

date - дата, представленная в миллисекундах с момента 1 января 1970 года 00:00:00 GMT

Возвращает:

величина времени в миллисекундах, которую нужно добавить к UTC, чтобы получить местное время.

С момента:

1.4

См. также:

Calendar.ZONE_OFFSET, Calendar.DST_OFFSET

setRawOffset

public abstract void setRawOffset(int offsetMillis)

Параметры:

offsetMillis - заданное базовое смещение часового пояса от GMT.

getRawOffset

public abstract int getRawOffset()

Возвращает:

величину сырого смещения во времени в миллисекундах, которую нужно добавить к UTC.

См. также:

Calendar.ZONE_OFFSET

getID

public String getID()

Получает идентификатор этого часового пояса.

Возвращает:

идентификатор этого часового пояса.

setID

public void setID(String ID)

Устанавливает идентификатор часового пояса. Это не изменяет другие данные в объекте часового пояса.

Параметры:

ID - новый идентификатор часового пояса.

getDisplayName

public final String getDisplayName()

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)

getDisplayName(false, LONG, locale)

Параметры:

locale - локаль, в которой нужно предоставить имя для отображения.

Возвращает:

человекопонятное имя этого часового пояса в заданной локали.

Исключения:

NullPointerException - если locale является null.

С момента:

1.2

См. также:

getDisplayName(boolean, int, Locale)

getDisplayName

public final String getDisplayName(boolean daylight,
                                   int style)

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)

Параметры:

daylight - true указывающее имя летнего времени, или false указывающее имя стандартного времени

style - либо LONG, либо SHORT

locale - локаль, в которой нужно предоставить имя для отображения.

Возвращает:

человекопонятное имя этого часового пояса в заданной локали.

Исключения:

IllegalArgumentException - если style некорректно.

NullPointerException - если locale является null.

С момента:

1.2

См. также:

DateFormatSymbols.getZoneStrings()

getDSTSavings

public int getDSTSavings()

Возвращает:

величину сбережения времени в миллисекундах

С момента:

1.4

См. также:

inDaylightTime(Date), getOffset(long), getOffset(int,int,int,int,int,int), Calendar.ZONE_OFFSET

useDaylightTime

public abstract boolean useDaylightTime()

Возвращает:

true , если этот TimeZone использует летнее время, false, в противном случае.

См. также:

inDaylightTime(Date), Calendar.DST_OFFSET

observesDaylightTime

public boolean observesDaylightTime()

Возвращает:

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)

Получает часовой пояс для данного идентификатора.

Параметры:

ID - идентификатор часового пояса, например, сокращение «PST», полное имя «America/Los_Angeles» или пользовательский идентификатор «GMT-8:00». Обратите внимание, что поддержка сокращений предназначена только для совместимости с JDK 1.1.x, и следует использовать полные имена.

Возвращает:

указанный часовой пояс или часовой пояс GMT, если заданный идентификатор не распознан.

getTimeZone

public static TimeZone getTimeZone(ZoneId zoneId)

Получает часовой пояс для данного zoneId.

Параметры:

zoneId - ZoneId , из которого извлекается идентификатор часового пояса

Возвращает:

указанный часовой пояс или часовой пояс GMT, если заданный идентификатор не распознан.

Исключения:

NullPointerException - если zoneId равен null

С:

1.8

toZoneId

public ZoneId toZoneId()

Преобразует этот объект TimeZone в объект ZoneId.

Возвращает:

объект ZoneId , представляющий тот же часовой пояс, что и этот TimeZone

С:

1.8

getAvailableIDs

public static String[] getAvailableIDs(int rawOffset)

Получает доступные идентификаторы в соответствии с заданным смещением часового пояса в миллисекундах.

Параметры:

rawOffset - заданное смещение часового пояса от GMT в миллисекундах.

Возвращает:

массив идентификаторов, где часовой пояс для данного идентификатора имеет указанное смещение от GMT. Например, «America/Phoenix» и «America/Denver» оба имеют GMT-07:00, но различаются по поведению летнего времени.

См. также:

getRawOffset()

getAvailableIDs

public static String[] getAvailableIDs()

Получает все поддерживаемые доступные идентификаторы.

Возвращает:

массив идентификаторов.

getDefault

public static TimeZone getDefault()

Возвращает:

значение по умолчанию TimeZone

См. также:

setDefault(TimeZone)

setDefault

public static void setDefault(TimeZone zone)

Устанавливает значение по умолчанию TimeZone , которое возвращается методом getDefault. Значение по умолчанию кэшируется. Если zone равно null, кэшированное значение по умолчанию TimeZone очищается. Этот метод не изменяет значение свойства user.timezone.

Параметры:

zone - новое значение по умолчанию TimeZone, или null

Исключения:

SecurityException - если checkPermission менеджера безопасности запрещает PropertyPermission("user.timezone", "write")

См. также:

getDefault(), PropertyPermission

hasSameRules

public boolean hasSameRules(TimeZone other)

Возвращает true, если у этого часового пояса одинаковое правило и смещение, как у другого часового пояса. То есть, если этот часовой пояс отличается только идентификатором, если вообще. Возвращает false, если другой часовой пояс равен null.

Параметры:

other - объект часового пояса для сравнения

Возвращает:

true, если другой часовой пояс не равен null и такой же, как этот, за исключением, возможно, идентификатора

С:

1.2

clone

public Object clone()

Создает копию этого TimeZone.

Переопределяет:

clone в классе Object

Возвращает:

клонированный TimeZone

См. также:

Cloneable