OffsetDateTime.With メソッド
定義
重要
一部の情報は、リリース前に大きく変更される可能性があるプレリリースされた製品に関するものです。 Microsoft は、ここに記載されている情報について、明示または黙示を問わず、一切保証しません。
オーバーロード
| 名前 | 説明 |
|---|---|
| With(ITemporalAdjuster) |
この日時の調整されたコピーを返します。 |
| With(ITemporalField, Int64) |
指定したフィールドを新しい値に設定して、この日時のコピーを返します。 |
With(ITemporalAdjuster)
この日時の調整されたコピーを返します。
[Android.Runtime.Register("with", "(Ljava/time/temporal/TemporalAdjuster;)Ljava/time/OffsetDateTime;", "", ApiSince=26)]
public Java.Time.OffsetDateTime? With(Java.Time.Temporal.ITemporalAdjuster? adjuster);[<Android.Runtime.Register("with", "(Ljava/time/temporal/TemporalAdjuster;)Ljava/time/OffsetDateTime;", "", ApiSince=26)>]
member this.With : Java.Time.Temporal.ITemporalAdjuster -> Java.Time.OffsetDateTimeパラメーター
- adjuster
- ITemporalAdjuster
使用するアジャスターは null ではなく
返品
これに基づく OffsetDateTime で、null ではなく調整が行われました
- 属性
注釈
この日時の調整されたコピーを返します。 これにより、日付と時刻が調整された OffsetDateTime が返されます。 調整は、指定されたアジャスター戦略オブジェクトを使用して行われます。 アジャスターのドキュメントを読んで、どのような調整が行われるかを理解してください。 単純なアジャスターでは、年フィールドなどのフィールドの 1 つを単に設定できます。 より複雑な調整ツールでは、日付を月の最後の日に設定できます。 一般的な調整の選択は、TemporalAdjusters で提供されます。 これには、"月の最後の日" と "次の水曜日" の検索が含まれます。 主要な日時クラスでは、Month や MonthDay などの TemporalAdjuster インターフェイスも実装されます。 アジャスターは、月の長さや閏年などの特殊なケースを処理します。 たとえば、このコードは 7 月の最終日に日付を返します。LocalDate、LocalTime、ZoneOffset クラスは TemporalAdjuster を実装しているため、このメソッドを使用して日付、時刻、またはオフセットを変更できます。このメソッドの結果は、引数としてこれを渡す指定されたアジャスターで TemporalAdjuster.adjustInto(Temporal) メソッドを呼び出すことによって取得されます。 このインスタンスは不変であり、このメソッド呼び出しの影響を受けません。
適用対象
With(ITemporalField, Int64)
指定したフィールドを新しい値に設定して、この日時のコピーを返します。
[Android.Runtime.Register("with", "(Ljava/time/temporal/TemporalField;J)Ljava/time/OffsetDateTime;", "", ApiSince=26)]
public Java.Time.Temporal.ITemporal? With(Java.Time.Temporal.ITemporalField? field, long newValue);[<Android.Runtime.Register("with", "(Ljava/time/temporal/TemporalField;J)Ljava/time/OffsetDateTime;", "", ApiSince=26)>]
abstract member With : Java.Time.Temporal.ITemporalField * int64 -> Java.Time.Temporal.ITemporal
override this.With : Java.Time.Temporal.ITemporalField * int64 -> Java.Time.Temporal.ITemporalパラメーター
- field
- ITemporalField
null ではなく、結果で設定するフィールド
- newValue
- Int64
結果のフィールドの新しい値
返品
指定したフィールドが null ではなく設定された、これに基づく OffsetDateTime
実装
- 属性
注釈
指定したフィールドを新しい値に設定して、この日時のコピーを返します。 これにより、指定したフィールドの値が変更された OffsetDateTime が返されます。 これは、年、月、または月の日など、サポートされている任意のフィールドを変更するために使用できます。 フィールドがサポートされていないか、何らかの理由で値を設定できない場合は、例外がスローされます。 場合によっては、指定したフィールドを変更すると、結果の日時が無効になる場合があります。たとえば、月を 1 月 31 日から 2 月に変更すると、月の日が無効になる場合があります。 このような場合、フィールドは日付の解決を担当します。 通常は、前の有効な日付を選択します。この例では、2 月の最後の有効な日になります。 フィールドが ChronoField の場合、ここで調整が実装されます。 INSTANT_SECONDS フィールドは、指定したインスタントの日時を返します。 オフセットと nano-of-second は変更されません。 新しいインスタント値が有効な範囲外の場合は、DateTimeException がスローされます。 OFFSET_SECONDS フィールドは、指定したオフセットを持つ日時を返します。 ローカル日時は変更されません。 新しいオフセット値が有効な範囲外の場合は、DateTimeException がスローされます。 サポートされている他のフィールドは、LocalDateTime の一致するメソッドに従って動作します。 この場合、オフセットは計算の一部ではなく、変更されません。 他のすべての ChronoField インスタンスは、UnsupportedTemporalTypeException をスローします。 フィールドが ChronoField でない場合、このメソッドの結果は、TemporalField.adjustInto(Temporal, long) を引数として渡すことによって取得されます。 この場合、フィールドはインスタントを調整するかどうかと調整する方法を決定します。 このインスタンスは不変であり、このメソッド呼び出しの影響を受けません。