鴻蒙OS SimpleTimeZone

SimpleTimeZone

java.lang.Object

|---java.util.TimeZone

|---|---java.util.SimpleTimeZone

public class SimpleTimeZone
extends TimeZone

SimpleTimeZone 是 TimeZone 的具體子類(lèi)，表示用于公歷的時(shí)區(qū)。 該類(lèi)保存與 GMT 的偏移量，稱(chēng)為原始偏移量，以及夏令時(shí)時(shí)間表的開(kāi)始和結(jié)束規(guī)則。 由于它只為每個(gè)值保存單個(gè)值，因此它無(wú)法處理與 GMT 和夏令時(shí)計(jì)劃的偏移量的歷史變化，除了 setStartYear 方法可以指定夏令時(shí)計(jì)劃開(kāi)始生效的年份。

要構(gòu)建具有夏令時(shí)時(shí)間表的 SimpleTimeZone，可以使用一組規(guī)則來(lái)描述時(shí)間表，即開(kāi)始規(guī)則和結(jié)束規(guī)則。 夏令時(shí)開(kāi)始或結(jié)束的日期由月份、月份和星期幾值的組合指定。 月份值由 Calendar Calendar#MONTH 字段值表示，例如 Calendar#MARCH。 星期幾值由 Calendar Calendar#DAY_OF_WEEK 值表示，例如 Calendar#SUNDAY。 值組合的含義如下。

• 準(zhǔn)確的月份日期 要指定準(zhǔn)確的月份日期，請(qǐng)將月份和月份日期設(shè)置為準(zhǔn)確值，并將星期幾設(shè)置為零。 例如，要指定 3 月 1 日，請(qǐng)將月份設(shè)置為 Calendar#MARCH，將 day-of-month 設(shè)置為 1，將 day-of-week 設(shè)置為 0。
• 星期幾在一個(gè)月的某一天或之后要指定星期幾在一個(gè)月的某一天或之后，請(qǐng)將月份設(shè)置為精確的月份值，將月份設(shè)置為應(yīng)用規(guī)則的當(dāng)天或之后的日期， 和星期幾到一個(gè)負(fù)的 Calendar#DAY_OF_WEEK 字段值。 例如，要指定四月的第二個(gè)星期日，請(qǐng)將月份設(shè)置為 Calendar#APRIL，將日期設(shè)置為 8，將星期幾設(shè)置為 -Calendar#SUNDAY。
• 星期幾在一個(gè)月的某一天或之前 要指定一周中的某一天在一個(gè)月的某一天或之前，請(qǐng)將 day-of-month 和 day-of-week 設(shè)置為負(fù)值。 例如，要指定 3 月 21 日或之前的最后一個(gè)星期三，請(qǐng)將月份設(shè)置為 Calendar#MARCH，日期為 -21，星期幾為 -Calendar#WEDNESDAY。
• 一個(gè)月的最后一周要指定一個(gè)月的最后一周，請(qǐng)將 day-of-week 設(shè)置為 Calendar#DAY_OF_WEEK 值，并將 day-of-month 設(shè)置為 -1。 例如，要指定 10 月的最后一個(gè)星期日，請(qǐng)將月份設(shè)置為 Calendar#OCTOBER，將星期幾設(shè)置為 Calendar#SUNDAY，并將日期設(shè)置為 -1。

夏令時(shí)開(kāi)始或結(jié)束的時(shí)間由一天中的毫秒值指定。 有三種指定時(shí)間的模式：WALL_TIME、STANDARD_TIME 和 UTC_TIME。 例如，如果夏令時(shí)在掛鐘時(shí)間的凌晨 2:00 結(jié)束，則可以在 WALL_TIME 模式下指定為 7200000 毫秒。 在這種情況下，結(jié)束規(guī)則的掛鐘時(shí)間與白天時(shí)間的含義相同。

