語言

DateFormat 類別

定義

DateFormat 是一個用於日期/時間格式化子類別的抽象類別,能以語言無關的方式格式化與解析日期或時間。

[Android.Runtime.Register("java/text/DateFormat", DoNotGenerateAcw=true)]
public abstract class DateFormat : Java.Text._Format
[<Android.Runtime.Register("java/text/DateFormat", DoNotGenerateAcw=true)>]
type DateFormat = class
    inherit _Format
繼承
衍生
屬性

備註

DateFormat 是一個用於日期/時間格式化子類別的抽象類別,能以語言無關的方式格式化與解析日期或時間。 日期/時間格式子類,例如 SimpleDateFormat,允許格式化(即日期與rarr;文字)、解析(文字與rarr;日期)及正規化。 自1970年1月1日00:00:00 GMT起,日期以物體或毫秒表示 Date 。

DateFormat 提供多種類別方法,根據預設或特定地點取得預設日期/時間格式化器,並提供多種格式風格。 格式格式包括#FULL、 #LONG#MEDIUM#SHORT和 。 更多細節及使用這些風格的範例可見於方法說明中。

DateFormat 幫助你格式化和解析任何地區的日期。 你的程式碼可以完全不受月份、星期幾甚至曆法格式(如月亮與太陽)的區域慣例影響。

若要格式化當前地點的日期,請使用靜態工廠方法之一: <blockquote>

{@code
            myString = DateFormat.getDateInstance().format(myDate);
            }

</區塊引用>

如果你要格式化多個日期,取得格式並多次使用會更有效率,這樣系統就不用多次取得當地語言和國家慣例的資訊。 <引用>

{@code
            DateFormat df = DateFormat.getDateInstance();
            for (int i = 0; i < myDate.length; ++i) {
                output.println(df.format(myDate[i]) + "; ");
            }
            }

</區塊引用>

若要格式化不同地點的日期,請在呼叫 中 #getDateInstance(int, Locale) getDateInstance()指定。 <引用>

{@code
            DateFormat df = DateFormat.getDateInstance(DateFormat.LONG, Locale.FRANCE);
            }

</區塊引用>

你也可以用 DateFormat 來解析。 <引用>

{@code
            myDate = df.parse(myString);
            }

</區塊引用>

用來 getDateInstance 取得該國正常的日期格式。 還有其他靜態工廠方法可用。 用來 getTimeInstance 取得該國家的時間格式。 用 getDateTimeInstance 來取得日期和時間格式。 你可以輸入不同的選項給這些工廠方法來控制結果的長度;從 #SHORT 到 #MEDIUM 到 #LONG#FULL到 。 具體結果依地點而異,但一般而言:<ul><li>#SHORT 完全數值化,例如 li12.13.523:30pm<>#MEDIUM較長,Jan 12, 1952<例如 li>#LONG 較長,或 January 12, 19523:30:32pm<li>#FULL 相當完整指定,例如 。Tuesday, April 12, 1952 AD or 3:30:42pm PST </ul>

如果你願意,也可以設定格式的時區。 如果你想要更多對格式或解析的控制,或想給使用者更多控制權,可以嘗試將你從出廠方法中獲得的 DateFormat 投射到 SimpleDateFormat. 這對大多數國家來說是可行的;記得把它放在 try 方塊裡,以防遇到異常的方塊。

你也可以使用解析和格式化方法的形式,並ParsePositionFieldPosition允許你逐步<><>解析字串的片段。 < >Li 可以對齊特定欄位,或在螢幕上查詢該欄位的位置。 </ul>

<h2>「synchronization」同步></h2>

日期格式並不同步。 建議為每個執行緒建立獨立格式實例。 若多個執行緒同時存取同一格式,必須在外部同步。

在 1.1 版本中加入。

Java 文件 java.text.DateFormat。

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

建構函式

名稱 Description
DateFormat()

建立新的約會格式。

