DateTimeFormatter.WithChronology(IChronology) メソッド

[Android.Runtime.Register("withChronology", "(Ljava/time/chrono/Chronology;)Ljava/time/format/DateTimeFormatter;", "", ApiSince=26)]
public Java.Time.Format.DateTimeFormatter? WithChronology(Java.Time.Chrono.IChronology? chrono);

[<Android.Runtime.Register("withChronology", "(Ljava/time/chrono/Chronology;)Ljava/time/format/DateTimeFormatter;", "", ApiSince=26)>]
member this.WithChronology : Java.Time.Chrono.IChronology -> Java.Time.Format.DateTimeFormatter

パラメーター

返品

このフォーマッタに基づくフォーマッタと、null ではなく、要求されたオーバーライドの時系列

属性

RegisterAttribute

注釈

新しいオーバーライドの時系列を使用して、このフォーマッタのコピーを返します。

これにより、このフォーマッタと同様の状態のフォーマッタが返されますが、オーバーライドの時系列セットが返されます。 既定では、フォーマッタにはオーバーライドクロノロジーがなく、null が返されます。

オーバーライドが追加されると、書式設定または解析された日付が影響を受ける可能性があります。

書式設定時に、テンポラル オブジェクトに日付が含まれている場合は、オーバーライドの時系列の日付に変換されます。 テンポラルに日付が含まれているかどうかは、 ChronoField#EPOCH_DAY EPOCH_DAY フィールドに対してクエリを実行することによって決定されます。 オーバーライドされない限り、任意の時刻またはゾーンは変更されません。

テンポラル オブジェクトに日付が含まれていなくても、1 つ以上の ChronoField 日付フィールドが含まれている場合は、 DateTimeException がスローされます。 それ以外の場合は、オーバーライドの時系列がテンポラルに追加され、以前の時系列は置き換えられますが、日付/時刻は変更されません。

解析時には、2 つの異なるケースを考慮する必要があります。 DateTimeFormatterBuilder#appendChronologyId()が使用された可能性があるために、時系列がテキストから直接解析されている場合、このオーバーライドの時系列は無効になります。 ゾーンが解析されていない場合、このオーバーライドの時系列は、 ChronoField 値を時系列の解決規則に従って日付に解釈するために使用されます。

このインスタンスは不変であり、このメソッド呼び出しの影響を受けません。

Javaドキュメント。

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