以下是構(gòu)造時(shí)區(qū)對(duì)象的參數(shù)示例。

      // Base GMT offset: -8:00
      // DST starts:      at 2:00am in standard time
      //                  on the first Sunday in April
      // DST ends:        at 2:00am in daylight time
      //                  on the last Sunday in October
      // Save:            1 hour
      SimpleTimeZone(-28800000,
                     "America/Los_Angeles",
                     Calendar.APRIL, 1, -Calendar.SUNDAY,
                     7200000,
                     Calendar.OCTOBER, -1, Calendar.SUNDAY,
                     7200000,
                     3600000)


      // Base GMT offset: +1:00
      // DST starts:      at 1:00am in UTC time
      //                  on the last Sunday in March
      // DST ends:        at 1:00am in UTC time
      //                  on the last Sunday in October
      // Save:            1 hour
      SimpleTimeZone(3600000,
                     "Europe/Paris",
                     Calendar.MARCH, -1, Calendar.SUNDAY,
                     3600000, SimpleTimeZone.UTC_TIME,
                     Calendar.OCTOBER, -1, Calendar.SUNDAY,
                     3600000, SimpleTimeZone.UTC_TIME,
                     3600000)

這些參數(shù)規(guī)則同樣適用于設(shè)置規(guī)則方法，例如setStartRule。

字段摘要

修飾符和類(lèi)型	字段	描述
static int	STANDARD_TIME	指定為標(biāo)準(zhǔn)時(shí)間的開(kāi)始或結(jié)束時(shí)間模式的常數(shù)。
static int	UTC_TIME	指定為 UTC 的開(kāi)始或結(jié)束時(shí)間模式的常量。
static int	WALL_TIME	指定為掛鐘時(shí)間的開(kāi)始或結(jié)束時(shí)間模式的常量。

從類(lèi) java.util.TimeZone 繼承的字段
LONG, SHORT

構(gòu)造函數(shù)摘要

構(gòu)造函數(shù)	描述
SimpleTimeZone(int rawOffset, String ID)	構(gòu)造一個(gè) SimpleTimeZone，它具有與 GMT 的給定基本時(shí)區(qū)偏移量和時(shí)區(qū) ID，沒(méi)有夏令時(shí)時(shí)間表。
SimpleTimeZone(int rawOffset, String ID, int startMonth, int startDay, int startDayOfWeek, int startTime, int endMonth, int endDay, int endDayOfWeek, int endTime)	構(gòu)造一個(gè) SimpleTimeZone，它具有與 GMT 的給定基本時(shí)區(qū)偏移量、時(shí)區(qū) ID 以及用于開(kāi)始和結(jié)束夏令時(shí)的規(guī)則。
SimpleTimeZone(int rawOffset, String ID, int startMonth, int startDay, int startDayOfWeek, int startTime, int endMonth, int endDay, int endDayOfWeek, int endTime, int dstSavings)	構(gòu)造一個(gè) SimpleTimeZone，它具有與 GMT 的給定基本時(shí)區(qū)偏移量、時(shí)區(qū) ID 以及用于開(kāi)始和結(jié)束夏令時(shí)的規(guī)則。
SimpleTimeZone(int rawOffset, String ID, int startMonth, int startDay, int startDayOfWeek, int startTime, int startTimeMode, int endMonth, int endDay, int endDayOfWeek, int endTime, int endTimeMode, int dstSavings)	構(gòu)造一個(gè) SimpleTimeZone，它具有與 GMT 的給定基本時(shí)區(qū)偏移量、時(shí)區(qū) ID 以及用于開(kāi)始和結(jié)束夏令時(shí)的規(guī)則。

方法總結(jié)

