Класс TimeZone

public static final int SHORT

Начиная с:

1.2

См. также:

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

public static final int LONG

Начиная с:

1.2

См. также:

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

public TimeZone()

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

public int getOffset(long date)

Параметры:

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

Возвращает:

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

Начиная с:

1.4

См. также:

• Calendar.ZONE_OFFSET
• Calendar.DST_OFFSET

public abstract void setRawOffset(int offsetMillis)

Параметры:

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

public abstract int getRawOffset()

Возвращает:

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

См. также:

• Calendar.ZONE_OFFSET

public String getID()

Возвращает:

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

public void setID(String ID)

Требования к реализации:

Реализация по умолчанию выбрасывает NullPointerException, если ID имеет значение null

Параметры:

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

Выбрасывает:

NullPointerException — этот метод может выбросить NullPointerException, если ID имеет значение null

public final String getDisplayName()

Возвращает:

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

Начиная с:

1.2

См. также:

• getDisplayName(boolean, int, Locale)
• Locale.getDefault(Locale.Category)
• Locale.Category

public final String getDisplayName(Locale locale)

Параметры:

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

Возвращает:

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

Выбрасывает:

NullPointerException — если locale имеет значение null.

Начиная с:

1.2

См. также:

• getDisplayName(boolean, int, Locale)

public final String getDisplayName(boolean daylight, int style)

Параметры:

daylight — true для указания названия летнего времени или false для указания названия стандартного времени

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

Возвращает:

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

Выбрасывает:

IllegalArgumentException — если style недопустим.

Начиная с:

1.2

См. также:

• getDisplayName(boolean, int, Locale)
• Locale.getDefault(Locale.Category)
• Locale.Category
• DateFormatSymbols.getZoneStrings()

public String getDisplayName(boolean daylight, int style, Locale locale)

Требования к реализации:

Реализация по умолчанию выбрасывает IllegalArgumentException, если style недопустим, или NullPointerException, если ID имеет значение null.

Параметры:

daylight — true для указания названия летнего времени или false для указания названия стандартного времени

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

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

Возвращает:

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

Выбрасывает:

IllegalArgumentException — этот метод может выбросить IllegalArgumentException, если style недопустим.

NullPointerException — этот метод может выбросить NullPointerException, если ID имеет значение null

Начиная с:

1.2

См. также:

• DateFormatSymbols.getZoneStrings()

public int getDSTSavings()

Возвращает:

величину перехода на летнее время в миллисекундах

Начиная с:

1.4

См. также:

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

public abstract boolean useDaylightTime()

Возвращает:

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

См. также:

• inDaylightTime(Date)
• Calendar.DST_OFFSET

public boolean observesDaylightTime()

Возвращает:

true, если для этого TimeZone сейчас действует летнее время или если в будущем произойдет переход со стандартного времени на летнее; в противном случае — false.

Начиная с:

1.7

См. также:

• useDaylightTime()
• inDaylightTime(Date)
• Calendar.DST_OFFSET

public abstract boolean inDaylightTime(Date date)

Параметры:

date — указанная дата.

Возвращает:

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

Выбрасывает:

NullPointerException — этот метод может выбросить NullPointerException, если date имеет значение null

public static TimeZone getTimeZone(String ID)

Параметры:

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

Возвращает:

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

Выбрасывает:

NullPointerException — если ID имеет значение null

public static TimeZone getTimeZone(ZoneId zoneId)

Параметры:

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

Возвращает:

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

Выбрасывает:

NullPointerException — если zoneId имеет значение null

Начиная с:

1.8

public ZoneId toZoneId()

Возвращает:

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

Начиная с:

1.8

public static String[] getAvailableIDs(int rawOffset)

Примечание к API:

Рассмотрите возможность использования availableIDs(int), который возвращает поток доступных идентификаторов часовых поясов с указанным смещением.

Параметры:

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

Возвращает:

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

См. также:

• getRawOffset()
• availableIDs(int)

public static String[] getAvailableIDs()

Примечание к API:

Рассмотрите возможность использования availableIDs(), который возвращает поток доступных идентификаторов часовых поясов.

Возвращает:

массив поддерживаемых доступных идентификаторов

См. также:

• availableIDs()

public static Stream<String> availableIDs(int rawOffset)

Примечание по реализации:

В отличие от getAvailableIDs(int), этот метод не создает копию массива идентификаторов TimeZone.

Параметры:

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

Возвращает:

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

Начиная с:

25

См. также:

• getRawOffset()
• getAvailableIDs(int)

public static Stream<String> availableIDs()

Примечание по реализации:

В отличие от getAvailableIDs(), этот метод не создает копию массива идентификаторов TimeZone.

Возвращает:

поток поддерживаемых доступных идентификаторов

Начиная с:

25

См. также:

• getAvailableIDs()

public static TimeZone getDefault()

Возвращает:

часовой пояс TimeZone

См. также:

• setDefault(TimeZone)

public static void setDefault(TimeZone zone)

Параметры:

zone — новый часовой пояс TimeZone по умолчанию или null

См. также:

• getDefault()

public boolean hasSameRules(TimeZone other)

Параметры:

other — объект TimeZone для сравнения

Возвращает:

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

Начиная с:

1.2

public Object clone()

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

clone в классе Object

Возвращает:

клон этого TimeZone

См. также:

• Cloneable