SimpleTimeZone 類別
定義
重要
部分資訊涉及發行前產品，在發行之前可能會有大幅修改。 Microsoft 對此處提供的資訊，不做任何明確或隱含的瑕疵擔保。
SimpleTimeZone 是 的 TimeZone 一個具體子類，代表一個時區，供格里曆使用。
[Android.Runtime.Register("java/util/SimpleTimeZone", DoNotGenerateAcw=true)]
public class SimpleTimeZone : Java.Util.TimeZone[<Android.Runtime.Register("java/util/SimpleTimeZone", DoNotGenerateAcw=true)>]
type SimpleTimeZone = class
inherit TimeZone- 繼承
- 屬性
備註
SimpleTimeZone 是 的 TimeZone 一個具體子類，代表一個時區，供格里曆使用。 該課程採用GMT的偏移量，稱為 <原始>偏移</em>，並制定夏令時間的起結規則。 由於每個方法僅持有單一值，無法處理 GMT 與夏令時間排程之間的歷史偏移變化，但可 #setStartYear setStartYear 指定夏令時間排程生效的年份。
要構建 SimpleTimeZone 帶有夏令時間的時間表，可以用一組規則來描述，例如 <em>start-rule</em> 和 <em>結束規則</em>。 夏令時間開始或結束的日期由 em<月份/em>、<em>< 月曜日/em> 以及 <em>星期</em> 的數值組合<來>指定。 em 月份/em< 值以日曆>欄位值表示，例如 <。>Calendar#MONTH MONTHCalendar#MARCH
<em>的星期</星期/em> 值以日曆Calendar#DAY_OF_WEEK DAY_OF_WEEK值表示，例如 Calendar#SUNDAY SUNDAY。 數值組合的意義如下。
<ul>li b 精確的月份<日期/b><br> 要指定確切的月份日期，請將 em<month></em >< 和 em>day-of-month</em> 設<為精確值，並將 >em<day-of-week>/em< 設為零。><> 例如，要指定 3 月 1 日，將 em<月份>/em< 設>為 Calendar#MARCH MARCH，<><>em 日/月 em 為 1，em <>day-of-week</em> 設為 0。</李>
<li><b 星期幾在月>之日或之後/b<br>< 若要指定某個星期幾在某個月份的日期前後，請將 em>month</em> 設<為精確的月份值，><em day-of-month>/em< 設為該規則應用的當天或之後，em>< day-of-week>/em< 設為負>欄位Calendar#DAY_OF_WEEK DAY_OF_WEEK值。 例如，要指定四月的第二個星期日，將 em month/em< 設>為 <，em 為 day-of-month>/emCalendar#APRIL APRIL 為<> 8，em<> day-of-week</em> 為< 。>-Calendar#SUNDAY SUNDAY</李>
<li><b 月 日期>或之前<的星期幾 / b><br> 若要指定月份某天的確切日期，請將 <em>設為負值，分別為 day-of-month</em> 和 <em>day-of-week</em> 。 例如，要指定3月21日或之前的最後一個星期三，將em month/em<>設<為，>Calendar#MARCH MARCHem day-of-month</em> 是 -21，em<> day-of-week</em> 為。<>-Calendar#WEDNESDAY WEDNESDAY
</李>
<li><b>每月最後一週</b><br> 為了指定每月最後一週，將 em<day-of-week>/em< 設>為 a，em Calendar#DAY_OF_WEEK DAY_OF_WEEK<> day-of-month</em> 設為 -1。 例如，要指定十月的最後一個星期日，將 em month/em< 設>為 <， em day-of-week>/emCalendar#OCTOBER OCTOBER< 為 ，><em >Calendar#SUNDAY SUNDAYday-of-month</em> 設為 -1。<>
</李>
</ul> 夏令時間開始或結束的時間由一天中的毫秒數值決定。 有三種 em 模式/em<s 來指定時間：>、和 <>。#WALL_TIME#STANDARD_TIME#UTC_TIME 例如，如果夏令時間在牆鐘時間中於凌晨2點結束，則可在模式下 #WALL_TIME 指定為7200000毫秒。 在這種情況下，EM<終點規則>/EM< 的>牆上時鐘時間和日照時間的意義是一樣的。
以下是建構時區物件的參數範例。
<code>
// 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)
</code>
這些參數規則同樣適用於集合規則方法，例如 setStartRule。
在 1.1 版本中加入。
Java 文件 java.util.SimpleTimeZone。
本頁部分內容為基於 Open Source Project 所創建與分享的作品，並依授權條款所描述的使用進行修改。
建構函式
| 名稱 | Description |
|---|---|
| SimpleTimeZone(Int32, String, Int32, Int32, Int32, Int32, Int32, Int32, Int32, Int32, Int32, Int32, Int32) |
建立一個 SimpleTimeZone，基準時區與 GMT、時區 ID，以及日光時間開始與結束的規則。 |
| SimpleTimeZone(Int32, String, Int32, Int32, Int32, Int32, Int32, Int32, Int32, Int32, Int32) |
建立一個 SimpleTimeZone，基準時區與 GMT、時區 ID，以及日光時間開始與結束的規則。 |
| SimpleTimeZone(Int32, String, Int32, Int32, Int32, Int32, Int32, Int32, Int32, Int32) |
建立一個 SimpleTimeZone，基準時區與 GMT、時區 ID，以及日光時間開始與結束的規則。 |
| SimpleTimeZone(Int32, String) |
建立一個 SimpleTimeZone，基準時區與 GMT 及時區 ID 錯置，且無夏令時間排程。 |
| SimpleTimeZone(IntPtr, JniHandleOwnership) |
用於建立 JNI 物件受管理表示的建構器;由執行時呼叫。 |
欄位
| 名稱 | Description |
|---|---|
| Long |
已淘汰.
用來表示長名稱的風格指定符 |
| Short |
已淘汰.
一個用來 |
| StandardTime |
已淘汰.
對於標準時間指定的開始或結束時間模式，為常數。 |
| UtcTime |
已淘汰.
對於以UTC表示的開始或結束模式為常數。 |
| WallTime |
已淘汰.
對於以壁鐘時間表示的開始或結束時間模式為常數。 |
屬性
| 名稱 | Description |
|---|---|
| Class |
回傳此 |
| DisplayName |
回傳一個適合在預設區域呈現給使用者的長標準時間名稱 |
| DSTSavings |
將加入的時間回傳到當地標準時間，以取得當地壁鐘時間。 (繼承來源 TimeZone) |
| Handle |
底層 Android 實例的帳號。 (繼承來源 Object) |
| ID |
能拿到這個時區的ID。 -或者- 設定時區ID。 (繼承來源 TimeZone) |
| JniIdentityHashCode |
取得由互通執行時指派給此 Java 對等端的身份雜湊碼。 (繼承來源 Object) |
| JniManagedPeerState |
|
| JniPeerMembers |
|
| PeerReference |
取得這個 Java 節點的 JNI 物件參考。 (繼承來源 Object) |
| RawOffset |
這樣可以讓這個時區的 GMT 有偏移。 |
| ThresholdClass |
此 API 支援 Mono for Android 基礎架構，並非直接從你的程式碼中使用。 |
| ThresholdType |
此 API 支援 Mono for Android 基礎架構，並非直接從你的程式碼中使用。 |
方法
| 名稱 | Description |
|---|---|
| Clone() |
建立一份這個的複製品 |
| Construct(JniObjectReference, JniObjectReferenceOptions) |
|
| Dispose() |
釋放該 Java 節點所持有的資源。 (繼承來源 Object) |
| Dispose(Boolean) |
釋放該 Java 節點所持有的資源。 (繼承來源 Object) |
| DisposeUnlessReferenced() |
|
| Equals(Object) |
|
| Equals(Object) |
表示是否有其他物體「等同」於此物。 (繼承來源 Object) |
| GetDisplayName(Boolean, TimeZoneStyle, Locale) |
回傳 |
| GetDisplayName(Boolean, TimeZoneStyle) |
回傳 |
| GetDisplayName(Locale) |
回傳一個適合在指定 |
| GetHashCode() |
回傳物件的雜湊碼值。 (繼承來源 Object) |
| GetOffset(Int32, Int32, Int32, Int32, Int32, Int32) |
回傳當地時間與UTC之間的毫秒差值，並考慮原始偏移量及夏令時間的影響，適用於指定日期與時間。 |
| GetOffset(Int64) |
回傳該時區在指定日期從UTC的偏移量。 (繼承來源 TimeZone) |
| HasSameRules(TimeZone) |
如果該區域與另一個區域有相同的規則和偏移，則返回為真。 (繼承來源 TimeZone) |
| InDaylightTime(Date) |
詢問該日期是否在夏令時間內。 |
| JavaFinalize() |
已淘汰.
當垃圾回收判定該物件不再有相關參考時，由垃圾回收器呼叫。 (繼承來源 Object) |
| Notify() |
喚醒一個正在該物件監視器上等待的執行緒。 (繼承來源 Object) |
| NotifyAll() |
喚醒所有等待該物件監視器的執行緒。 (繼承來源 Object) |
| ObservesDaylightTime() |
|
| SetDSTSavings(Int32) |
設定夏令時間內時鐘提前的時間（以毫秒計）。 |
| SetEndRule(Int32, Int32, Int32, Int32, Boolean) |
將夏令時間結束規則設定為指定日期前後的一個平日，且不限於一個月內。 |
| SetEndRule(Int32, Int32, Int32, Int32) |
訂下夏令時間結束規則。 |
| SetEndRule(Int32, Int32, Int32) |
將夏令時間結束規則設定為一個月內的固定日期。 |
| SetHandle(IntPtr, JniHandleOwnership) |
設定 Handle 屬性。 (繼承來源 Object) |
| SetPeerReference(JniObjectReference, JniObjectReferenceOptions) |
|
| SetStartRule(Int32, Int32, Int32, Int32, Boolean) |
將夏令時間開始規則設定為指定日期前或晚於一個月內的平日，例如。 |
| SetStartRule(Int32, Int32, Int32, Int32) |
設定夏令時間開始規則。 |
| SetStartRule(Int32, Int32, Int32) |
將夏令時間開始規則設定為一個月內的固定日期。 |
| SetStartYear(Int32) |
設定夏令時間的起始年份。 |
| ToArray<T>() |
從這個 Java 陣列包裝器建立一個受管理陣列。 (繼承來源 Object) |
| ToString() |
回傳物件的字串表示。 (繼承來源 Object) |
| ToZoneId() |
將此 |
| UnregisterFromRuntime() |
將此 Java 節點從互通執行時中取消註冊。 (繼承來源 Object) |
| UseDaylightTime() |
查詢這個時區是否使用夏令時間。 |
| Wait() |
導致目前執行緒等待被喚醒，通常是透過 <em>通知</><em 或 em>中斷</em> 來喚醒。 (繼承來源 Object) |
| Wait(Int64, Int32) |
會讓目前執行緒等待喚醒，通常是透過 <em>通知</><em 或 em>中斷</em>，或是經過一定的真實時間。 (繼承來源 Object) |
| Wait(Int64) |
會讓目前執行緒等待喚醒，通常是透過 <em>通知</><em 或 em>中斷</em>，或是經過一定的真實時間。 (繼承來源 Object) |
明確介面實作
| 名稱 | Description |
|---|---|
| IJavaPeerable.Disposed() |
|
| IJavaPeerable.Finalized() |
|
| IJavaPeerable.JniObjectReferenceControlBlock |
|
| IJavaPeerable.SetJniIdentityHashCode(Int32) |
|
| IJavaPeerable.SetJniManagedPeerState(JniManagedPeerStates) |
|
| IJavaPeerable.SetPeerReference(JniObjectReference) |
|
| IJavaPeerable.UnregisterFromRuntime() |
|
擴充方法
| 名稱 | Description |
|---|---|
| GetJniTypeName(IJavaPeerable) |
取得實例 |
| JavaAs<TResult>(IJavaPeerable) |
試著強制 |
| JavaCast<TResult>(IJavaObject) |
執行 Android 執行時檢查型別轉換。 |
| JavaCast<TResult>(IJavaObject) |
|
| TryJavaCast<TResult>(IJavaPeerable, TResult) |
試著強制 |