鸿蒙OS TimeZone

TimeZone

java.lang.Object

|—java.util.TimeZone

public abstract class TimeZone
extends Object
implements Serializable, Cloneable

TimeZone 表示时区偏移量，也计算夏令时。

通常，您使用 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 平台只能识别其中之一 他们。

字段摘要

构造函数摘要

方法总结

字段详细信息

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 偏移更改，则此方法返回历史正确偏移。

参数：

返回:

添加到 GMT 以获取本地时间的偏移量（以毫秒为单位）。

getOffset

public int getOffset(long date)

返回此时区在指定日期与 UTC 的偏移量。 如果夏令时在指定日期生效，则偏移值会根据夏令时进行调整。

如果基础 TimeZone 实现子类支持历史夏令时时间表和 GMT 偏移更改，则此方法返回历史正确偏移值。

参数：

返回:

添加到 UTC 以获取本地时间的时间量（以毫秒为单位）。

setRawOffset

public abstract void setRawOffset(int offsetMillis)

将基准时区偏移设置为 GMT。 这是添加到 UTC 以获取本地时间的偏移量。

如果底层 TimeZone 实现子类支持历史 GMT 偏移量更改，则将指定的 GMT 偏移量设置为最新的 GMT 偏移量，并使用与已知的最新 GMT 偏移量值的差值来调整所有历史 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。 这不会更改时区对象中的任何其他数据。

参数：

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) 

参数:

返回:

此时区在给定语言环境中的可读名称。

Throws:

getDisplayName

public final String getDisplayName(boolean daylight, int style)

返回此 TimeZone 的指定样式的名称，该名称适合在默认语言环境中呈现给用户。 如果指定的日光为真，则返回夏令时名称（即使此 TimeZone 不遵守夏令时）。 否则，返回标准时间名称。

该方法等价于：

 getDisplayName(daylight, style,
                Locale.getDefault(Locale.Category#DISPLAY))

参数:

返回:

此时区在默认语言环境中的可读名称。

Throws:

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 格式的字符串。

参数：

返回:

此时区在给定语言环境中的可读名称。

Throws:

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)

查询给定日期是否在该时区的夏令时。

参数：

返回:

如果给定日期在夏令时，则为 true，否则为 false。

getTimeZone

public static TimeZone getTimeZone(String ID)

获取给定 ID 的时区。

参数：

返回:

指定的时区，如果无法理解给定的 ID，则为 GMT 时区。

getTimeZone

public static TimeZone getTimeZone(ZoneId zoneId)

获取给定 zoneId 的 TimeZone。

参数：

返回:

指定的时区，如果无法理解给定的 ID，则为 GMT 时区。

Throws:

toZoneId

public ZoneId toZoneId()

将此 TimeZone 对象转换为 ZoneId。

返回:

表示与此 TimeZone 相同时区的 ZoneId

getAvailableIDs

public static String[] getAvailableIDs(int rawOffset)

根据给定的时区偏移量获取可用的 ID，以毫秒为单位。

参数：

返回:

一个 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 属性的值。

参数：

Throws:

hasSameRules

public boolean hasSameRules(TimeZone other)

如果此区域与另一个区域具有相同的规则和偏移量，则返回 true。 也就是说，如果该区域仅在 ID 上有所不同，如果有的话。 如果其他区域为空，则返回 false。

参数：

返回:

如果另一个区域不为空且与此区域相同，则为 true，ID 可能除外

clone

public Object clone()

创建此 TimeZone 的副本。

覆盖：

在类 Object 中克隆

返回:

此 TimeZone 的克隆