DateTimeFormatterBuilder 類別

定義

命名空間:: Java.Time.Format

組件:: Mono.Android.dll

重要

部分資訊涉及發行前產品，在發行之前可能會有大幅修改。 Microsoft 對此處提供的資訊，不做任何明確或隱含的瑕疵擔保。

建構工具可建立日期時間格式化工具。

[Android.Runtime.Register("java/time/format/DateTimeFormatterBuilder", ApiSince=26, DoNotGenerateAcw=true)]
public sealed class DateTimeFormatterBuilder : Java.Lang.Object

[<Android.Runtime.Register("java/time/format/DateTimeFormatterBuilder", ApiSince=26, DoNotGenerateAcw=true)>]
type DateTimeFormatterBuilder = class
    inherit Object

繼承: Object

JavaObject

Object
DateTimeFormatterBuilder

屬性: RegisterAttribute

備註

建構工具可建立日期時間格式化工具。

這使得 DateTimeFormatter 能夠被創造。所有日期時間格式化器最終都是使用此建構器所建立。

日期時間的基本元素都可以加<：ul><li>值 - 數字值< / li><li 分>數 - 包含小數點位的小數值。輸出分數時務必使用此方法以確保分<數正確解析/li><li>文本 - 值/li<>li<的文字對應> OffsetId/OffsetId/Offset - 區域偏<移/li><li>ZoneId - ZoneId 時區 ID</li><li>ZoneText - 時區<名稱/li><li>ChronologyId - 時間軸時間序列 id</li><li>ChronologyText - 時間<序列名稱/li>li 字面 - 文字< / li><li 字>面巢狀與可選 - 格式可巢狀或可選< 此外><>，任何元素都可以用填充裝飾，無論是空格還是其他字元。<>

最後，一種大致相容的 java.text.SimpleDateFormat SimpleDateFormat 速記模式可用，詳見 #appendPattern(String)。實務上，這只是解析模式並呼叫建構者的其他方法。

新增於1.8版本。

的 java.time.format.DateTimeFormatterBuilderJava 檔。

此頁面的部分是根據 Android 開放原始碼專案所建立和共用的工作進行修改，並根據 Creative Commons 2.5 屬性授權中所述的詞彙使用。

建構函式

名稱	Description
DateTimeFormatterBuilder()	建立一個新的建構者實例。

屬性

名稱	Description
Class	回傳此 `Object`的執行時類別。 (繼承來源 Object)
Handle	底層 Android 實例的帳號。 (繼承來源 Object)
JniIdentityHashCode	取得由互通執行時指派給此 Java 對等端的身份雜湊碼。 (繼承來源 Object)
JniManagedPeerState	建構工具可建立日期時間格式化工具。 (繼承來源 JavaObject)
JniPeerMembers
PeerReference	取得這個 Java 節點的 JNI 物件參考。 (繼承來源 Object)
ThresholdClass	此 API 支援 Mono for Android 基礎架構，並非直接從你的程式碼中使用。 (繼承來源 Object)
ThresholdType	此 API 支援 Mono for Android 基礎架構，並非直接從你的程式碼中使用。 (繼承來源 Object)

方法