修飾符和類(lèi)型	方法	描述
Object	clone()	返回此 SimpleTimeZone 實(shí)例的克隆。
boolean	equals(Object obj)	比較兩個(gè) SimpleTimeZone 對(duì)象的相等性。
int	getDSTSavings()	返回在夏令時(shí)期間時(shí)鐘提前的時(shí)間量（以毫秒為單位）。
int	getOffset(int era, int year, int month, int day, int dayOfWeek, int millis)	返回指定日期和時(shí)間的本地時(shí)間和 UTC 之間的毫秒差，同時(shí)考慮原始偏移和夏令時(shí)的影響。
int	getOffset(long date)	在給定時(shí)間返回此時(shí)區(qū)與 UTC 的偏移量。
int	getRawOffset()	獲取此時(shí)區(qū)的 GMT 偏移量。
int	hashCode()	為 SimpleDateFormat 對(duì)象生成哈希碼。
boolean	hasSameRules(TimeZone other)	如果此區(qū)域與另一個(gè)區(qū)域具有相同的規(guī)則和偏移量，則返回 true。
boolean	inDaylightTime(Date date)	查詢(xún)給定日期是否處于夏令時(shí)。
boolean	observesDaylightTime()	如果此 SimpleTimeZone 遵守夏令時(shí)，則返回 true。
void	setDSTSavings(int millisSavedDuringDST)	設(shè)置時(shí)鐘在夏令時(shí)提前的時(shí)間量（以毫秒為單位）。
void	setEndRule(int endMonth, int endDay, int endTime)	將夏令時(shí)結(jié)束規(guī)則設(shè)置為一個(gè)月內(nèi)的固定日期。
void	setEndRule(int endMonth, int endDay, int endDayOfWeek, int endTime)	設(shè)置夏令時(shí)結(jié)束規(guī)則。
void	setEndRule(int endMonth, int endDay, int endDayOfWeek, int endTime, boolean after)	將夏令時(shí)結(jié)束規(guī)則設(shè)置為一個(gè)月內(nèi)給定日期之前或之后的工作日，例如，第一個(gè)星期一在 8 號(hào)或之后。
void	setRawOffset(int offsetMillis)	將基準(zhǔn)時(shí)區(qū)偏移設(shè)置為 GMT。
void	setStartRule(int startMonth, int startDay, int startTime)	將夏令時(shí)開(kāi)始規(guī)則設(shè)置為一個(gè)月內(nèi)的固定日期。
void	setStartRule(int startMonth, int startDay, int startDayOfWeek, int startTime)	設(shè)置夏令時(shí)開(kāi)始規(guī)則。
void	setStartRule(int startMonth, int startDay, int startDayOfWeek, int startTime, boolean after)	將夏令時(shí)開(kāi)始規(guī)則設(shè)置為一個(gè)月內(nèi)給定日期之前或之后的工作日，例如，第一個(gè)星期一在 8 日或之后。
void	setStartYear(int year)	設(shè)置夏令時(shí)開(kāi)始年份。
String	toString()	返回此時(shí)區(qū)的字符串表示形式。
boolean	useDaylightTime()	查詢(xún)?cè)摃r(shí)區(qū)是否使用夏令時(shí)。

從類(lèi) java.lang.Object 繼承的方法
finalize, getClass, notify, notifyAll, wait, wait, wait

從類(lèi) java.util.TimeZone 繼承的方法
getAvailableIDs, getAvailableIDs, getDefault, getDisplayName, getDisplayName, getDisplayName, getDisplayName, getID, getTimeZone, getTimeZone, setDefault, setID, toZoneId

字段詳細(xì)信息

STANDARD_TIME

public static final int STANDARD_TIME

指定為標(biāo)準(zhǔn)時(shí)間的開(kāi)始或結(jié)束時(shí)間模式的常數(shù)。

UTC_TIME

public static final int UTC_TIME

指定為 UTC 的開(kāi)始或結(jié)束時(shí)間模式的常量。 例如，歐盟規(guī)則被指定為 UTC 時(shí)間。

WALL_TIME

public static final int WALL_TIME

指定為掛鐘時(shí)間的開(kāi)始或結(jié)束時(shí)間模式的常量。 掛鐘時(shí)間是開(kāi)始規(guī)則的標(biāo)準(zhǔn)時(shí)間，而結(jié)束規(guī)則的白天時(shí)間。

構(gòu)造函數(shù)詳細(xì)信息

SimpleTimeZone

public SimpleTimeZone(int rawOffset, String ID)

構(gòu)造一個(gè) SimpleTimeZone，它具有與 GMT 的給定基本時(shí)區(qū)偏移量和時(shí)區(qū) ID，沒(méi)有夏令時(shí)時(shí)間表。

參數(shù)：

參數(shù)名稱(chēng)	參數(shù)描述
rawOffset	與 GMT 的基本時(shí)區(qū)偏移量（以毫秒為單位）。
ID	賦予此實(shí)例的時(shí)區(qū)名稱(chēng)。

SimpleTimeZone

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

