TimeZone
java.lang.Object
|—java.util.TimeZone
public abstract class TimeZone
extends Object
implements Serializable, CloneableTimeZone 表示时区偏移量，也计算夏令时。
通常，您使用 getDefault 获得一个 TimeZone，它根据程序运行的时区创建一个 TimeZone。 例如，对于在日本运行的程序，getDefault 根据日本标准时间创建一个 TimeZone 对象。
您还可以使用 getTimeZone 和时区 ID 获取 TimeZone。 例如，美国太平洋时区的时区 ID 是“America/Los_Angeles”。 因此，您可以通过以下方式获取美国太平洋时间 TimeZone 对象：
TimeZone tz = TimeZone.getTimeZone("America/Los_Angeles"); 您可以使用 getAvailableIDs 方法遍历所有受支持的时区 ID。 然后，您可以选择支持的 ID 来获取 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”。
创建 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 平台只能识别其中之一 他们。
字段摘要
| 修饰符和类型 | 字段 | 描述 |
|---|---|---|
| static int | LONG | getDisplayName() 的样式说明符，指示长名称，例如“太平洋标准时间”。 |
| static int | SHORT | getDisplayName() 的样式说明符，指示短名称，例如“PST”。 |
构造函数摘要
| 构造函数 | 描述 |
|---|---|
| TimeZone() | 唯一的构造函数 |
方法总结
| 修饰符和类型 | 方法 | 描述 |
|---|---|---|
| Object | clone() | 创建此 TimeZone 的副本。 |
| static String[] | getAvailableIDs() | 获取支持的所有可用 ID。 |
| static String[] | getAvailableIDs(int rawOffset) | 根据给定的时区偏移量获取可用的 ID，以毫秒为单位。 |
| static TimeZone | getDefault() | 获取 Java 虚拟机的默认时区。 |
| String | getDisplayName() | 返回此 TimeZone 的长标准时间名称，适合在默认语言环境中呈现给用户。 |
| String | getDisplayName(boolean daylight, int style) | 返回此 TimeZone 的指定样式的名称，该名称适合在默认语言环境中呈现给用户。 |
| String | getDisplayName(boolean daylight, int style, Locale locale) | 返回此 TimeZone 的指定样式的名称，该名称适合在指定区域设置中呈现给用户。 |
| String | getDisplayName(Locale locale) | 返回此 TimeZone 的长标准时间名称，适合在指定区域设置中呈现给用户。 |
| int | getDSTSavings() | 返回要添加到本地标准时间以获取本地挂钟时间的时间量。 |
| String | 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) | 获取给定 ID 的时区。 |
| static TimeZone | getTimeZone(ZoneId zoneId) | 获取给定 zoneId 的 TimeZone。 |
| boolean | hasSameRules(TimeZone other) | 如果此区域与另一个区域具有相同的规则和偏移量，则返回 true。 |
| abstract boolean | inDaylightTime(Date date) | 查询给定日期是否在该时区的夏令时。 |
| boolean | observesDaylightTime() | 如果此 TimeZone 当前处于夏令时，或者如果在将来的任何时间发生从标准时间到夏令时的转换，则返回 true。 |
| static void | setDefault(TimeZone zone) | 设置由 getDefault 方法返回的 TimeZone。 |
| void | setID(String ID) | 设置时区 ID。 |
| abstract void | setRawOffset(int offsetMillis) | 将基准时区偏移设置为 GMT。 |
| ZoneId | toZoneId() | 将此 TimeZone 对象转换为 ZoneId。 |
| abstract boolean | useDaylightTime() | 查询此 TimeZone 是否使用夏令时。 |
| 从类 java.lang.Object 继承的方法 |
|---|
| equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait |
字段详细信息
LONG
public static final int LONG
getDisplayName() 的样式说明符，指示长名称，例如“太平洋标准时间”。
SHORT
public static final int SHORT
getDisplayName() 的样式说明符，指示短名称，例如“PST”。
构造函数详细信息
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 以获取本地时间的偏移量（以毫秒为单位）。
getOffset
public int getOffset(long date)
返回此时区在指定日期与 UTC 的偏移量。 如果夏令时在指定日期生效，则偏移值会根据夏令时进行调整。
如果基础 TimeZone 实现子类支持历史夏令时时间表和 GMT 偏移更改，则此方法返回历史正确偏移值。
参数：
| 参数名称 | 参数描述 |
|---|---|
| date | 自 1970 年 1 月 1 日 00:00:00 GMT 以来以毫秒为单位的日期 |
返回:
添加到 UTC 以获取本地时间的时间量（以毫秒为单位）。
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 偏移更改，则该方法返回当前日期的原始偏移值。 例如，在檀香山，其原始偏移量在 1947 年从 GMT-10:30 更改为 GMT-10:00，并且此方法始终返回 -36000000 毫秒（即 -10 小时）。
返回:
添加到 UTC 的原始偏移时间量（以毫秒为单位）。
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))返回:
此时区在默认语言环境中的可读名称。
getDisplayName
public final String getDisplayName(Locale locale)
返回此 TimeZone 的长标准时间名称，适合在指定区域设置中呈现给用户。
该方法等价于：
getDisplayName(false, LONG, locale) 参数:
| 参数名称 | 参数描述 |
|---|---|
| locale | 提供显示名称的语言环境。 |
返回:
此时区在给定语言环境中的可读名称。
Throws:
| Throw名称 | Throw描述 |
|---|---|
| NullPointerException | 如果 locale 为空 |
getDisplayName
public final String getDisplayName(boolean daylight, int style)
返回此 TimeZone 的指定样式的名称，该名称适合在默认语言环境中呈现给用户。 如果指定的日光为真，则返回夏令时名称（即使此 TimeZone 不遵守夏令时）。 否则，返回标准时间名称。
该方法等价于：
getDisplayName(daylight, style,
Locale.getDefault(Locale.Category#DISPLAY))参数:
| 参数名称 | 参数描述 |
|---|---|
| daylight | true 指定夏令时名称，或 false 指定标准时间名称 |
| style | 长或短 |
返回:
此时区在默认语言环境中的可读名称。
Throws:
| Throw名称 | Throw描述 |
|---|---|
| IllegalArgumentException | 如果 style 无效 |
getDisplayName
public String getDisplayName(boolean daylight, int style, Locale locale)
返回此 TimeZone 的指定样式的名称，该名称适合在指定区域设置中呈现给用户。 如果指定的日光为真，则返回夏令时名称（即使此 TimeZone 不遵守夏令时）。 否则，返回标准时间名称。
查找时区名称时，使用从指定语言环境派生的 ResourceBundle.Control#getCandidateLocales(String,Locale)。 （不执行 ResourceBundle.Control#getFallbackLocale(String,Locale) 搜索。）如果在搜索路径的任何 Locale 中找到时区名称，包括 Locale#ROOT，则返回该名称。 否则，返回标准化自定义 ID 格式的字符串。
参数：
| 参数名称 | 参数描述 |
|---|---|
| daylight | true 指定夏令时名称，或 false 指定标准时间名称 |
| style | 长或短 |
| locale | 提供显示名称的语言环境。 |
返回:
此时区在给定语言环境中的可读名称。
Throws:
| Throw名称 | Throw描述 |
|---|---|
| IllegalArgumentException | 如果 style 无效 |
| NullPointerException | 如果 locale 为空 |
getDSTSavings
public int getDSTSavings()
返回要添加到本地标准时间以获取本地挂钟时间的时间量。
如果对 useDaylightTime() 的调用返回 true，则默认实现返回 3600000 毫秒（即一小时）。 否则，返回 0（零）。
如果底层 TimeZone 实现子类支持历史和未来夏令时计划更改，则此方法返回可以作为未来预测的最后一个已知夏令时规则的节省时间量。
如果需要任何给定时间戳的节省时间量，请使用此 TimeZone 和时间戳构造一个日历，并调用 Calendar#get(int)(Calendar#DST_OFFSET)。
返回：
以毫秒为单位的节省时间
useDaylightTime
public abstract boolean useDaylightTime()
查询此 TimeZone 是否使用夏令时。
如果底层 TimeZone 实现子类支持历史和未来的夏令时时间表更改，则此方法引用最后一个已知的夏令时规则，该规则可以是未来的预测，并且可能与当前规则不同。 如果还应考虑当前规则，请考虑调用observesDaylightTime()。
返回：
如果此 TimeZone 使用夏令时，则为 true，否则为 false。
observesDaylightTime
public boolean observesDaylightTime()
如果此 TimeZone 当前处于夏令时，或者如果在将来的任何时间发生从标准时间到夏令时的转换，则返回 true。
如果 useDaylightTime() 或 inDaylightTime(new Date()) 返回 true，则默认实现返回 true。
返回：
如果此 TimeZone 当前处于夏令时，或者如果在未来任何时间发生从标准时间到夏令时的转换，则为 true； 否则为 false。
inDaylightTime
public abstract boolean inDaylightTime(Date date)
查询给定日期是否在该时区的夏令时。
参数：
| 参数名称 | 参数描述 |
|---|---|
| date | 给定的日期。 |
返回:
如果给定日期在夏令时，则为 true，否则为 false。
getTimeZone
public static TimeZone getTimeZone(String ID)
获取给定 ID 的时区。
参数：
| 参数名称 | 参数描述 |
|---|---|
| ID | TimeZone 的 ID，可以是“PST”等缩写、“America/Los_Angeles”等全名或“GMT-8:00”等自定义 ID。 请注意，支持缩写仅是为了兼容 JDK 1.1.x，应使用全名。 |
返回:
指定的时区，如果无法理解给定的 ID，则为 GMT 时区。
getTimeZone
public static TimeZone getTimeZone(ZoneId zoneId)
获取给定 zoneId 的 TimeZone。
参数：
| 参数名称 | 参数描述 |
|---|---|
| zoneId | 从中获取时区 ID 的 ZoneId |
返回:
指定的时区，如果无法理解给定的 ID，则为 GMT 时区。
Throws:
| Throw名称 | Throw描述 |
|---|---|
| NullPointerException | 如果 zoneId 为空 |
toZoneId
public ZoneId toZoneId()
将此 TimeZone 对象转换为 ZoneId。
返回:
表示与此 TimeZone 相同时区的 ZoneId
getAvailableIDs
public static String[] getAvailableIDs(int rawOffset)
根据给定的时区偏移量获取可用的 ID，以毫秒为单位。
参数：
| 参数名称 | 参数描述 |
|---|---|
| rawOffset | 给定的时区 GMT 偏移量（以毫秒为单位）。 |
返回:
一个 ID 数组，其中该 ID 的时区具有指定的 GMT 偏移量。 例如，“America/Phoenix”和“America/Denver”都有 GMT-07:00，但夏令时行为不同。
getAvailableIDs
public static String[] getAvailableIDs()
获取支持的所有可用 ID。
返回:
一个 ID 数组。
getDefault
public static TimeZone getDefault()
获取 Java 虚拟机的默认时区。 如果缓存的默认 TimeZone 可用，则返回其克隆。 否则，该方法采取以下步骤来确定默认时区。
- 使用 user.timezone 属性值作为默认时区 ID（如果可用）。
- 检测平台时区 ID。 平台时区和 ID 映射的来源可能因实现而异。
- 如果给定或检测到的时区 ID 未知，则使用 GMT 作为最后的手段。
从 ID 创建的默认 TimeZone 被缓存，并返回其克隆。 user.timezone 属性值在返回时设置为 ID。
返回:
默认时区
setDefault
public static void setDefault(TimeZone zone)
设置由 getDefault 方法返回的 TimeZone。 区域被缓存。 如果 zone 为 null，则清除缓存的默认 TimeZone。 此方法不会更改 user.timezone 属性的值。
参数：
| 参数名称 | 参数描述 |
|---|---|
| zone | 新的默认时区，或 null |
Throws:
| Throw名称 | Throw描述 |
|---|---|
| SecurityException | 如果安全管理器的 checkPermission 拒绝 PropertyPermission(“user.timezone”, “write”) |
hasSameRules
public boolean hasSameRules(TimeZone other)
如果此区域与另一个区域具有相同的规则和偏移量，则返回 true。 也就是说，如果该区域仅在 ID 上有所不同，如果有的话。 如果其他区域为空，则返回 false。
参数：
| 参数名称 | 参数描述 |
|---|---|
| other | 要与之比较的 TimeZone 对象 |
返回:
如果另一个区域不为空且与此区域相同，则为 true，ID 可能除外
clone
public Object clone()
创建此 TimeZone 的副本。
覆盖：
在类 Object 中克隆
返回:
此 TimeZone 的克隆
文章来源网络，作者：运维，如若转载，请注明出处：https://shuyeidc.com/wp/179623.html<
