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> はフィールド パターン文字のみを保持し、スペース、句読点、文字列リテラルなど、パターン内の他のすべての部分を無視します。 <li> フィールドの順序を非表示にします。 <li> はフィールドのパターン文字の長さを隠す可能性があります。

これらの数字以外のカレンダー フィールドでは、MMM、MMMM、MMMMM などのパターン文字の長さが重要です。EEE と EEEE、およびフィールドのパターン文字の長さが優先されます。

M、MM、d、dd、yy、yyyy などの数字カレンダー フィールドの場合、フィールド パターンの長さは無視され、日付時刻パターンで定義されている最適な一致は、スケルトンのフィールド パターン文字の長さを優先せずに返されます。 </ol>

間隔の書式設定でサポートされているカレンダー フィールドは、年、月、日付、曜日、am-pm、時間、時間、時刻、分、秒です (ただし、現在、秒を持つスケルトンの特定の intervalFormat データはありません)。 これらのカレンダー フィールドは、次の順序で定義できます。month >date >am-pm >hour >minute >second

2 つの予定表間の最大の異なる予定表フィールドは、上記の順序で最初に異なる予定表フィールドです。

たとえば、"Jan 10, 2007" と "Feb 20, 2008" の間の最大の異なるカレンダー フィールドは年です。

定義済みの静的スケルトン文字列のセットがあります。 ロケールのリソース ファイル内の事前に定義されたスケルトンには、事前に定義された間隔パターンがあります。 たとえば、"yMMMd" であるスケルトン YEAR_ABBR_MONTH_DAYの場合、en_USでは、date1 と date2 の最大の異なるカレンダー フィールドが "year" の場合、日付間隔パターンは "MMM d, yyyy - MMM d, yyyy" になります (例: "Jan 10, 2007 - Jan 10, 2008")。 date1 と date2 の最大の異なるカレンダー フィールドが "month" の場合、日付間隔パターンは "MMM d - MMM d, yyyy" です (例: "Jan 10 - Feb 10, 2007" など)。 date1 と date2 の間の最大の異なるカレンダー フィールドが "day" の場合、日付間隔パターンは "MMM d-d, yyyy" です ("Jan 10-20, 2007" など)。

日付スケルトンの場合、年、月、または日付が異なる間隔パターンがリソース ファイルで定義されます。 時間スケルトンの場合、am/pm または hour または minute が異なる間隔パターンがリソース ファイルで定義されます。

間隔パターンには 2 つの日付があります。 ほとんどのロケールでは、間隔パターンの最初の日付は前の日付です。 間隔パターンの最初の日付が後の日付であるロケールがある場合があります。 ロケールの既定の順序にはフォールバック形式を使用します。 たとえば、フォールバック形式が "{0} - {1}" の場合は、このロケールの間隔パターンの最初の日付が以前の日付であることを意味します。 フォールバック形式が "{1} - {0}" の場合は、最初の日付が後の日付であることを意味します。 特定の間隔パターンの場合、既定の順序は、間隔パターンに "latestFirst:" または "earliestFirst:" というプレフィックスを付けることでオーバーライドできます。 たとえば、フォールバック形式が "{0}-{1}" ですが、スケルトン "yMMMd" の場合、日が異なる間隔パターンは "latestFirst:d-d MMM yy" であり、既定では、間隔パターンの最初の日付が前の日付であることを意味します。 しかし、スケルトン "yMMMd" の場合、日が異なる場合、"d-d MMM yy" の最初の日付は後日になります。

DateIntervalFormat オブジェクトを作成する推奨される方法は、ロケールを渡すことです。 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ドキュメント。

このページの一部は、によって作成および共有され、に記載されている条件に従って使用される作業に基づく変更です。