構(gòu)造一個(gè) SimpleTimeZone，它具有與 GMT 的給定基本時(shí)區(qū)偏移量、時(shí)區(qū) ID 以及用于開(kāi)始和結(jié)束夏令時(shí)的規(guī)則。 startTime 和 endTime 都被指定為在掛鐘時(shí)間中表示。 夏時(shí)制時(shí)間假定為 3600000 毫秒（即一小時(shí)）。 這個(gè)構(gòu)造函數(shù)等價(jià)于：

     SimpleTimeZone(rawOffset,
                    ID,
                    startMonth,
                    startDay,
                    startDayOfWeek,
                    startTime,
                    SimpleTimeZone.WALL_TIME,
                    endMonth,
                    endDay,
                    endDayOfWeek,
                    endTime,
                    SimpleTimeZone.WALL_TIME,
                    3600000)

參數(shù):

參數(shù)名稱(chēng)	參數(shù)描述
rawOffset	給定的基準(zhǔn)時(shí)區(qū)與 GMT 的偏移量。
ID	賦予此對(duì)象的時(shí)區(qū) ID。
startMonth	夏令時(shí)開(kāi)始月份。 Month 是 Calendar#MONTH 字段值（從 0 開(kāi)始。例如，0 表示一月）。
startDay	夏令時(shí)開(kāi)始的月份中的哪一天。
startDayOfWeek	從星期幾開(kāi)始的夏令時(shí)。
startTime	本地掛鐘時(shí)間（以毫秒為單位）的夏令時(shí)開(kāi)始時(shí)間，在這種情況下為本地標(biāo)準(zhǔn)時(shí)間。
endMonth	夏令時(shí)結(jié)束月份。 Month 是 Calendar#MONTH 字段值（從 0 開(kāi)始。例如，9 表示 10 月）。
endDay	夏令時(shí)結(jié)束的月份中的哪一天。
endDayOfWeek	夏令時(shí)結(jié)束的星期幾。
endTime	以本地掛鐘時(shí)間表示的夏令時(shí)結(jié)束時(shí)間（以一天中的毫秒為單位），在這種情況下為本地夏令時(shí)。

Throws:

Throw名稱(chēng)	Throw描述
IllegalArgumentException	如果月份、日期、星期幾或時(shí)間參數(shù)超出了開(kāi)始或結(jié)束規(guī)則的范圍

SimpleTimeZone

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

構(gòu)造一個(gè) SimpleTimeZone，它具有與 GMT 的給定基本時(shí)區(qū)偏移量、時(shí)區(qū) ID 以及用于開(kāi)始和結(jié)束夏令時(shí)的規(guī)則。 假定 startTime 和 endTime 都以掛鐘時(shí)間表示。 這個(gè)構(gòu)造函數(shù)等價(jià)于：

     SimpleTimeZone(rawOffset,
                    ID,
                    startMonth,
                    startDay,
                    startDayOfWeek,
                    startTime,
                    SimpleTimeZone.WALL_TIME,
                    endMonth,
                    endDay,
                    endDayOfWeek,
                    endTime,
                    SimpleTimeZone.WALL_TIME,
                    dstSavings)

參數(shù):

參數(shù)名稱(chēng)	參數(shù)描述
rawOffset	給定的基準(zhǔn)時(shí)區(qū)與 GMT 的偏移量。
ID	賦予此對(duì)象的時(shí)區(qū) ID。
startMonth	夏令時(shí)開(kāi)始月份。 Month 是 Calendar#MONTH 字段值（從 0 開(kāi)始。例如，0 表示一月）。
startDay	夏令時(shí)開(kāi)始的月份中的哪一天。
startDayOfWeek	從星期幾開(kāi)始的夏令時(shí)。 有關(guān)此參數(shù)的特殊情況，請(qǐng)參見(jiàn)類(lèi)描述。
startTime	本地掛鐘時(shí)間中的夏令時(shí)開(kāi)始時(shí)間，在這種情況下為本地標(biāo)準(zhǔn)時(shí)間。
endMonth	夏令時(shí)結(jié)束月份。 Month 是 Calendar#MONTH 字段值（從 0 開(kāi)始。例如，9 表示 10 月）。
endDay	夏令時(shí)結(jié)束的月份中的哪一天。 有關(guān)此參數(shù)的特殊情況，請(qǐng)參見(jiàn)類(lèi)描述。
endDayOfWeek	夏令時(shí)結(jié)束的星期幾。
endTime	本地掛鐘時(shí)間的夏令時(shí)結(jié)束時(shí)間，在本例中為本地夏令時(shí)。
dstSavings	夏令時(shí)期間節(jié)省的時(shí)間（以毫秒為單位）。

