DateUtils.FormatDateRange 方法

[Android.Runtime.Register("formatDateRange", "(Landroid/content/Context;JJI)Ljava/lang/String;", "")]
public static string? FormatDateRange(Android.Content.Context? context, long startMillis, long endMillis, Android.Text.Format.FormatStyleFlags flags);

[<Android.Runtime.Register("formatDateRange", "(Landroid/content/Context;JJI)Ljava/lang/String;", "")>]
static member FormatDateRange : Android.Content.Context * int64 * int64 * Android.Text.Format.FormatStyleFlags -> string

參數

傳回

一個包含格式化日期/時間範圍的字串。

屬性

RegisterAttribute

備註

依照當地慣例，格式化日期或時間範圍。

請注意，這是一種方便的方法。 使用時需要即時建立內部 java.util.Formatter 實例，這在記憶體和時間上相當昂貴。 如果你很少使用這個方法，這或許可以接受，但如果你依賴它來格式化大量日期，可以考慮建立並重用自己的java.util.Formatter實例，並使用那個需要 java.util.Formatter的版本#formatDateRange(Context, long, long, int) formatDateRange。

Java 文件 android.text.format.DateUtils.formatDateRange(android.content.Context, long, long, int)。

本頁部分內容為基於 Open Source Project 所創建與分享的作品，並依授權條款所描述的使用進行修改。

[Android.Runtime.Register("formatDateRange", "(Landroid/content/Context;Ljava/util/Formatter;JJI)Ljava/util/Formatter;", "")]
public static Java.Util.Formatter? FormatDateRange(Android.Content.Context? context, Java.Util.Formatter? formatter, long startMillis, long endMillis, Android.Text.Format.FormatStyleFlags flags);

[<Android.Runtime.Register("formatDateRange", "(Landroid/content/Context;Ljava/util/Formatter;JJI)Ljava/util/Formatter;", "")>]
static member FormatDateRange : Android.Content.Context * Java.Util.Formatter * int64 * int64 * Android.Text.Format.FormatStyleFlags -> Java.Util.Formatter

參數

傳回

一個包含格式化日期/時間範圍的字串。

屬性

RegisterAttribute

備註

依照當地慣例，格式化日期或時間範圍。

請注意，這是方便格式化當地時區日期或時間範圍的方法。 如果你想指定時區，請使用 #formatDateRange(Context, Formatter, long, long, int, String) formatDateRange。

Java 文件 android.text.format.DateUtils.formatDateRange(android.content.Context, java.util.Formatter, long, long, int)。

本頁部分內容為基於 Open Source Project 所創建與分享的作品，並依授權條款所描述的使用進行修改。

[Android.Runtime.Register("formatDateRange", "(Landroid/content/Context;Ljava/util/Formatter;JJILjava/lang/String;)Ljava/util/Formatter;", "")]
public static Java.Util.Formatter? FormatDateRange(Android.Content.Context? context, Java.Util.Formatter? formatter, long startMillis, long endMillis, Android.Text.Format.FormatStyleFlags flags, string? timeZone);

[<Android.Runtime.Register("formatDateRange", "(Landroid/content/Context;Ljava/util/Formatter;JJILjava/lang/String;)Ljava/util/Formatter;", "")>]
static member FormatDateRange : Android.Content.Context * Java.Util.Formatter * int64 * int64 * Android.Text.Format.FormatStyleFlags * string -> Java.Util.Formatter

參數

傳回

格式化日期/時間範圍的格式化器會附加在字串緩衝區。

屬性

RegisterAttribute

備註

依照當地慣例，格式化日期或時間範圍。

範例輸出字串（這些範例中的日期格式使用美國日期格式慣例，但會依當地設定有所不同）：ul>li 10：15am</li<>li>3：00pm - 4：<00pm/li><li>3pm - 4pm</li<>li>3PM - 4PM</li><li>08：00 - 17：00</li<>li>10月9<<>>日 星期二，10月9<日/li<>li>10月9日，><< 2007</李><>李 10月9日 - 10<日/李<>>李 2007<年10月9日-10日/李<>李>2007<年10月28日 - 11月3日/李<>李>2007年12月31日 - 2008<年1月1日/李><>李 10月9日 上午8：00 - 10月10日，下午<5：00/李>><李 2007年12月31日 - 2008<年1月1日/li></ul>

旗標參數是以下列表中選項的位元遮罩：

