DateFormat.Format 方法
定義
重要
部分資訊涉及發行前產品，在發行之前可能會有大幅修改。 Microsoft 對此處提供的資訊，不做任何明確或隱含的瑕疵擔保。
多載
| 名稱 | Description |
|---|---|
| Format(Date, StringBuffer, FieldPosition) |
將日期格式化成日期/時間字串。 |
| Format(ITemporal, StringBuffer, FieldPosition) |
將 a |
| Format(Object, StringBuffer, FieldPosition) |
將時間物件格式化成時間字串。 |
| Format(ITemporal) |
將 a |
| Format(Date) |
將日期格式化成日期/時間字串。 |
| Format(Calendar, StringBuffer, FieldPosition) |
將日期格式化成日期/時間字串。 |
Format(Date, StringBuffer, FieldPosition)
將日期格式化成日期/時間字串。
[Android.Runtime.Register("format", "(Ljava/util/Date;Ljava/lang/StringBuffer;Ljava/text/FieldPosition;)Ljava/lang/StringBuffer;", "GetFormat_Ljava_util_Date_Ljava_lang_StringBuffer_Ljava_text_FieldPosition_Handler", ApiSince=24)]
public virtual Java.Lang.StringBuffer? Format(Java.Util.Date? date, Java.Lang.StringBuffer? toAppendTo, Java.Text.FieldPosition? fieldPosition);[<Android.Runtime.Register("format", "(Ljava/util/Date;Ljava/lang/StringBuffer;Ljava/text/FieldPosition;)Ljava/lang/StringBuffer;", "GetFormat_Ljava_util_Date_Ljava_lang_StringBuffer_Ljava_text_FieldPosition_Handler", ApiSince=24)>]
override this.Format : Java.Util.Date * Java.Lang.StringBuffer * Java.Text.FieldPosition -> Java.Lang.StringBuffer參數
- date
- Date
一個日期，格式化成日期/時間字串。
- toAppendTo
- StringBuffer
回傳日期/時間字串的字串緩衝區。
- fieldPosition
- FieldPosition
追蹤場在回傳串中的位置。 輸入時：如果需要，可以設定一個對齊欄位。 輸出時：對齊場的偏移量。 例如，給定時間文字「1996.07.10 AD at 15：08：56 PDT」，若 fieldPosition 為 DateFormat.YEAR_FIELD，則 fieldPosition 的開始索引與結束索引分別設為 0 和 4。 請注意，如果同一時間欄位在同一模式中出現多次，fieldPosition 會設定為該時間欄位的首次出現。 例如，使用模式「h a z （zzzz）」及對齊欄位 DateFormat.TIMEZONE_FIELD 格式化日期到時間字串「1 PM PDT （Pacific Daylight Time）」時，fieldPosition 的起始索引與結束索引分別設為 5 和 8，以表示時區模式字元 'z' 首次出現。
傳回
格式化的日期/時間字串。
- 屬性
備註
將日期格式化成日期/時間字串。
本頁部分內容為基於 Open Source Project 所創建與分享的作品，並依授權條款所描述的使用進行修改。
適用於
Format(ITemporal, StringBuffer, FieldPosition)
將 a Temporal 格式化成日期/時間字串。
[Android.Runtime.Register("format", "(Ljava/time/temporal/Temporal;Ljava/lang/StringBuffer;Ljava/text/FieldPosition;)Ljava/lang/StringBuffer;", "GetFormat_Ljava_time_temporal_Temporal_Ljava_lang_StringBuffer_Ljava_text_FieldPosition_Handler", ApiSince=37)]
public virtual Java.Lang.StringBuffer? Format(Java.Time.Temporal.ITemporal? date, Java.Lang.StringBuffer? toAppendTo, Java.Text.FieldPosition? fieldPosition);[<Android.Runtime.Register("format", "(Ljava/time/temporal/Temporal;Ljava/lang/StringBuffer;Ljava/text/FieldPosition;)Ljava/lang/StringBuffer;", "GetFormat_Ljava_time_temporal_Temporal_Ljava_lang_StringBuffer_Ljava_text_FieldPosition_Handler", ApiSince=37)>]
override this.Format : Java.Time.Temporal.ITemporal * Java.Lang.StringBuffer * Java.Text.FieldPosition -> Java.Lang.StringBuffer參數
- date
- ITemporal
Temporal a 將格式化為日期/時間字串。
- toAppendTo
- StringBuffer
回傳日期/時間字串的字串緩衝區。
- fieldPosition
- FieldPosition
追蹤場在回傳串中的位置。<br> 輸入時：如果需要，則設置對齊欄位。<br> 輸出時：對齊場的偏移量。<br> 例如，給定一個時間文本「1996.07.10 AD at 15：08：56 PDT」，若給定 fieldPosition 為 DateFormat.YEAR_FIELD，則 的 fieldPosition 開始索引與結束索引分別設為 0 和 4。<br> 注意，如果同一時間欄位在同一模式中出現多次，fieldPosition 將設定為該時間欄位的首次出現。 例如，將 a Temporal 格式化為時間串「1 PM PDT（太平洋夏令時間）」，使用模式「h a z （zzzz）」及對齊欄位 DateFormat.TIMEZONE_FIELD，開始索引與結束索引 fieldPosition 分別設為 5 和 8，以表示時區模式字元 'z' 的首次出現。
傳回
格式化的日期/時間字串。
- 屬性
備註
將時間資料格式化成日期/時間字串。
Android 參考資料。android.icu.text.DateFormat.format
本頁部分內容為基於 Open Source Project 所創建與分享的作品，並依授權條款所描述的使用進行修改。
適用於
Format(Object, StringBuffer, FieldPosition)
將時間物件格式化成時間字串。
[Android.Runtime.Register("format", "(Ljava/lang/Object;Ljava/lang/StringBuffer;Ljava/text/FieldPosition;)Ljava/lang/StringBuffer;", "", ApiSince=24)]
public override sealed Java.Lang.StringBuffer? Format(Java.Lang.Object? obj, Java.Lang.StringBuffer? toAppendTo, Java.Text.FieldPosition? fieldPosition);[<Android.Runtime.Register("format", "(Ljava/lang/Object;Ljava/lang/StringBuffer;Ljava/text/FieldPosition;)Ljava/lang/StringBuffer;", "", ApiSince=24)>]
override this.Format : Java.Lang.Object * Java.Lang.StringBuffer * Java.Text.FieldPosition -> Java.Lang.StringBuffer參數
- obj
- Object
必須是數字、日期或日曆。
- toAppendTo
- StringBuffer
回傳時間字串的字串緩衝區。
- fieldPosition
- FieldPosition
追蹤場在回傳串中的位置。 輸入時：如果需要，可以設定一個對齊欄位。 輸出時：對齊場的偏移量。 例如，給定時間文字「1996.07.10 AD at 15：08：56 PDT」，若 fieldPosition 為 DateFormat.YEAR_FIELD，則 fieldPosition 的開始索引與結束索引分別設為 0 和 4。 請注意，如果同一時間欄位在同一模式中出現多次，fieldPosition 會設定為該時間欄位的首次出現。 例如，使用模式「h a z （zzzz）」及對齊欄位 DateFormat.TIMEZONE_FIELD 格式化日期到時間字串「1 PM PDT （Pacific Daylight Time）」時，fieldPosition 的起始索引與結束索引分別設為 5 和 8，以表示時區模式字元 'z' 首次出現。
傳回
格式化的時間字串。
- 屬性
備註
將時間物件格式化成時間字串。 時間物件的例子包括以毫秒表示的時間值和日期物件。
本頁部分內容為基於 Open Source Project 所創建與分享的作品，並依授權條款所描述的使用進行修改。
適用於
Format(ITemporal)
將 a Temporal 格式化成日期/時間字串。
[Android.Runtime.Register("format", "(Ljava/time/temporal/Temporal;)Ljava/lang/String;", "", ApiSince=37)]
public string? Format(Java.Time.Temporal.ITemporal? date);[<Android.Runtime.Register("format", "(Ljava/time/temporal/Temporal;)Ljava/lang/String;", "", ApiSince=37)>]
override this.Format : Java.Time.Temporal.ITemporal -> string參數
- date
- ITemporal
時間值將格式化為時間串。
傳回
格式化的時間字串。
- 屬性
備註
將時間資料格式化成日期/時間字串。
Android 參考資料。android.icu.text.DateFormat.format
本頁部分內容為基於 Open Source Project 所創建與分享的作品，並依授權條款所描述的使用進行修改。
適用於
Format(Date)
將日期格式化成日期/時間字串。
[Android.Runtime.Register("format", "(Ljava/util/Date;)Ljava/lang/String;", "", ApiSince=24)]
public string? Format(Java.Util.Date? date);[<Android.Runtime.Register("format", "(Ljava/util/Date;)Ljava/lang/String;", "", ApiSince=24)>]
override this.Format : Java.Util.Date -> string參數
- date
- Date
時間值將格式化為時間串。
傳回
格式化的時間字串。
- 屬性
備註
將日期格式化成日期/時間字串。
Java 文件 android.icu.text.DateFormat.format(java.util.Date)。
本頁部分內容為基於 Open Source Project 所創建與分享的作品，並依授權條款所描述的使用進行修改。
適用於
Format(Calendar, StringBuffer, FieldPosition)
將日期格式化成日期/時間字串。
[Android.Runtime.Register("format", "(Landroid/icu/util/Calendar;Ljava/lang/StringBuffer;Ljava/text/FieldPosition;)Ljava/lang/StringBuffer;", "GetFormat_Landroid_icu_util_Calendar_Ljava_lang_StringBuffer_Ljava_text_FieldPosition_Handler", ApiSince=24)]
public abstract Java.Lang.StringBuffer? Format(Android.Icu.Util.Calendar? cal, Java.Lang.StringBuffer? toAppendTo, Java.Text.FieldPosition? fieldPosition);[<Android.Runtime.Register("format", "(Landroid/icu/util/Calendar;Ljava/lang/StringBuffer;Ljava/text/FieldPosition;)Ljava/lang/StringBuffer;", "GetFormat_Landroid_icu_util_Calendar_Ljava_lang_StringBuffer_Ljava_text_FieldPosition_Handler", ApiSince=24)>]
override this.Format : Android.Icu.Util.Calendar * Java.Lang.StringBuffer * Java.Text.FieldPosition -> Java.Lang.StringBuffer參數
- cal
- Calendar
一個日曆，設定為日期與時間，並以日期/時間字串格式化。 當行事曆類型與此 DateFormat 實例所持有的內部日曆不同時，日期與時區會繼承自輸入日曆，但其他日曆欄位的值則由內部日曆計算。
- toAppendTo
- StringBuffer
回傳日期/時間字串的字串緩衝區。
- fieldPosition
- FieldPosition
追蹤場在回傳串中的位置。 輸入時：如果需要，可以設定一個對齊欄位。 輸出時：對齊場的偏移量。 例如，給定時間文字「1996.07.10 AD at 15：08：56 PDT」，若 fieldPosition 為 DateFormat.YEAR_FIELD，則 fieldPosition 的開始索引與結束索引分別設為 0 和 4。 請注意，如果同一時間欄位在同一模式中出現多次，fieldPosition 會設定為該時間欄位的首次出現。 例如，使用模式「h a z （zzzz）」及對齊欄位 DateFormat.TIMEZONE_FIELD 格式化日期到時間字串「1 PM PDT （Pacific Daylight Time）」時，fieldPosition 的起始索引與結束索引分別設為 5 和 8，以表示時區模式字元 'z' 首次出現。
傳回
格式化的日期/時間字串。
- 屬性
備註
將日期格式化成日期/時間字串。
本頁部分內容為基於 Open Source Project 所創建與分享的作品，並依授權條款所描述的使用進行修改。