Throws:

Throw名稱(chēng)	Throw描述
IllegalArgumentException	如果月份、日期、星期幾或時(shí)間參數(shù)超出了開(kāi)始或結(jié)束規(guī)則的范圍

SimpleTimeZone

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

構(gòu)造一個(gè) SimpleTimeZone，它具有與 GMT 的給定基本時(shí)區(qū)偏移量、時(shí)區(qū) ID 以及用于開(kāi)始和結(jié)束夏令時(shí)的規(guī)則。 此構(gòu)造函數(shù)采用完整的開(kāi)始和結(jié)束規(guī)則參數(shù)集，包括 startTime 和 endTime 模式。 模式指定掛鐘時(shí)間或標(biāo)準(zhǔn)時(shí)間或 UTC 時(shí)間。

參數(shù)：

參數(shù)名稱(chēng)	參數(shù)描述
rawOffset	給定的基準(zhǔn)時(shí)區(qū)與 GMT 的偏移量。
ID	賦予此對(duì)象的時(shí)區(qū) ID。
startMonth	夏令時(shí)開(kāi)始月份。 Month 是 Calendar#MONTH 字段值（從 0 開(kāi)始。例如，0 表示一月）。
startDay	夏令時(shí)開(kāi)始的月份中的哪一天。
startDayOfWeek	從星期幾開(kāi)始的夏令時(shí)。
startTime	startTimeMode 指定的時(shí)間模式下的夏令時(shí)開(kāi)始時(shí)間。
startTimeMode	startTime 指定的開(kāi)始時(shí)間的模式。
endMonth	夏令時(shí)結(jié)束月份。 Month 是 Calendar#MONTH 字段值（從 0 開(kāi)始。例如，9 表示 10 月）。
endDay	夏令時(shí)結(jié)束的月份中的哪一天。
endDayOfWeek	夏令時(shí)結(jié)束的星期幾。
endTime	endTimeMode 指定的時(shí)間模式下的夏令時(shí)結(jié)束時(shí)間。
endTimeMode	endTime 指定的結(jié)束時(shí)間的模式
dstSavings	夏令時(shí)期間節(jié)省的時(shí)間（以毫秒為單位）。

Throws:

Throw名稱(chēng)	Throw描述
IllegalArgumentException	如果月份、日期、星期幾、更多時(shí)間或時(shí)間參數(shù)超出了開(kāi)始或結(jié)束規(guī)則的范圍，或者時(shí)間模式值無(wú)效。

方法詳情

setStartYear

public void setStartYear(int year)

設(shè)置夏令時(shí)開(kāi)始年份。

參數(shù)：

參數(shù)名稱(chēng)	參數(shù)描述
year	夏令時(shí)開(kāi)始年份。

setStartRule

public void setStartRule(int startMonth, int startDay, int startDayOfWeek, int startTime)

設(shè)置夏令時(shí)開(kāi)始規(guī)則。 例如，如果夏令時(shí)從 4 月的第一個(gè)星期日在本地掛鐘時(shí)間凌晨 2 點(diǎn)開(kāi)始，您可以通過(guò)調(diào)用來(lái)設(shè)置開(kāi)始規(guī)則：

setStartRule(Calendar.APRIL, 1, Calendar.SUNDAY, 2*60*60*1000);

參數(shù):

參數(shù)名稱(chēng)	參數(shù)描述
startMonth	夏令時(shí)開(kāi)始月份。 Month 是 Calendar#MONTH 字段值（從 0 開(kāi)始。例如，0 表示一月）。
startDay	夏令時(shí)開(kāi)始的月份中的哪一天。
startDayOfWeek	從星期幾開(kāi)始的夏令時(shí)。
startTime	本地掛鐘時(shí)間中的夏令時(shí)開(kāi)始時(shí)間，在這種情況下為本地標(biāo)準(zhǔn)時(shí)間。

