类 java.util.SimpleTimeZone

java.lang.Object
   |
   +----java.util.TimeZone
           |
           +----java.util.SimpleTimeZone

public class SimpleTimeZone

extends TimeZone

SimpleTimeZone 是 TimeZone 的一个具体的子类，它为使用 Gregorian 日历的用户描述了一个时区。该类不处理历史上的变更。

对 dayOfWeekInMonth 使用负值指示 SimpleTimeZone 应从月的结尾向后数。例如，夏时制时间以标准时间的十月的最后一个星期天 (dayOfWeekInMoth = -1)，凌晨两点做为结束时间。

参见：

Calendar, GregorianCalendar, TimeZone

构造子索引

SimpleTimeZone(int, String)

用给定的相对于 GMT 的基准时区偏移量构造一个 SimpleTimeZone 和时区 ID。

SimpleTimeZone(int, String, int, int, int, int, int, int, int, int)

用给定的相对于 GMT 的基准时区偏移量构造一个 SimpleTimeZone 、时区 ID、白天开始时间和白天结束时间。

方法索引

clone()

覆盖 Cloneable

equals(Object)

比较两个 SimpleTimeZone 对象是否相等。

getOffset(int, int, int, int, int, int)

使用夏时制时，覆盖 TimeZone 为当前日期获取偏移量。

getRawOffset()

覆盖 TimeZone 为这个时区获取 GMT 偏移量。

hashCode()

覆盖 hashCode。

inDaylightTime(Date)

覆盖 TimeZone 查询给定日期是否是夏令时。

setEndRule(int, int, int, int)

设置夏时制的结束规则。

setRawOffset(int)

覆盖 TimeZone 设置相对于 GMT 的基准时区偏移量。

setStartRule(int, int, int, int)

设置夏令时的开始规则。

setStartYear(int)

设置夏令时的开始年份。

toString()

返回该时区的字符串表示。

useDaylightTime()

覆盖 TimeZone 查询该时区是否使用夏时制。

构造子

 public SimpleTimeZone(int rawOffset,
                       String ID)

用给定的相对于 GMT 的基准时区偏移量构造一个 SimpleTimeZone 和时区 ID。 Timezone IDs 可从 TimeZone.getAvailableIDs 获得。通常应使用 TimeZone.getDefault 来构造一个 TimeZone 。

参数：

rawOffset - 给定的相对于 GMT 的基准时区的偏移量。

ID - 用 TimeZone.getAvailableIDs 获得的时区 ID。

 public SimpleTimeZone(int rawOffset,
                       String ID,
                       int startMonth,
                       int startDay,
                       int startDayOfWeek,
                       int startTime,
                       int endMonth,
                       int endDay,
                       int endDayOfWeek,
                       int endTime)

用给定的相对于 GMT 的基准时区偏移量构造一个 SimpleTimeZone、时区 ID、白天开始时间和白天结束时间。 Timezone IDs 可从 TimeZone.getAvailableIDs 获得。 通常应使用 TimeZone.getDefault 来创建一个 TimeZone。对不使用夏时制的时区，不使用该构造子；而是使用 SimpleTimeZone(rawOffset, ID)。 缺省时，该构造子指定月-星期-日规则。那就是，如果 startDay 是 1, 且 startDayOfWeek 是 SUNDAY, 那么这就指示了 startMonth 中的第一个星期天。反之，startDay -1 指示最后一个星期天。但是，通过对一定的参数使用负值或零，可指定其它类型的规则。月-日规则。为了指定某月的确切天，例如 March 1, 把 startDayOfWeek 设置为零。月后-星期-日规则。为了指定在某月的确切的一天或其后的某个星期的第一天，使星期值为负。例如，如果 startDay 是 5 且 startDayOfWeek 是 -MONDAY, 这指示了在 startMonth 的第五天或其后的第一个星期一。 月前-星期-日规则。为了指定在月的确切某一天或之前的某个星期的最后一天，使星期和月的值为负。例如，如果 startDay 是 -21 且 startDayOfWeek 是 -WEDNESDAY, 这指示了在 startMoth 的第二十一天或之前的最后一个星期三。上面的例子引用了 startMonth、startDay 和 startDayOfWeek；同样适用于 endMonth、endDay 和 endDayOfWeek。

参数：

rawOffset - 给定的相对于 GMT 基准时区的偏移量。

ID - 用 TimeZone.getAvailableIDs 获得的时区 ID。

startMonth - 夏令时开始的月份。月份是基于零的。 例如，0 代表 January。

startDay - 夏令时开始的月-星期-日。请参见成员描述中的例子。