DateFormat(IntPtr, JniHandleOwnership)

用於建立 JNI 物件受管理表示的建構器;由執行時呼叫。

欄位

名稱 Description
AmPmField

對於場AM_PM對齊來說很有用。

DateField

對於 DATE 欄位對齊非常有用的常數。

DayOfWeekField

對於場DAY_OF_WEEK對齊來說很有用。

DayOfWeekInMonthField

對於場對齊DAY_OF_WEEK_IN_MONTH有用的常數。

DayOfYearField

對於場DAY_OF_YEAR對齊非常有用的常數。

Default

預設風格的模式是恆定的。

EraField

對於ERA場地對齊非常有用的常數。

Full

全風格花紋是恆定的。

Hour0Field

對於零基小時場對齊非常有用的常數。

Hour1Field

對於一基數小時的場對齊非常有用的常數。

HourOfDay0Field

對於零基HOUR_OF_DAY場對齊非常有用的常數。

HourOfDay1Field

對於一基HOUR_OF_DAY場對齊非常有用的常數。

Long

長型圖案是固定的。

Medium

中等款式的圖案是固定的。

MillisecondField

對於毫秒場對齊非常有用的常數。

MinuteField

對於分鐘場對準來說非常有用的常數。

MonthField

對於 MONTH 場比對很有用的常數。

SecondField

對於第二場對準來說是有用的常數。

Short

短款圖案是固定的。

TimezoneField

這是時區欄位對齊的有用常數。

WeekOfMonthField

對於場WEEK_OF_MONTH對齊非常有用的常數。

WeekOfYearField

對場對準WEEK_OF_YEAR有用的常數。

YearField

這是對年度場對齊的有用常數。

屬性

名稱 Description
Calendar

取得與此日期/時間格式器相關的行事曆。 -或- 設定日曆依照此日期格式使用。

Class

回傳此 Object的執行時類別。

(繼承來源 Object)
DateInstance

會取得預設地區的預設格式格式的 java.util.Locale.Category#FORMAT FORMAT 日期格式化器。

DateTimeInstance

會取得預設地區的預設格式格式的 java.util.Locale.Category#FORMAT FORMAT 日期/時間格式。

Handle

底層 Android 實例的帳號。

(繼承來源 Object)
Instance

取得一個預設的日期/時間格式,並且同時使用簡短格式來表示日期和時間。

JniIdentityHashCode

取得由互通執行時指派給此 Java 對等端的身份雜湊碼。

(繼承來源 Object)
JniManagedPeerState

取得執行時最後指派的狀態旗標。

(繼承來源 JavaObject)
JniPeerMembers

取得用於存取此 Java 綁定成員的 JNI 元資料。

Lenient

說明日期/時間解析是否應該寬鬆。 -或- 指定日期/時間解析是否應寬鬆。

NumberFormat

取得這個日期/時間格式化器用來格式化和解析時間的數字格式化器。 -或- 讓你設定數字格式。

PeerReference

取得這個 Java 節點的 JNI 物件參考。

(繼承來源 Object)
ThresholdClass

此 API 支援 Mono for Android 基礎架構,並非直接從你的程式碼中使用。

ThresholdType

此 API 支援 Mono for Android 基礎架構,並非直接從你的程式碼中使用。

TimeInstance

取得預設區域的預設格式 java.util.Locale.Category#FORMAT FORMAT 。

TimeZone

會知道時區。 -或- 設定此 DateFormat 物件日曆的時區。

方法

名稱 Description
Clone()

建立並回傳此物件的副本。

(繼承來源 _Format)
Construct(JniObjectReference, JniObjectReferenceOptions)

將此對等節點的建置委派給執行時的值管理器。

(繼承來源 JavaObject)
Dispose()

釋放該 Java 節點所持有的資源。

(繼承來源 Object)
Dispose(Boolean)

釋放該 Java 節點所持有的資源。

(繼承來源 Object)
DisposeUnlessReferenced()