Throws:

Throw名稱(chēng)	Throw描述
IllegalArgumentException	如果 startMonth、startDay、startDayOfWeek 或 startTime 參數(shù)超出范圍

setStartRule

public void setStartRule(int startMonth, int startDay, int startTime)

將夏令時(shí)開(kāi)始規(guī)則設(shè)置為一個(gè)月內(nèi)的固定日期。 該方法等價(jià)于：

setStartRule(startMonth, startDay, 0, startTime)

參數(shù):

參數(shù)名稱(chēng)	參數(shù)描述
startMonth	夏令時(shí)開(kāi)始月份。 Month 是 Calendar#MONTH 字段值（從 0 開(kāi)始。例如，0 表示一月）。
startDay	夏令時(shí)開(kāi)始的月份中的哪一天。
startTime	本地掛鐘時(shí)間中的夏令時(shí)開(kāi)始時(shí)間，在這種情況下為本地標(biāo)準(zhǔn)時(shí)間。

Throws:

Throw名稱(chēng)	Throw描述
IllegalArgumentException	如果 startMonth、startDayOfMonth 或 startTime 參數(shù)超出范圍

setStartRule

public void setStartRule(int startMonth, int startDay, int startDayOfWeek, int startTime, boolean after)

將夏令時(shí)開(kāi)始規(guī)則設(shè)置為一個(gè)月內(nèi)給定日期之前或之后的工作日，例如，第一個(gè)星期一在 8 日或之后。

參數(shù)：

參數(shù)名稱(chēng)	參數(shù)描述
startMonth	夏令時(shí)開(kāi)始月份。 Month 是 Calendar#MONTH 字段值（從 0 開(kāi)始。例如，0 表示一月）。
startDay	夏令時(shí)開(kāi)始的月份中的哪一天。
startDayOfWeek	從星期幾開(kāi)始的夏令時(shí)。
startTime	本地掛鐘時(shí)間中的夏令時(shí)開(kāi)始時(shí)間，在這種情況下為本地標(biāo)準(zhǔn)時(shí)間。
after	如果為 true，則此規(guī)則選擇 dayOfMonth 或之后的第一天 dayOfWeek。 如果為 false，則此規(guī)則選擇 dayOfMonth 或之前的最后 dayOfWeek。

Throws:

Throw名稱(chēng)	Throw描述
IllegalArgumentException	如果 startMonth、startDay、startDayOfWeek 或 startTime 參數(shù)超出范圍

setEndRule

public void setEndRule(int endMonth, int endDay, int endDayOfWeek, int endTime)

設(shè)置夏令時(shí)結(jié)束規(guī)則。 例如，如果夏令時(shí)在 10 月的最后一個(gè)星期日凌晨 2 點(diǎn)在掛鐘時(shí)間結(jié)束，您可以通過(guò)調(diào)用設(shè)置結(jié)束規(guī)則： setEndRule(Calendar.OCTOBER, -1, Calendar.SUNDAY, 26060*1000);

參數(shù)：

參數(shù)名稱(chēng)	參數(shù)描述
endMonth	夏令時(shí)結(jié)束月份。 Month 是 Calendar#MONTH 字段值（從 0 開(kāi)始。例如，9 表示 10 月）。
endDay	夏令時(shí)結(jié)束的月份中的哪一天。
endDayOfWeek	夏令時(shí)結(jié)束的星期幾。
endTime	以本地掛鐘時(shí)間表示的夏令時(shí)結(jié)束時(shí)間（以一天中的毫秒為單位），在這種情況下為本地夏令時(shí)。

Throws:

Throw名稱(chēng)	Throw描述
IllegalArgumentException	如果 endMonth、endDay、endDayOfWeek 或 endTime 參數(shù)超出范圍

setEndRule

public void setEndRule(int endMonth, int endDay, int endTime)

將夏令時(shí)結(jié)束規(guī)則設(shè)置為一個(gè)月內(nèi)的固定日期。 該方法等價(jià)于：

setEndRule(endMonth, endDay, 0, endTime)

參數(shù):

