类 java.util.TimeZone
java.lang.Object
|
+----java.util.TimeZone
- public abstract class TimeZone
- extends Object
- implements Serializable, Cloneable
- 下列类的父类:
- SimpleTimeZone
TimeZone 描述了时区的偏移量且处理夏时制。
典型地,通过使用 getDefault 方法获取 TimeZone ,这个方法创建基于程序运行的时区的 TimeZone 。例如,对一个在日本运行的程序,getDefault 创建了一个基于日本标准时间的 TimeZone 对象。
也可使用 getTimeZone 获取一个带有时区 ID 的 TimeZone 。例如,太平洋标准时区的时区 ID 是 "PST"。因此,可用下列代码获取一个 PST TimeZone 对象:
TimeZone tz = TimeZone.getTimeZone("PST");
可使用 getAvailableIDs 方法来迭代所有提供的时区 ID。然后选择一个支持的 ID 来获需想要的 TimeZone。
- 参见:
- Calendar, GregorianCalendar, SimpleTimeZone
构造子索引
- TimeZone()
-
方法索引
- clone()
- 覆盖 Cloneable
- getAvailableIDs()
- 获取所有可用的支持的 ID 。
- getAvailableIDs(int)
- 根据给定的时区偏移量获取可用的 ID 。
- getDefault()
- 为该主机获取缺省的 TimeZone 。
- getID()
- 获取该时区的 ID 。
- getOffset(int, int, int, int, int, int)
- 更改为夏时制时,为当前日期获取时区偏移量。
- getRawOffset()
- 获取在使用夏时制时未改变的偏移量。
- getTimeZone(String)
- 为给定的 ID 获取 TimeZone 。
- inDaylightTime(Date)
- 查询在该时区的给定日期是否使是夏令时。
- setDefault(TimeZone)
- 用给定的 TimeZone 设置时区。
- setID(String)
- 设置时区 ID 。
- setRawOffset(int)
- 设置相对于 GMT 的基准时区偏移量。
- useDaylightTime()
- 查询该时区是否使用夏令时。
构造子
TimeZone
public TimeZone()
方法
getOffset
public abstract int getOffset(int era,
int year,
int month,
int day,
int dayOfWeek,
int milliseconds)
- 在使用夏时制时,为当前日期获取时区偏移量。这是添加 *到* UTC 的用来获取当地时间的偏移量。
- 参数:
- era - 给定日期的年代。
- year - 在给定日期中的年。
- month - 在给定日期中的月。
月份是基于零的。 例如,0 代表 January。
- day - 给定日期中的月-日。
- dayOfWeek - 给定日期中的星期-日。
- milliseconds - 标准的 当地时间的白天的秒数。
- 返回值:
- 用于获取当地时间的添加*到* GMT 中的偏移量。
setRawOffset
public abstract void setRawOffset(int offsetMillis)
- 为 GMT 设置基准时区偏移量。
这是添加 *到* UTC 的用来获取当地时间的偏移量。
- 参数:
- offsetMillis - 给定的相对于基准时区的偏移量。
getRawOffset
public abstract int getRawOffset()
- 获取在使用夏时制时未改变的偏移量。
这是添加 *到* UTC 的用来获取当地时间的偏移量。
- 返回值:
- 这是添加 *到* UTC 的用来获取当地时间的未改变偏移量。
getID
public String getID()
- 获取该时区的 ID 。
- 返回值:
- 该时区的 ID 。
setID
public void setID(String ID)
- 设置时区 ID 。这不改变在该时区对象中的任何数据。
- 参数:
- ID - 新时区 ID。
useDaylightTime
public abstract boolean useDaylightTime()
- 查询该时区是否使用夏令时。
- 返回值:
- 如果该时区使用夏时制,返回 true ;反之返回 false。
inDaylightTime
public abstract boolean inDaylightTime(Date date)
- 查询在该时区的给定日期是否使是夏令时。
- 参数:
- date - 给定的 Date。
- 返回值:
- 如果给定的日期是夏令时时间,返回 true ;否则返回 false 。
getTimeZone
public static synchronized TimeZone getTimeZone(String ID)
- 为给定的 ID 获取 TimeZone 。
- 参数:
- ID - 给定的 ID。
- 返回值:
- 一个 TimeZone 或如果给定 ID 不认可,返回 null 。
getAvailableIDs
public static synchronized String[] getAvailableIDs(int rawOffset)
- 根据给定的时区偏移量获取可用的 ID 。
- 参数:
- rawOffset - 给定时区的 GMT 偏移量。
- 返回值:
- 一个 ID 数组, 该 ID 的时区有指定的 GMT 偏移量。例如,"America/Phoenix" 和 "America/Denver"
都有 GMT-07:00, 但是在夏时制中,这个时间会不同。
getAvailableIDs
public static synchronized String[] getAvailableIDs()
- 获取所有可用的支持的 ID 。
- 返回值:
- ID 数组。
getDefault
public static synchronized TimeZone getDefault()
- 为该主机获取缺省的 TimeZone 。
- 返回值:
- 缺省的 TimeZone 。
setDefault
public static synchronized void setDefault(TimeZone zone)
- 用给定的 TimeZone 设置时区。
- 参数:
- zone - 给定的 TimeZone 。
clone
public Object clone()
- 覆盖 Cloneable
- 覆盖:
- 类 Object 中的 clone