DateUtils.FormatDateRange メソッド

定義

名前空間:: Android.Text.Format

アセンブリ:: Mono.Android.dll

重要

一部の情報は、リリース前に大きく変更される可能性があるプレリリースされた製品に関するものです。 Microsoft は、ここに記載されている情報について、明示または黙示を問わず、一切保証しません。

オーバーロード

名前	説明
FormatDateRange(Context, Int64, Int64, FormatStyleFlags)	ローカル規則に従って日付または時刻の範囲を書式設定します。
FormatDateRange(Context, Formatter, Int64, Int64, FormatStyleFlags)	ローカル規則に従って日付または時刻の範囲を書式設定します。
FormatDateRange(Context, Formatter, Int64, Int64, FormatStyleFlags, String)	ローカル規則に従って日付または時刻の範囲を書式設定します。

FormatDateRange(Context, Int64, Int64, FormatStyleFlags)

ローカル規則に従って日付または時刻の範囲を書式設定します。

[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

パラメーター

context: Context

コンテキストは、時刻が表示されている場合にのみ必要です

startMillis: Int64

開始時刻 (UTC ミリ秒)

endMillis: Int64

終了時刻 (UTC ミリ秒)

flags: FormatStyleFlags

オプションのビットマスクを参照してください。 #formatDateRange(Context, Formatter, long, long, int, String) formatDateRange

返品

String

書式設定された日付/時刻範囲を含む文字列。

属性: RegisterAttribute

注釈

ローカル規則に従って日付または時刻の範囲を書式設定します。

これは便利な方法であることに注意してください。これを使用するには、内部 java.util.Formatter インスタンスをオンザフライで作成する必要があります。これは、メモリと時間の面で多少コストがかかります。これは、このメソッドをほとんど使用しない場合に許容される可能性がありますが、多数の日付の書式設定に依存する場合は、独自のjava.util.Formatter インスタンスを作成して再利用し、java.util.Formatterを受け取る#formatDateRange(Context, long, long, int) formatDateRangeのバージョンを使用することを検討してください。

Javaドキュメント。

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

適用対象

FormatDateRange(Context, Formatter, Int64, Int64, FormatStyleFlags)

ローカル規則に従って日付または時刻の範囲を書式設定します。

[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

パラメーター

context: Context

コンテキストは、時刻が表示されている場合にのみ必要です

formatter: Formatter

日付範囲の書式設定に使用するフォーマッタ。注: 結果を蓄積する必要がない限り、Formatter コンストラクターに渡された StringBuilder で setLength(0) を必ず呼び出してください。

startMillis: Int64

開始時刻 (UTC ミリ秒)

endMillis: Int64

終了時刻 (UTC ミリ秒)

flags: FormatStyleFlags

オプションのビットマスクを参照してください。 #formatDateRange(Context, Formatter, long, long, int, String) formatDateRange

返品

Formatter

書式設定された日付/時刻範囲を含む文字列。

属性: RegisterAttribute

注釈

ローカル規則に従って日付または時刻の範囲を書式設定します。

これは、ローカルタイムゾーンの日付または時刻範囲を書式設定するための便利な方法であることに注意してください。タイムゾーンを指定する場合は、 #formatDateRange(Context, Formatter, long, long, int, String) formatDateRangeを使用してください。

Javaドキュメント。

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

適用対象

FormatDateRange(Context, Formatter, Int64, Int64, FormatStyleFlags, String)

ローカル規則に従って日付または時刻の範囲を書式設定します。

[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

パラメーター

context: Context

コンテキストは、時刻が表示されている場合にのみ必要です

formatter: Formatter

startMillis: Int64

開始時刻 (UTC ミリ秒)

endMillis: Int64

終了時刻 (UTC ミリ秒)

flags: FormatStyleFlags

オプションのビットマスク

timeZone: String

文字列を計算するタイムゾーンの ID。ローカルの場合、または FORMAT_UTC フラグが使用されている場合は null を使用します。

返品

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>Oct 9</li><li>Tue, Oct 9</li><li>October 9, 2007</li><li>Oct 9 - 10</li><li>Oct 9 - 10, 2007</li><li>Oct 28 - 2007 年 11 月 3 日</li><li>Dec 31, 2007 - 2008 年 1 月 1 日</li><li>Oct 9, 8:00am - 10 月 10 日午後 5:00 </li><li>12/31/2007 - 01/01/2008</li></ul>

flags 引数は、次のリストのオプションのビットマスクです。

<ul><li>FORMAT_SHOW_TIME</li><li>FORMAT_SHOW_WEEKDAY</li><li>FORMAT_SHOW_YEAR</li><li>FORMAT_SHOW_DATE</li><li>FORMAT_NO_MONTH_DAY</li><li>FORMAT_12HOUR</li><li>FORMAT_24HOUR</li><li>FORMAT_CAP_AMPM</li><li>FORMAT_NO_NOON</li><li>FORMAT_CAP_NOON</li><li>FORMAT_NO_MIDNIGHT</li><li>FORMAT_CAP_MIDNIGHT</li><li>FORMAT_UTC</li><li>FORMAT_ABBREV_TIME</li><li>FORMAT_ABBREV_WEEKDAY</li><li>FORMAT_ABBREV_MONTH</li><li>FORMAT_ABBREV_ALL</>< li>FORMAT_NUMERIC_DATE</li></ul>

FORMAT_SHOW_TIMEが設定されている場合、時刻は日付範囲の一部として表示されます。開始時刻と終了時刻が同じ場合は、開始時刻だけが表示されます。

FORMAT_SHOW_WEEKDAYが設定されている場合は、平日が表示されます。

FORMAT_SHOW_YEARが設定されている場合、年は常に表示されます。 FORMAT_SHOW_YEARが設定されていない場合、その年は現在の年と異なる場合、または開始日と終了日が異なる年に当てはまる場合にのみ表示されます。

通常、開始日と終了日が同じでない限り、日付が表示されます。 FORMAT_SHOW_DATEが設定されている場合は、同じ日の範囲であっても、常に日付が表示されます。

FORMAT_NO_MONTH_DAYが設定されている場合、日付が表示されている場合は、月の日ではなく、月の名前だけが表示されます。たとえば、"2008 年 1 月 6 日から 12 日" ではなく "2008 年 1 月" とします。

FORMAT_CAP_AMPMが設定され、12 時間の時間が使用される場合、"AM" と "PM" は大文字になります。一部のロケールでは、これらの用語を大文字にすることはできず、他の多くのロケールでは可能であってもそうすることは理にかなっていないため、このフラグを使用しないでください。

FORMAT_NO_NOONが設定され、12 時間の時間が使用されている場合は、"正午" ではなく "午後 12 時" が表示されます。

FORMAT_CAP_NOONが設定され、12 時間の時間が使用されている場合は、"正午" ではなく "Noon" が表示されます。多くのロケールでは用語を大文字にすることは理にかなわないので、おそらくこのフラグを使用しないでください。

FORMAT_NO_MIDNIGHTが設定され、12 時間の時間が使用されている場合は、"午前 0 時" ではなく "午前 12 時" が表示されます。

FORMAT_CAP_MIDNIGHTが設定され、12 時間の時間が使用されている場合は、"午前 0 時" ではなく "午前 0 時" が表示されます。多くのロケールでは用語を大文字にすることは理にかなわないので、おそらくこのフラグを使用しないでください。

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 時間の時刻形式が使用されている場合、開始時刻と終了時刻 (表示されている場合) は、0 の場合は分を表示しないことで省略されます。たとえば、"3:00pm" の代わりに、時刻は "3pm" と省略されます。

FORMAT_ABBREV_WEEKDAYが設定されている場合、曜日 (表示されている場合) は 3 文字の文字列に省略されます。

FORMAT_ABBREV_MONTHが設定されている場合、月 (表示されている場合) は 3 文字の文字列に省略されます。

FORMAT_ABBREV_ALLが設定されている場合、曜日と月 (表示されている場合) は 3 文字の文字列に省略されます。

FORMAT_NUMERIC_DATEが設定されている場合、日付は月の名前を使用する代わりに数値形式で表示されます。たとえば、"2008 年 12 月 31 日" ではなく "12/31/2008" とします。

終了日が 1 日の初めに午前 12 時に終了する場合、2 つのシナリオ ( <ul><li>1 日のイベントの場合) で前日の終わりとして書式設定されます。その結果、"11 月 10 日、午後 8 時 - 11 月 11 日午前 12 時" ではなく "8pm - 深夜" になります</li><li>時刻が表示されない場合。これにより、開始日が 11 月 10 日、終了日が 11 月 12 日のイベントの "11 月 10 日から 11 月 11 日" が 00:00.</li></ul>

Javaドキュメント。

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

適用対象