<烏爾><·李>FORMAT_SHOW_TIME</李<>李>FORMAT_SHOW_WEEKDAY</李><李>FORMAT_SHOW_YEAR</李><李>FORMAT_SHOW_DATE</李><李>FORMAT_NO_MONTH_DAY</李<>李>FORMAT_12HOUR</李><李>FORMAT_24HOUR</李><李>FORMAT_CAP_AMPM/李<>李>FORMAT_NO_NOON</李>><李 FORMAT_CAP_NOON<</李><李>FORMAT_NO_MIDNIGHT</李<>>李 FORMAT_CAP_MIDNIGHT</李><李>FORMAT_UTC</李><李>FORMAT_ABBREV_TIME</李><李>FORMAT_ABBREV_WEEKDAY</李<>李>FORMAT_ABBREV_MONTH</李><李>FORMAT_ABBREV_ALL</李>><李 李 FORMAT_NUMERIC_DATE</李></烏爾>

若設定FORMAT_SHOW_TIME，時間會顯示為日期範圍的一部分。 如果開始和結束時間相同，則只顯示開始時間。

若FORMAT_SHOW_WEEKDAY設定，則顯示平日。

如果FORMAT_SHOW_YEAR設定，年份總是會顯示。 若未設定FORMAT_SHOW_YEAR，則僅在年份與當前年份不同，或起訖日期落在不同年份時才顯示。

通常會顯示日期，除非起點和結束日期相同。 如果FORMAT_SHOW_DATE設定，那麼日期總是會顯示，即使是同一天的範圍。

如果設定FORMAT_NO_MONTH_DAY，那麼顯示日期時，只會顯示月份名稱，而不是月份的日期。 例如，將「2008年1月」取代「2008年1月6日至12日」。

若設定FORMAT_CAP_AMPM且使用12小時制，則「AM」與「PM」會大寫。 你不應該使用這個旗幟，因為在某些地區這些詞彙不能大寫，而在許多其他地方即使可以大寫，也不太合理。

若設定FORMAT_NO_NOON且使用12小時制，則顯示「12pm」而非「noon」。

若設定FORMAT_CAP_NOON且使用12小時制，則顯示「中午」而非「中午」。 你大概不應該使用這個旗幟，因為在許多地方，大寫這個詞並不合理。

若設定FORMAT_NO_MIDNIGHT且使用12小時制，則顯示「12am」而非「午夜」。

若設定FORMAT_CAP_MIDNIGHT且使用12小時制，則顯示「午夜」而非「午夜」。 你大概不應該使用這個旗幟，因為在許多地方，大寫這個詞並不合理。

若設定FORMAT_12HOUR且顯示時間，則以12小時制顯示。 你通常不應該設定這個。 相反地，讓時間格式依系統設定自動選擇。 若FORMAT_12HOUR與FORMAT_24HOUR同時設定，則FORMAT_24HOUR優先。

如果FORMAT_24HOUR設定並顯示時間，則時間會以24小時制顯示。 你通常不應該設定這個。 相反地，讓時間格式依系統設定自動選擇。 若FORMAT_12HOUR與FORMAT_24HOUR同時設定，則FORMAT_24HOUR優先。

若設定FORMAT_UTC，則起止毫秒皆以UTC時區計算，除非指定時區。 如果指定了時區，無論FORMAT_UTC旗標如何，都會使用該時區。

若設定FORMAT_ABBREV_TIME且使用12小時制，則開始與結束時間（若顯示）會因分鐘為零而縮短。 例如，時間會縮短為「下午3點」。

若設定FORMAT_ABBREV_WEEKDAY，則平日（如有顯示）會縮寫為三字母字串。

若設定FORMAT_ABBREV_MONTH，則月份（如有顯示）會縮寫為三字母串。

若設定FORMAT_ABBREV_ALL，則星期和月份（若有顯示）會縮寫成三字母字串。

若設定FORMAT_NUMERIC_DATE，日期則以數字格式顯示，而非使用月份名稱。 例如，用「12/31/2008」代替「December 31， 2008」。

如果結束日期在一天開始的凌晨12點結束，則在兩種情況下會以前一天結束的格式來表示： <ul><li>針對單日活動。 這導致「晚上8點至午夜」而非「11月10日晚上8點至11月11日凌晨12點」。</li><li>當時間未顯示時。 因此，活動的起始日期為11月10日至11日，結束時間為11月12日00：00。</li></ul>

Java 文件 android.text.format.DateUtils.formatDateRange(android.content.Context, java.util.Formatter, long, long, int, java.lang.String)。

本頁部分內容為基於 Open Source Project 所創建與分享的作品，並依授權條款所描述的使用進行修改。