Calendar.Builder 類別
定義
重要
部分資訊涉及發行前產品，在發行之前可能會有大幅修改。 Microsoft 對此處提供的資訊，不做任何明確或隱含的瑕疵擔保。
Calendar.Builder 用於從各種日期-時間參數建立 a Calendar 。
[Android.Runtime.Register("java/util/Calendar$Builder", ApiSince=26, DoNotGenerateAcw=true)]
public class Calendar.Builder : Java.Lang.Object[<Android.Runtime.Register("java/util/Calendar$Builder", ApiSince=26, DoNotGenerateAcw=true)>]
type Calendar.Builder = class
inherit Object- 繼承
- 屬性
備註
Calendar.Builder 用於從各種日期-時間參數建立 a Calendar 。
有兩種方法可以將 a Calendar 設定為日期-時間值。 一種是將瞬間參數設定為與紀元相差的毫秒。 另一種是將個別場參數（例如 Calendar#YEAR YEAR）設定為其期望值。 這兩種方式不能混在一起。 嘗試同時設定瞬間場和個別欄位會導致 擲出。IllegalStateException 然而，它允許覆蓋先前的即時或場參數值。
若無法提供足夠欄位參數來判定日期和/或時間，則在建立 Calendar。 例如，如果格里曆沒有給出該 Calendar#YEAR YEAR 數值，則會使用1970年。 若欄位參數間有任何衝突，則會依照解析規則進行。 因此，場次設置的順序很重要。
除了日期時間參數外，還可以設定 #setLocale（Locale）地區、#setTimeZone（TimeZone）時區、#setWeekDefinition（int， int） 週定義，以及 #setLenient（布林）寬鬆模式參數。
<b>範例</b>
以下是範例用法。 範例程式碼假設常 Calendar 數是靜態匯入的。
以下代碼產生 Calendar 的日期為2012-12-31（公曆），因為週一是ISO 8601相容週數參數中的第一天。
Calendar cal = new Calendar.Builder().setCalendarType("iso8601")
.setWeekDate(2013, 1, MONDAY).build();
以下代碼產生的日 Calendar 文日期為1989-01-08（公曆），假設預設 Calendar#ERA ERA 為 <從那天開始的平>成</em> 。
Calendar cal = new Calendar.Builder().setCalendarType("japanese")
.setFields(YEAR, 1, DAY_OF_YEAR, 1).build();
新增於1.8版本。
Java 文件 java.util.Calendar.Builder。
本頁部分內容為基於 Open Source Project 所創建與分享的作品，並依授權條款所描述的使用進行修改。
建構函式
| 名稱 | Description |
|---|---|
| Calendar.Builder() |
建構一個 |
| Calendar.Builder(IntPtr, JniHandleOwnership) |
|
屬性
| 名稱 | Description |
|---|---|
| Class |
回傳此 |
| Handle |
底層 Android 實例的帳號。 (繼承來源 Object) |
| JniIdentityHashCode |
取得由互通執行時指派給此 Java 對等端的身份雜湊碼。 (繼承來源 Object) |
| JniManagedPeerState |
|
| JniPeerMembers |
|
| PeerReference |
取得這個 Java 節點的 JNI 物件參考。 (繼承來源 Object) |
| ThresholdClass |
|
| ThresholdType |
|
方法
| 名稱 | Description |
|---|---|
| Build() |
回傳 a |
| Clone() |
建立並回傳此物件的副本。 (繼承來源 Object) |
| Construct(JniObjectReference, JniObjectReferenceOptions) |
|
| Dispose() |
釋放該 Java 節點所持有的資源。 (繼承來源 Object) |
| Dispose(Boolean) |
釋放該 Java 節點所持有的資源。 (繼承來源 Object) |
| DisposeUnlessReferenced() |
|
| Equals(Object) |
|
| Equals(Object) |
表示是否有其他物體「等同」於此物。 (繼承來源 Object) |
| GetHashCode() |
回傳物件的雜湊碼值。 (繼承來源 Object) |
| JavaFinalize() |
已淘汰.
當垃圾回收判定該物件不再有相關參考時，由垃圾回收器呼叫。 (繼承來源 Object) |
| Notify() |
喚醒一個正在該物件監視器上等待的執行緒。 (繼承來源 Object) |
| NotifyAll() |
喚醒所有等待該物件監視器的執行緒。 (繼承來源 Object) |
| Set(CalendarField, Int32) |
|
| SetCalendarType(String) |
|
| SetDate(Int32, Int32, Int32) |
|
| SetFields(Int32[]) |
|
| SetHandle(IntPtr, JniHandleOwnership) |
設定 Handle 屬性。 (繼承來源 Object) |
| SetInstant(Date) |
|
| SetInstant(Int64) |
|
| SetLenient(Boolean) |
|
| SetLocale(Locale) |
|
| SetPeerReference(JniObjectReference, JniObjectReferenceOptions) |
|
| SetTimeOfDay(Int32, Int32, Int32, Int32) |
|
| SetTimeOfDay(Int32, Int32, Int32) |
|
| SetTimeZone(TimeZone) |
|
| SetWeekDate(Int32, Int32, Int32) |
|
| SetWeekDefinition(Int32, Int32) |
|
| ToArray<T>() |
從這個 Java 陣列包裝器建立一個受管理陣列。 (繼承來源 Object) |
| ToString() |
回傳物件的字串表示。 (繼承來源 Object) |
| UnregisterFromRuntime() |
將此 Java 節點從互通執行時中取消註冊。 (繼承來源 Object) |
| 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) |
|
擴充方法
| 名稱 | Description |
|---|---|
| GetJniTypeName(IJavaPeerable) |
取得實例 |
| JavaAs<TResult>(IJavaPeerable) |
試著強制 |
| JavaCast<TResult>(IJavaObject) |
執行 Android 執行時檢查型別轉換。 |
| JavaCast<TResult>(IJavaObject) |
|
| TryJavaCast<TResult>(IJavaPeerable, TResult) |
試著強制 |