參數(shù)名稱(chēng)	參數(shù)描述
endMonth	夏令時(shí)結(jié)束月份。 Month 是 Calendar#MONTH 字段值（從 0 開(kāi)始。例如，9 表示 10 月）。
endDay	夏令時(shí)結(jié)束的月份中的哪一天。
endTime	以本地掛鐘時(shí)間表示的夏令時(shí)結(jié)束時(shí)間（以一天中的毫秒為單位），在這種情況下為本地夏令時(shí)。

Throws:

Throw名稱(chēng)	Throw描述
IllegalArgumentException	endMonth、endDay 或 endTime 參數(shù)超出范圍

setEndRule

public void setEndRule(int endMonth, int endDay, int endDayOfWeek, int endTime, boolean after)

將夏令時(shí)結(jié)束規(guī)則設(shè)置為一個(gè)月內(nèi)給定日期之前或之后的工作日，例如，第一個(gè)星期一在 8 號(hào)或之后。

參數(shù)：

參數(shù)名稱(chēng)	參數(shù)描述
endMonth	夏令時(shí)結(jié)束月份。 Month 是 Calendar#MONTH 字段值（從 0 開(kāi)始。例如，9 表示 10 月）。
endDay	夏令時(shí)結(jié)束的月份中的哪一天。
endDayOfWeek	夏令時(shí)結(jié)束的星期幾。
endTime	以本地掛鐘時(shí)間表示的夏令時(shí)結(jié)束時(shí)間（以一天中的毫秒為單位），在這種情況下為本地夏令時(shí)。
after	如果為 true，則此規(guī)則選擇 endDay 或之后的第一個(gè) endDayOfWeek。 如果為 false，則此規(guī)則選擇該月的 endDay 或之前的最后一個(gè) endDayOfWeek。

Throws:

Throw名稱(chēng)	Throw描述
IllegalArgumentException	endMonth、endDay、endDayOfWeek 或 endTime 參數(shù)超出范圍

getOffset

public int getOffset(long date)

在給定時(shí)間返回此時(shí)區(qū)與 UTC 的偏移量。 如果夏令時(shí)在給定時(shí)間有效，則偏移值將根據(jù)夏令時(shí)進(jìn)行調(diào)整。

覆蓋：

類(lèi) TimeZone 中的 getOffset

參數(shù)：

參數(shù)名稱(chēng)	參數(shù)描述
date	找到時(shí)區(qū)偏移的時(shí)間

返回:

添加到 UTC 以獲取本地時(shí)間的時(shí)間量（以毫秒為單位）。

getOffset

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

返回指定日期和時(shí)間的本地時(shí)間和 UTC 之間的毫秒差，同時(shí)考慮原始偏移和夏令時(shí)的影響。 此方法假定開(kāi)始月份和結(jié)束月份是不同的。 它還使用默認(rèn)的 GregorianCalendar 對(duì)象作為其基礎(chǔ)日歷，例如用于確定閏年。 不要將此方法的結(jié)果與默認(rèn) GregorianCalendar 以外的日歷一起使用。

注意：一般情況下，客戶(hù)端應(yīng)該使用 Calendar.get(ZONE_OFFSET) + Calendar.get(DST_OFFSET) 而不是調(diào)用此方法。

指定者：

類(lèi) TimeZone 中的 getOffset

參數(shù)：

參數(shù)名稱(chēng)	參數(shù)描述
era	給定日期的時(shí)代。
year	給定日期的年份。
month	給定日期中的月份。 月份是從 0 開(kāi)始的。 例如，0 表示一月。
day	給定日期的月份中的某一天。
dayOfWeek	給定日期的星期幾。
millis	標(biāo)準(zhǔn)本地時(shí)間中一天中的毫秒數(shù)。

返回:

添加到 UTC 以獲取本地時(shí)間的毫秒數(shù)。

Throws:

Throw名稱(chēng)	Throw描述
IllegalArgumentException	時(shí)代、月、日、dayOfWeek 或 millis 參數(shù)超出范圍

getRawOffset

public int getRawOffset()

獲取此時(shí)區(qū)的 GMT 偏移量。

指定者：

類(lèi) TimeZone 中的 getRawOffset

返回:

以毫秒為單位的 GMT 偏移值

