TimeZone (Java Platform SE 8 )

java.lang.Object
- java.util.TimeZone

All Implemented Interfaces:

Serializable， Cloneable

已知直接子类：

SimpleTimeZone
```
public abstract class TimeZone
extends Object
implements Serializable, Cloneable
```
TimeZone代表一个时区偏移量，指出夏令时。
通常，你会得到一个TimeZone使用getDefault创造一个TimeZone基于时区，程序运行。例如，一个程序运行在日本，getDefault创建一个基于日本标准时间TimeZone对象。

你也可以使用getTimeZone随着时区ID，例如得到一个TimeZone，为美国太平洋时区的时区ID是“美国/ los_angeles”。所以，你可以得到一个美国太平洋时间TimeZone对象：
```
 TimeZone tz = TimeZone.getTimeZone("America/Los_Angeles");
 
```
可以使用 getAvailableIDs方法遍历所有支持时区ID。然后你可以选择一个支持的ID得到一个 TimeZone。如果时间带你想要的不是一个IDS表示支持，然后带身份证可以生成特定的时区自定义时间。一个自定义时区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。例如，“北京时间10”和“0010”，平均十小时和十分钟，比北京时间分别为。
格式是现场独立的数字必须从Unicode标准的基本拉丁语块。没有日光节约时间的过渡计划可以指定一个自定义时区ID。如果指定的字符串不符合语法，"GMT"使用。

创建一个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
 