startDayOfWeek - 夏令时开始的星期-日。请参见成员描述中的例子。

startTime - 夏令时的开始时间。请参见成员描述中的例子。

endMonth - 夏令时结束的月份。月份是基于零的。 例如，0 代表 January。

endDay - 夏令时结束的月-星期-日。请参见成员描述中的例子。

endDayOfWeek - 夏令时结束的星期-日。 请参见成员描述中的例子。

endTime - 夏令时的结束时间。请参见成员描述中的例子。

方法

 public void setStartYear(int year)

设置夏令时的开始年份。

参数：

year - 夏令时的开始年份。

 public void setStartRule(int month,
                          int dayOfWeekInMonth,
                          int dayOfWeek,
                          int time)

设置夏时制的开始规则。例如，夏令时开始于标准时间的四月的第一个星期天，凌晨两点钟。因此，可通过调用下面的方法设置开始规则：setStartRule(TimeFields.APRIL, 1, TimeFields.SUNDAY, 2*60*60*1000);

参数：

month - 夏令时开始的月份。月份是基于零的。 例如，0 代表 January。

dayOfWeekInMonth - 夏令时开始的月-星期-日。请参见成员描述中的例子。

dayOfWeek - 夏令时开始的星期-日。请参见成员描述中的例子。

time - 夏令时的开始时间。请参见成员描述中的例子。

 public void setEndRule(int month,
                        int dayOfWeekInMonth,
                        int dayOfWeek,
                        int time)

设置夏时制的结束规则。例如，夏时制结束于标准时间的十月的最后一个(-1)星期天，凌晨两点钟。因此，可通过调用下面的方法设置结束规则： setEndRule(TimeFields.OCTOBER, -1, TimeFields.SUNDAY, 2*60*60*1000);

参数：

month - 夏令时结束的月份。 月份是基于零的。 例如，0 代表 January。

dayOfWeekInMonth - 夏令时结束的月-星期-日。 请参见成员描述中的例子。

dayOfWeek - 夏令时结束的星期-日。 参见例程的成员描述。

time - 夏令时结束的 time。 请参见例子的成员描述。

 public int getOffset(int era,
                      int year,
             int month,
                      int day,
                      int dayOfWeek,
                      int millis)

在使用夏时制时，覆盖 TimeZone 为当前日期获取偏移量。这是添加 *到* UTC 的用来获取当地时间的偏移量。更改为夏时制时，为当前日期获取时区偏移量。这是添加 *到* UTC 的用来获取当地时间的偏移量。 假设开始和结束的月份不同且规则不参考二月的结尾星期数(例如，二月的最后一个星期天)。

参数：

era - 给定日期的年代。

year - 在给定日期中的年。

month - 在给定日期中的月。月份是基于零的。 例如，0 代表 January。

day - 给定日期中的月-日。

dayOfWeek - 给定日期中的星期-日。

milliseconds - 在 标准的 当地时间的天中的秒数。

返回值：

为获取当地时间而添加*到* GMT 的偏移量。

覆盖：

类 TimeZone 中的 getOffset

 public int getRawOffset()

覆盖 TimeZone 为该时区获取 GMT 偏移量。

覆盖：

类 TimeZone 中的 getRawOffset

 public void setRawOffset(int offsetMillis)

覆盖 TimeZone 设置相对于 GMT 的基准时区偏移量。 这是添加 *到* UTC 的用来获取当地时间的偏移量。 请参见 TimeZone.setRawOffset 来获取关于参数的描述。

覆盖：

类 TimeZone 中的 setRawOffset

 public boolean useDaylightTime()

覆盖 TimeZone 查询该时区是否使用夏时制。

覆盖：

类 TimeZone 中的 useDaylightTime

 public boolean inDaylightTime(Date date)

覆盖 TimeZone 查询该时区是否使用夏时制。

覆盖：

类 TimeZone 中的 inDaylightTime

 public Object clone()

覆盖 Cloneable

覆盖：

类 TimeZone 中的 clone

 public synchronized int hashCode()

覆盖 hashCode。 为 SimpleDateFormat 对象生成散列码。

覆盖：

类 Object 中的 hashCode

 public boolean equals(Object obj)

比较两个 SimpleTimeZone 对象是否相等。

参数：

obj - 与该对象比较的 SimpleTimeZone 。

返回值：

如果给定的 obj 与该 SimpleTimeZone 对象相同则返回 true；否则返回 false。

覆盖：

类 Object 中的 equals

 public String toString()

返回该时区的字符串表示。

返回值：

该时区的字符串表示。

覆盖：

类 Object 中的 toString