setRawOffset

public void setRawOffset(int offsetMillis)

將基準(zhǔn)時(shí)區(qū)偏移設(shè)置為 GMT。 這是添加到 UTC 以獲取本地時(shí)間的偏移量。

指定者：

類(lèi) TimeZone 中的 setRawOffset

參數(shù)：

參數(shù)名稱(chēng)	參數(shù)描述
offsetMillis	給定的基準(zhǔn)時(shí)區(qū)偏移到 GMT。

setDSTSavings

public void setDSTSavings(int millisSavedDuringDST)

設(shè)置時(shí)鐘在夏令時(shí)提前的時(shí)間量（以毫秒為單位）。

參數(shù)：

參數(shù)名稱(chēng)	參數(shù)描述
millisSavedDuringDST	當(dāng)夏令時(shí)規(guī)則生效時(shí)，時(shí)間相對(duì)于標(biāo)準(zhǔn)時(shí)間提前的毫秒數(shù)。 一個(gè)正數(shù)，通常為一小時(shí) (3600000)。

getDSTSavings

public int getDSTSavings()

返回在夏令時(shí)期間時(shí)鐘提前的時(shí)間量（以毫秒為單位）。

覆蓋：

類(lèi) TimeZone 中的 getDSTSavings

返回:

夏令時(shí)規(guī)則生效時(shí)時(shí)間相對(duì)于標(biāo)準(zhǔn)時(shí)間提前的毫秒數(shù)，如果此時(shí)區(qū)不遵守夏令時(shí)，則為 0（零）。

useDaylightTime

public boolean useDaylightTime()

查詢(xún)?cè)摃r(shí)區(qū)是否使用夏令時(shí)。

指定者：

類(lèi) TimeZone 中的 useDaylightTime

返回:

如果此時(shí)區(qū)使用夏令時(shí)，則為 true； 否則為 false。

observesDaylightTime

public boolean observesDaylightTime()

如果此 SimpleTimeZone 遵守夏令時(shí)，則返回 true。 此方法等效于 useDaylightTime()。

覆蓋：

在 TimeZone 類(lèi)中觀察DaylightTime

返回:

如果此 SimpleTimeZone 遵守夏令時(shí)，則為 true； 否則為 false。

inDaylightTime

public boolean inDaylightTime(Date date)

查詢(xún)給定日期是否處于夏令時(shí)。

指定者：

類(lèi) TimeZone 中的 inDaylightTime

參數(shù)：

參數(shù)名稱(chēng)	參數(shù)描述
date	給定的日期。

返回:

如果夏令時(shí)在給定日期有效，則為 true； 否則為 false。

clone

public Object clone()

返回此 SimpleTimeZone 實(shí)例的克隆。

覆蓋：

在 TimeZone 類(lèi)中克隆

返回:

此實(shí)例的克隆。

hashCode

public int hashCode()

為 SimpleDateFormat 對(duì)象生成哈希碼。

覆蓋：

類(lèi) Object 中的 hashCode

返回:

此對(duì)象的哈希碼

equals

public boolean equals(Object obj)

比較兩個(gè) SimpleTimeZone 對(duì)象的相等性。

覆蓋：

類(lèi) Object 中的等于

參數(shù)：

參數(shù)名稱(chēng)	參數(shù)描述
obj	要與之比較的 SimpleTimeZone 對(duì)象。

返回:

如果給定的 obj 與此 SimpleTimeZone 對(duì)象相同，則為 true； 否則為 false。

hasSameRules

public boolean hasSameRules(TimeZone other)

如果此區(qū)域與另一個(gè)區(qū)域具有相同的規(guī)則和偏移量，則返回 true。

覆蓋：

類(lèi) TimeZone 中的 hasSameRules

參數(shù)：

參數(shù)名稱(chēng)	參數(shù)描述
other	要與之比較的 TimeZone 對(duì)象

返回:

如果給定區(qū)域是 SimpleTimeZone 并且具有與此相同的規(guī)則和偏移量，則為 true

toString

public String toString()

返回此時(shí)區(qū)的字符串表示形式。

覆蓋：

類(lèi) Object 中的 toString

返回:

此時(shí)區(qū)的字符串表示形式。