DateFormat 類別
定義
重要
部分資訊涉及發行前產品，在發行之前可能會有大幅修改。 Microsoft 對此處提供的資訊，不做任何明確或隱含的瑕疵擔保。
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 版本中加入。
此頁面的部分是根據 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 |
回傳此 |
| DateInstance |
會取得預設地區的預設格式格式的 |
| DateTimeInstance |
會取得預設地區的預設格式格式的 |
| Handle |
底層 Android 實例的帳號。 (繼承來源 Object) |
| Instance |
取得一個預設的日期/時間格式，並且同時使用簡短格式來表示日期和時間。 |
| JniIdentityHashCode |
取得由互通執行時指派給此 Java 對等端的身份雜湊碼。 (繼承來源 Object) |
| JniManagedPeerState |
|
| JniPeerMembers |
|
| Lenient |
說明日期/時間解析是否應該寬鬆。 -或- 指定日期/時間解析是否應寬鬆。 |
| NumberFormat |
取得這個日期/時間格式化器用來格式化和解析時間的數字格式化器。 -或- 讓你設定數字格式。 |
| PeerReference |
取得這個 Java 節點的 JNI 物件參考。 (繼承來源 Object) |
| ThresholdClass |
此 API 支援 Mono for Android 基礎架構，並非直接從你的程式碼中使用。 |
| ThresholdType |
此 API 支援 Mono for Android 基礎架構，並非直接從你的程式碼中使用。 |
| TimeInstance |
取得預設區域的預設格式 |
| TimeZone |
會知道時區。 -或- 設定此 |
方法
| 名稱 | Description |
|---|---|
| Clone() |
建立並回傳此物件的副本。 (繼承來源 _Format) |
| Construct(JniObjectReference, JniObjectReferenceOptions) |
|
| Dispose() |
釋放該 Java 節點所持有的資源。 (繼承來源 Object) |
| Dispose(Boolean) |
釋放該 Java 節點所持有的資源。 (繼承來源 Object) |
| DisposeUnlessReferenced() |
|
| Equals(Object) |
|
| Equals(Object) |
表示是否有其他物體「等同」於此物。 (繼承來源 Object) |
| Format(Date, StringBuffer, FieldPosition) |
將 a |
| Format(Date) |
將 a |
| Format(Object, StringBuffer, FieldPosition) |
將所給的 |
| Format(Object) |
格式化物件以產生字串。 (繼承來源 _Format) |
| FormatToCharacterIterator(Object) |
格式化物件產生 |
| GetAvailableLocales() |
回傳一個包含所有區域的陣列，該 |
| GetDateInstance(Int32, Locale) |
取得該地點的日期格式格式和格式格式。 |
| GetDateInstance(Int32) |
取得預設地區指定格式格式 |
| GetDateTimeInstance(Int32, Int32, Locale) |
取得該地點的日期/時間格式格式。 |
| GetDateTimeInstance(Int32, Int32) |
取得預設地點的日期/時間格式格式，並依照指定日期和時間格式格式 |
| GetHashCode() |
回傳物件的雜湊碼值。 (繼承來源 Object) |
| GetTimeInstance(Int32, Locale) |
取得該地點時間格式化器與格式格式。 |
| GetTimeInstance(Int32) |
取得預設地區的指定格式格式 |
| JavaFinalize() |
已淘汰.
當垃圾回收判定該物件不再有相關參考時，由垃圾回收器呼叫。 (繼承來源 Object) |
| Notify() |
喚醒一個正在該物件監視器上等待的執行緒。 (繼承來源 Object) |
| NotifyAll() |
喚醒所有等待該物件監視器的執行緒。 (繼承來源 Object) |
| Parse(String, ParsePosition) |
根據給定的解析位置解析一個日期/時間字串。 |
| Parse(String) |
從給定字串的開頭解析文字以產生日期。 |
| ParseObject(String, ParsePosition) |
從字串中解析文字以產生 |
| ParseObject(String) |
解析給定字串開頭的文字以產生物件。 (繼承來源 _Format) |
| SetHandle(IntPtr, JniHandleOwnership) |
設定 Handle 屬性。 (繼承來源 Object) |
| SetPeerReference(JniObjectReference, JniObjectReferenceOptions) |
|
| 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) |
|
| IJavaPeerable.UnregisterFromRuntime() |
|
擴充方法
| 名稱 | Description |
|---|---|
| GetJniTypeName(IJavaPeerable) |
取得實例 |
| JavaAs<TResult>(IJavaPeerable) |
試著強制 |
| JavaCast<TResult>(IJavaObject) |
執行 Android 執行時檢查型別轉換。 |
| JavaCast<TResult>(IJavaObject) |
|
| TryJavaCast<TResult>(IJavaPeerable, TResult) |
試著強制 |