```
例如，时区。gettimezone（“gmt-8”）。getid()返回“GMT-08:00”。在JDK 1.1的兼容性
三字母时区标识
。X，其他的三个字母的时区标识（如“科普”、“铁通”、“AST”）也支持。然而， 他们使用的是过时的因为相同的缩写，通常用于多个时区（例如，“CST”可能是美国中部标准时间”和“中国标准时间），和java平台可以只承认其中之一。
从以下版本开始：

JDK1.1

另请参见：

Calendar， GregorianCalendar， SimpleTimeZone， Serialized Form

Field Summary

Fields
Modifier and Type	Field and Description
`static int`	`LONG` 风格 `getDisplayName()`指示一个很长的名字说明符，如“太平洋标准时间。”
`static int`	`SHORT` 风格 `getDisplayName()`指示短名称说明符，如“科普”。

构造方法摘要

构造方法
Constructor and Description
`TimeZone()` 唯一的构造函数。

方法摘要

所有方法静态方法接口方法抽象方法具体的方法
Modifier and Type	Method and Description
`Object`	`clone()` 复制这 `TimeZone`。
`static String[]`	`getAvailableIDs()` 获取支持的所有可用的标识。
`static String[]`	`getAvailableIDs(int rawOffset)` 根据给定的时区偏移以毫秒为单位获取可用的入侵检测系统。
`static TimeZone`	`getDefault()` 获取java虚拟机默认的 `TimeZone`。
`String`	`getDisplayName()` 返回本 `TimeZone`适合表现在默认区域设置用户长时间的名字。
`String`	`getDisplayName(boolean daylight, int style)` 返回一个指定名称的 `style`这 `TimeZone`适合表现在默认区域设置的用户。
`String`	`getDisplayName(boolean daylight, int style, Locale locale)` 返回一个指定名称的 `style`这 `TimeZone`适合呈现在用户指定的 `locale`。
`String`	`getDisplayName(Locale locale)` 返回本 `TimeZone`适合呈现在指定的 `locale`用户长时间的名字。
`int`	`getDSTSavings()` 返回添加到本地标准时间的时间，以获得本地的墙上时钟时间。
`String`	`getID()` 获取此时区的标识。
`abstract int`	`getOffset(int era, int year, int month, int day, int dayOfWeek, int milliseconds)` 获取当前日期的时区偏移量，以进行日光节约的情况下进行修改。
`int`	`getOffset(long date)` 返回该时区的UTC偏移量在指定的日期。
`abstract int`	`getRawOffset()` 返回的时间在毫秒数量增加时会在这个时区的标准时间。
`static TimeZone`	`getTimeZone(String ID)` 获取给定ID的 `TimeZone`
`static TimeZone`	`getTimeZone(ZoneId zoneId)` 获取给定 `zoneId`的 `TimeZone`。
`boolean`	`hasSameRules(TimeZone other)` 如果此区域具有相同的规则和偏移量作为另一个区域，则返回真。
`abstract boolean`	`inDaylightTime(Date date)` 如果给定的 `date`查询在这个时区夏令时。
`boolean`	`observesDaylightTime()` 返回 `true`如果这 `TimeZone`目前在日光节约时间，或者如果一个标准时间夏令时转变发生在未来的任何时间。
`static void`	`setDefault(TimeZone zone)` 集 `TimeZone`是由 `getDefault`方法返回。
`void`	`setID(String ID)` 设置时区标识。
`abstract void`	`setRawOffset(int offsetMillis)` 设置偏移的基本时间区
`ZoneId`	`toZoneId()` 将这一 `ZoneId` `TimeZone`对象。
`abstract boolean`	`useDaylightTime()` 如果这 `TimeZone`查询使用日光节约时间。

Methods inherited from class java.lang.Object
equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

- Field Detail
  - SHORT
```
public static final int SHORT
```
    风格 getDisplayName()指示短名称说明符，如“科普”。
    
    从以下版本开始：
    
    一点二
    
    另请参见：
    
    LONG， Constant Field Values
  - LONG
```
public static final int LONG
```
    风格 getDisplayName()指示一个很长的名字说明符，如“太平洋标准时间。”
    
    从以下版本开始：
    
    一点二
    
    另请参见：
    
    SHORT， Constant Field Values
- Constructor Detail
  - 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标准日毫秒。
    
    结果
    
    在毫秒内添加到当地时间，以获得当地时间偏移。
    
    另请参见：
    
    Calendar.ZONE_OFFSET， Calendar.DST_OFFSET
  - getOffset
```
public int getOffset(long date)
```
    返回该时区的UTC偏移量在指定的日期。如果日光节约时间在指定日期生效，偏移值调整与日光节约的金额。
    此方法返回一个历史正确的偏移值，如果一个潜在的时区实现的子类支持历史日光节约时间进度和GMT偏移的变化。
    
    参数
    
    date表示的毫秒自1970年1月1日00:00:00 GMT日期
    
    结果
    
    添加到本地UTC时间以毫秒为单位的数量。
    
    从以下版本开始：
    
    一点四
    
    另请参见：
    
    Calendar.ZONE_OFFSET， Calendar.DST_OFFSET
  - setRawOffset
```
public abstract void setRawOffset(int offsetMillis)
```
    设置时区偏移基地格林威治时间是UTC偏移添加到本地时间。
    如果一个潜在的TimeZone实现的子类支持历史GMT偏移变化，指定的GMT偏移设置为新的GMT偏移和已知新GMT偏移值的差异是用来调整所有历史GMT偏移值。
    
    参数
    
    offsetMillis -给定的基本的时区偏移GMT。
  - getRawOffset
```
public abstract int getRawOffset()
```
    返回的时间在毫秒数量增加时会在这个时区的标准时间。因为这个价值不被日光节约时间的影响，它被称为原始偏移。
    如果一个潜在的TimeZone实现的子类支持历史GMT偏移的变化，该方法返回当前日期的原始偏移值。在火奴鲁鲁，例如，其原始偏移从gmt-10:30到gmt-10:00 1947，该方法总是返回36000000毫秒（即10小时）。
    
    结果
    
    添加到UTC在毫秒时间偏移量的原。
    
    另请参见：
    
    Calendar.ZONE_OFFSET
  - getID
```
public String getID()
```
    获取此时区的标识。
    
    结果
    
    这个时区的标识。
  - setID
```
public void setID(String ID)
```
    设置时区标识。这不会更改时区对象中的任何其他数据。
    
    参数
    
    ID -新时区的ID。
  - getDisplayName
```
public final String getDisplayName()
```
    返回本 TimeZone适合表现在默认区域设置用户长时间的名字。
    此方法相当于：
    getDisplayName(false, LONG, Locale.getDefault(Locale.Category.DISPLAY))
    结果
    
    在默认语言环境中的这个时区的人类可读的名称。
    
    从以下版本开始：
    
    一点二
    
    另请参见：
    
    getDisplayName(boolean, int, Locale)， Locale.getDefault(Locale.Category)， Locale.Category
  - getDisplayName
```
public final String getDisplayName(Locale locale)
```
    返回本 TimeZone适合呈现在指定的 locale用户长时间的名字。
    此方法相当于：
    getDisplayName(false, LONG, locale)
    参数
    
    locale在现场提供的显示名称。
    
    结果
    
    给定区域中的这个时区的人类可读的名称。
    
    异常
    
    如果是 null locale NullPointerException。
    
    从以下版本开始：
    
    一点二
    
    另请参见：
    
    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无效。
    
    从以下版本开始：
    
    一点二
    
    另请参见：
    
    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不遵守夏令时间）。否则，返回一个标准的时间名称。
    当寻找一个时区名称，来自指定的default Locale search path of ResourceBundle locale使用。（执行。没有fallback Locale搜索）如果一个时区名称在任何Locale的搜索路径，包括Locale.ROOT，找到了，叫回来。否则，在normalized custom ID format字符串返回。
    
    参数
    
    daylight - true指定日光节约时间的名字，或 false指定标准时间的名字
    
    style - LONG或 SHORT
    
    locale在现场提供的显示名称。
    
    结果
    
    给定区域中的这个时区的人类可读的名称。
    
    异常
    
    IllegalArgumentException -如果 style无效。
    
    如果是 null locale NullPointerException。
    
    从以下版本开始：
    
    一点二
    
    另请参见：
    
    DateFormatSymbols.getZoneStrings()
  - getDSTSavings
```
public int getDSTSavings()
```
    返回添加到本地标准时间的时间，以获得本地的墙上时钟时间。
    默认实现将返回3600000毫秒（即一小时）如果调用useDaylightTime()返回true。否则，返回0（零）。
    
    如果一个潜在的TimeZone实现的子类支持的历史和未来的日光节约时间的变化，该方法返回的最后为人所知的日光节约时间的规律，可以预测未来节省时间。
    
    如果在任何给定的时间戳是需要节约时间，构建一个Calendar这个TimeZone和时间戳，并称Calendar.get(Calendar.DST_OFFSET)。
    
    结果
    
    保存时间以毫秒为单位
    
    从以下版本开始：
    
    一点四
    
    另请参见：
    
    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否则。
    
    从以下版本开始：
    
    一点七
    
    另请参见：
    
    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的 TimeZone
    
    参数
    
    ID -一 TimeZone ID，或者一个缩写如“科普”，一个完整的名称如“美国/ los_angeles”，或一个自定义的ID如“gmt-8:00”。注意缩略语的支持是JDK 1.1。x的兼容性和完整的名称应使用。
    
    结果
    
    指定的 TimeZone，或格林威治区如果我不能理解。
  - getTimeZone
```
public static TimeZone getTimeZone(ZoneId zoneId)
```
    获取给定 zoneId的 TimeZone。
    
    参数
    
    zoneId - ZoneId从中得到的时间带身份证
    
    结果
    
    指定的 TimeZone，或格林威治区如果我不能理解。
    
    异常
    
    如果是 null zoneId NullPointerException
    
    从以下版本开始：
    
    一点八
  - toZoneId
```
public ZoneId toZoneId()
```
    将这一 ZoneId TimeZone对象。
    
    结果
    
    一个 ZoneId代表同一时区的这 TimeZone
    
    从以下版本开始：
    
    一点八
  - getAvailableIDs
```
public static String[] getAvailableIDs(int rawOffset)
```
    根据给定的时区偏移以毫秒为单位获取可用的入侵检测系统。
    
    参数
    
    rawOffset -给定的时区偏移毫秒。
    
    结果
    
    一个入侵检测系统的数组，其中的时区为具有指定的时间区域的偏移量。例如，“美国/菲尼克斯”和“美国/丹佛”都gmt-07:00，但不同的日光节约行为。
    
    另请参见：
    
    getRawOffset()
  - getAvailableIDs
```
public static String[] getAvailableIDs()
```
    获取支持的所有可用的标识。
    
    结果
    
    一系列的入侵检测系统。
  - getDefault
```
public static TimeZone getDefault()
```
    获取java虚拟机默认的 TimeZone。如果缓存的默认 TimeZone可用，其克隆返回。否则，该方法需要以下步骤来确定默认时区。
    - 如果它是可利用user.timezone属性值作为默认时区ID。
    - 检测平台时间区域的ID. The源的平台时间区和身份映射可能会有所不同与实现。
    - 使用GMT作为最后的手段，如果给定的或检测到的时区ID是未知的。
    默认TimeZone创建ID时，其克隆返回。的user.timezone属性值设置为身份回国。
    结果
    
    默认 TimeZone
    
    另请参见：
    
    setDefault(TimeZone)
  - setDefault
```
public static void setDefault(TimeZone zone)
```
    集 TimeZone是由 getDefault方法返回。 zone缓存。如果 zone为空，默认 TimeZone清除缓存。该方法不改变的 user.timezone属性的值。
    
    参数
    
    zone -新的默认 TimeZone，或空
    
    异常
    
    SecurityException -如果安全经理的 checkPermission否认 PropertyPermission("user.timezone", "write")
    
    另请参见：
    
    getDefault()， PropertyPermission
  - hasSameRules
```
public boolean hasSameRules(TimeZone other)
```
    如果此区域具有相同的规则和偏移量作为另一个区域，则返回真。也就是说，如果这个区域只在身份证上不同，如果在所有。如果另一区域为空，则返回错误。
    
    参数
    
    other要与 TimeZone对象
    
    结果
    
    如果另一个区域不是空的，和这一区域相同，则可能有可能的异常
    
    从以下版本开始：
    
    一点二
  - clone
```
public Object clone()
```
    复制这 TimeZone。
    
    重写：
    
    clone 方法重写，继承类 Object
    
    结果
    
    这 TimeZone克隆
    
    另请参见：
    
    Cloneable

Submit a bug or feature
For further API reference and developer documentation, see Java SE Documentation. That documentation contains more detailed, developer-targeted descriptions, with conceptual overviews, definitions of terms, workarounds, and working code examples.
Copyright © 1993, 2014, Oracle and/or its affiliates. All rights reserved.

Class TimeZone

三字母时区标识

Field Summary

构造方法摘要

方法摘要

Methods inherited from class java.lang.Object

Field Detail

SHORT

LONG

Constructor Detail

TimeZone

方法详细信息

getOffset

getOffset

setRawOffset

getRawOffset

getID

setID

getDisplayName

getDisplayName

getDisplayName

getDisplayName

getDSTSavings

useDaylightTime

observesDaylightTime

inDaylightTime

getTimeZone

getTimeZone

toZoneId

getAvailableIDs

getAvailableIDs

getDefault

setDefault

hasSameRules

clone