名稱	Description
Append(DateTimeFormatter)	將格式化器的所有元素附加到建構器上。
AppendChronologyId()	在格式化器後附加時間順序 ID，如「ISO」或「Thai Buddhist」。
AppendChronologyText(TextStyle)	在格式化器上附加時間順序名稱。
AppendFraction(ITemporalField, Int32, Int32, Boolean)	將日期-時間欄位的分數值附加到格式化器上。
AppendGenericZoneText(TextStyle, ICollection<ZoneId>)	在格式化器後附加通用時區名稱，例如「太平洋時間」。
AppendGenericZoneText(TextStyle)	在格式化器後附加通用時區名稱，例如「太平洋時間」。
AppendInstant()	在格式化器中附加一個即時，使用 ISO-8601，將小數數字格式化為三組。
AppendInstant(Int32)	使用 ISO-8601 在格式化器中附加一個瞬間，並可控制小數位元數。
AppendLiteral(Char)	在格式化器上直接附加一個字元。
AppendLiteral(String)	在formatter上附加一個字串的字串。
AppendLocalized(FormatStyle, FormatStyle)	在格式化器上附加一個本地化的日期-時間模式。
AppendLocalizedOffset(TextStyle)	將局部區域偏移（如「GMT+01：00」）附加到格式化器上。
AppendOffset(String, String)	在格式化器上附加區域偏移量，例如 '+01：00'。
AppendOffsetId()	在格式化器上附加區域偏移量，例如 '+01：00'。
AppendOptional(DateTimeFormatter)	在建構器上附加一個格式化器，該格式化器可選擇格式化/解析。
AppendPattern(String)	將指定模式定義的元素附加到建構器上。
AppendText(ITemporalField, IDictionary<Long,String>)	利用提供的映射將日期-時間欄位的文字附加到格式化器上。
AppendText(ITemporalField, TextStyle)	將日期-時間欄位的文字附加到格式化器中。
AppendText(ITemporalField)	使用全文樣式將日期-時間欄位的文字附加到格式化器中。
AppendValue(ITemporalField, Int32, Int32, SignStyle)	在格式化器中附加日期-時間欄位的值。
AppendValue(ITemporalField, Int32)	將日期-時間欄位的值附加到格式化器，使用固定寬度、零填充的數字。
AppendValue(ITemporalField)	會以正常輸出樣式將日期-時間欄位的值附加到格式化器上。
AppendValueReduced(ITemporalField, Int32, Int32, IChronoLocalDate)	將日期-時間欄位的簡化值附加到格式化器上。
AppendValueReduced(ITemporalField, Int32, Int32, Int32)	將日期-時間欄位的簡化值附加到格式化器上。
AppendZoneId()	在格式化器中附加時區識別碼，如「Europe/Paris」或「+02：00」。
AppendZoneOrOffsetId()	在格式化器上附加時區 ID，例如「Europe/Paris」或「+02：00」，並使用最佳可用區域 ID。
AppendZoneRegionId()	將時區區域 ID（如「Europe/Paris」）附加於格式化器，若區域 ID 為 `ZoneOffset`則拒絕該區域 ID。
AppendZoneText(TextStyle, ICollection<ZoneId>)	會在格式化器後附加時區名稱，例如「英國夏令時間」。
AppendZoneText(TextStyle)	會在格式化器後附加時區名稱，例如「英國夏令時間」。
Clone()	建立並回傳此物件的副本。 (繼承來源 Object)
Construct(JniObjectReference, JniObjectReferenceOptions)	建構工具可建立日期時間格式化工具。 (繼承來源 JavaObject)
Dispose()	釋放該 Java 節點所持有的資源。 (繼承來源 Object)
Dispose(Boolean)	釋放該 Java 節點所持有的資源。 (繼承來源 Object)
DisposeUnlessReferenced()	建構工具可建立日期時間格式化工具。 (繼承來源 JavaObject)
Equals(Object)	建構工具可建立日期時間格式化工具。 (繼承來源 JavaObject)
Equals(Object)	表示是否有其他物體「等同」於此物。 (繼承來源 Object)
GetHashCode()	回傳物件的雜湊碼值。 (繼承來源 Object)
GetLocalizedDateTimePattern(FormatStyle, FormatStyle, IChronology, Locale)	取得本地化日期與時間格式的格式模式。
JavaFinalize()	已淘汰. 當垃圾回收判定該物件不再有相關參考時，由垃圾回收器呼叫。 (繼承來源 Object)
Notify()	喚醒一個正在該物件監視器上等待的執行緒。 (繼承來源 Object)
NotifyAll()	喚醒所有等待該物件監視器的執行緒。 (繼承來源 Object)
OptionalEnd()	結束一個選填區塊。
OptionalStart()	標記選修區段的開始。
PadNext(Int32, Char)	這會讓下一個新增的印表機/解析器填充到固定寬度。
PadNext(Int32)	這會讓下一個新增的印表機/解析器用空格填充到固定寬度。
ParseCaseInsensitive()	將解析格式改為格式化器剩餘部分不區分大小寫。
ParseCaseSensitive()	將句法格式改為格式化器剩餘部分的大小寫區分。
ParseDefaulting(ITemporalField, Int64)	在格式化器中附加一個日期-時間欄位的預設值。
ParseLenient()	將句法樣式調整為格式化器其餘部分較寬鬆。
ParseStrict()	將句法樣式在格式化器剩餘部分變得嚴格。
SetHandle(IntPtr, JniHandleOwnership)	設定 Handle 屬性。 (繼承來源 Object)
SetPeerReference(JniObjectReference, JniObjectReferenceOptions)	建構工具可建立日期時間格式化工具。 (繼承來源 JavaObject)
ToArray<T>()	從這個 Java 陣列包裝器建立一個受管理陣列。 (繼承來源 Object)
ToFormatter()	透過使用預設的 locale 來完成 `DateTimeFormatter` 這個建構器。
ToFormatter(Locale)	透過使用指定地點建立建 `DateTimeFormatter` 構器來完成此建構器。
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()	建構工具可建立日期時間格式化工具。 (繼承來源 JavaObject)
IJavaPeerable.Finalized()	建構工具可建立日期時間格式化工具。 (繼承來源 JavaObject)
IJavaPeerable.JniObjectReferenceControlBlock	建構工具可建立日期時間格式化工具。 (繼承來源 JavaObject)
IJavaPeerable.SetJniIdentityHashCode(Int32)	建構工具可建立日期時間格式化工具。 (繼承來源 JavaObject)
IJavaPeerable.SetJniManagedPeerState(JniManagedPeerStates)	建構工具可建立日期時間格式化工具。 (繼承來源 JavaObject)
IJavaPeerable.SetPeerReference(JniObjectReference)	建構工具可建立日期時間格式化工具。 (繼承來源 JavaObject)

擴充方法

名稱	Description
GetJniTypeName(IJavaPeerable)	取得實例 `self`類型的 JNI 名稱。
JavaAs<TResult>(IJavaPeerable)	試著強制`self`輸入 `TResult`，檢查強制在 Java 端是否有效。
JavaCast<TResult>(IJavaObject)	執行 Android 執行時檢查型別轉換。
JavaCast<TResult>(IJavaObject)	建構工具可建立日期時間格式化工具。
TryJavaCast<TResult>(IJavaPeerable, TResult)	試著強制`self`輸入 `TResult`，檢查強制在 Java 端是否有效。

適用於