DateIntervalInfo 類別

定義

[Android.Runtime.Register("android/icu/text/DateIntervalInfo", ApiSince=24, DoNotGenerateAcw=true)]
public class DateIntervalInfo : Java.Lang.Object, Android.Icu.Util.IFreezable, IDisposable, Java.IO.ISerializable

[<Android.Runtime.Register("android/icu/text/DateIntervalInfo", ApiSince=24, DoNotGenerateAcw=true)>]
type DateIntervalInfo = class
    inherit Object
    interface IFreezable
    interface ICloneable
    interface IJavaObject
    interface IDisposable
    interface IJavaPeerable
    interface ISerializable

繼承

Object

JavaObject

Object

DateIntervalInfo

屬性

RegisterAttribute

實作

IFreezable IJavaObject IJavaPeerable ISerializable ICloneable IDisposable

備註

DateIntervalInfo 是一個公開類別，用於封裝可本地化的日期時間區間模式。 它被 DateIntervalFormat 使用。

對大多數使用者而言，日常使用 DateIntervalFormat 並不需要直接建立 DateIntervalInfo 物件。 DateIntervalFormat 會在使用者輸入骨架和地點時，幫你處理這件事。

對於想要建立自己的日期間隔模式，或想重設日期間隔模式的進階使用者，可以直接建立 DateIntervalInfo 並加以操作來達成。

邏輯上，區間模式是從（骨架，the_largest_different_calendar_field）到（date_interval_pattern）的映射。

骨架 <ol><li> 只保留場面圖案字母，忽略圖案中其他部分，如空格、標點符號和字串文字。 <李> 藏起了田的順序。 <李> 可能會隱藏田地的花紋字母長度。

對於非數字日曆欄位，字母長度很重要，例如 MMM、MMMM 和 MMMMM;EEE 和 EEEE，並且尊重該領域的字母長度。

對於數字日曆欄位，如 M 或 MM、d 或 dd、yy 或 yyyy，欄位模式長度會被忽略，最佳匹配（以日期時間模式定義）會不尊重欄位模式字母長度（骨架）。 </ol>

我們支援的區間格式化日曆欄位包括：年、月、日期、星期、am-pm、時、小時、分鐘和秒（但目前尚無針對秒數骨架的具體 intervalFormat 資料）。 這些日曆欄位可依以下順序定義：年份 >月份 >日期 >am-pm >小時 >分鐘 >第二

兩個曆法之間最大的不同曆法欄位，依上述順序是第一個不同的曆法欄位。

例如：「2007年1月10日」與「2008年2月20日」之間最大的日曆欄位是年份。

有一組預先定義的靜態骨架串。 在各區域的資源檔案中，這些預設骨架有預先定義的區間模式。 例如，對於骨架YEAR_ABBR_MONTH_DAY，即「yMMMd」，在en_US中，如果date1與date2之間最大的不同日曆欄位是「year」，則日期間隔模式為「MMM d， yyyy - MMM d， yyyy」，例如「Jan 10， 2007 - January 10， 2008」。 如果 date1 與 date2 之間最大的不同日曆欄位是「month」，則日期間隔模式為「MMM d - MMM d， yyyy」，例如「January 10 - Feb 10， 2007」。 如果 date1 與 date2 之間最大的不同日曆欄位是「day」，則日期間隔模式為「MMM d-d， yyyy」，例如「January 10-20， 2007」。

對於日期骨架，當年份、月份或日期不同時，區間模式會在資源檔案中定義。 對於時間骨架，當上午/下午、整點或分鐘不同時，間隔模式會在資源檔案中定義。

有兩個日期以間隔模式排列。 對大多數地區來說，間隔模式中的第一個日期是較早的日期。 可能有地方，間隔模式中的第一個日期是較晚的日期。 我們使用備用格式來設定該地點的預設順序。 例如，如果備用格式為「{0} - {1}」，表示該地點區間模式的第一個日期是較早的日期。 如果備用格式是「{1} - {0}」，表示第一次日期是較晚的日期。 對於特定的區間模式，可以透過在區間模式前加上「latestFirst：」或「最早的First：」來覆蓋預設順序。 例如，如果備用格式是「{0}-{1}」，但對於骨架「yMMMd」，當日期不同時，區間模式為「latestFirst：d-d MMM yy」，這表示預設區間模式中的第一個日期是較早的日期。 但對於骨架「yMMMd」，當日期不同時，「d-d MMM yy」中的第一個日期就是較晚的日期。

建立 DateIntervalFormat 物件的建議方法是傳遞 local。 透過使用 Locale 參數，DateIntervalFormat 物件會以預設區域的預設區間模式初始化。

使用者也可以透過提供自己的區間模式來建立 DateIntervalFormat 物件。 它提供電力使用的彈性。

在建立 DateIntervalInfo 物件後，用戶端可依需求使用 setIntervalPattern 函式修改區間模式。 目前，使用者只能在以下日曆欄位不同時設定間隔模式：ERA、YEAR、MONTH、DATE、DAY_OF_MONTH、DAY_OF_WEEK、AM_PM、HOUR、HOUR_OF_DAY、MINUTE、SECOND 和 MILLISECOND。 當其他日曆欄位不同時，不支援區間模式。

DateIntervalInfo 物件是可複製的。 當客戶取得 DateIntervalInfo 物件時，可以隨時修改。

DateIntervalInfo 預計不會被子分類。 日曆的資料是從資源包中載入的。 根據 ICU 4.4，日期間隔模式僅支援於格里曆;非格里曆自 ICU 4.4.1 起支援。

Java 文件 android.icu.text.DateIntervalInfo。

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