請求值管理器處置此對等節點,除非其映射保留該受管理實例。

(繼承來源 JavaObject)
Equals(Object)

測試另一個受管理節點是否參考相同的 Java 物件。

(繼承來源 JavaObject)
Equals(Object)

表示是否有其他物體「等同」於此物。

(繼承來源 Object)
Format(Date, StringBuffer, FieldPosition)

將 a Date 格式化成日期時間字串。

Format(Date)

將 a Date 格式化成日期時間字串。

Format(Object, StringBuffer, FieldPosition)

將所給的 Object 格式化成日期-時間字串。

Format(Object)

格式化物件以產生字串。

(繼承來源 _Format)
FormatToCharacterIterator(Object)

格式化物件產生 AttributedCharacterIterator。

(繼承來源 _Format)
GetAvailableLocales()

回傳一個包含所有區域的陣列,該 get*Instance 類別的方法可回傳本地化實例。

GetDateInstance(Int32, Locale)

取得該地點的日期格式格式和格式格式。

GetDateInstance(Int32)

取得預設地區指定格式格式 java.util.Locale.Category#FORMAT FORMAT 的日期格式器。

GetDateTimeInstance(Int32, Int32, Locale)

取得該地點的日期/時間格式格式。

GetDateTimeInstance(Int32, Int32)

取得預設地點的日期/時間格式格式,並依照指定日期和時間格式格式 java.util.Locale.Category#FORMAT FORMAT 。

GetHashCode()

回傳物件的雜湊碼值。

(繼承來源 Object)
GetTimeInstance(Int32, Locale)

取得該地點時間格式化器與格式格式。

GetTimeInstance(Int32)

取得預設地區的指定格式格式 java.util.Locale.Category#FORMAT FORMAT 化時間格式。

JavaFinalize()
已淘汰.

當垃圾回收判定該物件不再有相關參考時,由垃圾回收器呼叫。

(繼承來源 Object)
Notify()

喚醒一個正在該物件監視器上等待的執行緒。

(繼承來源 Object)
NotifyAll()

喚醒所有等待該物件監視器的執行緒。

(繼承來源 Object)
Parse(String, ParsePosition)

根據給定的解析位置解析一個日期/時間字串。

Parse(String)

從給定字串的開頭解析文字以產生日期。

ParseObject(String, ParsePosition)

從字串中解析文字以產生 Date。

ParseObject(String)

解析給定字串開頭的文字以產生物件。

(繼承來源 _Format)
SetHandle(IntPtr, JniHandleOwnership)

設定 Handle 屬性。

(繼承來源 Object)
SetPeerReference(JniObjectReference, JniObjectReferenceOptions)

在控制區塊中儲存參考值,但不建立 JNI 參考副本。

(繼承來源 JavaObject)
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()

標記此節點為處置,並以disposing設定為 true的呼叫Dispose。

(繼承來源 JavaObject)
IJavaPeerable.Finalized()

標記此節點為處置,並以disposing設定為 false的呼叫Dispose。

(繼承來源 JavaObject)
IJavaPeerable.JniObjectReferenceControlBlock

取得此對等端使用的原生控制區塊指標。

(繼承來源 JavaObject)
IJavaPeerable.SetJniIdentityHashCode(Int32)

儲存執行時提供的身份雜湊碼。

(繼承來源 JavaObject)
IJavaPeerable.SetJniManagedPeerState(JniManagedPeerStates)

取代儲存的受管理對等狀態旗標。

(繼承來源 JavaObject)
IJavaPeerable.SetPeerReference(JniObjectReference)

當引用無效時,更新對等節點並釋放已拋棄節點的控制區塊。

(繼承來源 JavaObject)
IJavaPeerable.UnregisterFromRuntime()

將此實例從執行時的 Java 物件查詢中移除。

(繼承來源 _Format)

擴充方法

名稱 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 端是否有效。

適用於