OffsetDateTime.With Methode

[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

Parameter

Gibt zurück

einen OffsetDateTime-Wert basierend auf dieser Anpassung, nicht null

Attribute

RegisterAttribute

Hinweise

Gibt eine angepasste Kopie dieser Datums-Uhrzeit zurück. Dies gibt einen OffsetDateTime-Wert zurück, der auf dieser Grundlage mit angepasster Datums- und Uhrzeitangabe basiert. Die Anpassung erfolgt mithilfe des angegebenen Anpassungsstrategieobjekts. Lesen Sie die Dokumentation des Anpassungers, um zu verstehen, welche Anpassung vorgenommen wird. Eine einfache Anpassung kann einfach das eines der Felder festlegen, z. B. das Feld "Jahr". Eine komplexere Anpassung kann das Datum auf den letzten Tag des Monats festlegen. Eine Auswahl allgemeiner Anpassungen wird in TemporalAdjusters bereitgestellt. Dazu gehören die Suche nach dem "letzten Tag des Monats" und "nächster Mittwoch". Wichtige Datum-Uhrzeit-Klassen implementieren auch die TemporalAdjuster-Schnittstelle, z. B. Month und MonthDay. Der Anpassungsregler ist für die Behandlung von Sonderfällen verantwortlich, z. B. die unterschiedlichen Längen von Monat und Schaltjahren. Dieser Code gibt z. B. ein Datum am letzten Juli zurück: Die Klassen LocalDate, LocalTime und ZoneOffset implementieren TemporalAdjuster, damit diese Methode verwendet werden kann, um das Datum, die Uhrzeit oder den Offset zu ändern: Das Ergebnis dieser Methode wird durch Aufrufen der TemporalAdjuster.adjustInto(Temporal)-Methode für die angegebene Anpassungsfunktion abgerufen, die dies als Argument übergibt. Diese Instanz ist unveränderlich und von diesem Methodenaufruf nicht betroffen.

Java Referenz für java.time.OffsetDateTime.with.

[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

Parameter

Gibt zurück

einen OffsetDateTime-Wert basierend auf diesem Wert mit dem angegebenen Feldsatz, nicht null

Implementiert

Attribute

RegisterAttribute

Hinweise

Gibt eine Kopie dieser Datums-Uhrzeit zurück, bei der das angegebene Feld auf einen neuen Wert festgelegt ist. Dies gibt einen OffsetDateTime-Wert zurück, basierend auf diesem Wert, wobei der Wert für das angegebene Feld geändert wurde. Dies kann verwendet werden, um jedes unterstützte Feld zu ändern, z. B. das Jahr, den Monat oder den Tag des Monats. Wenn es nicht möglich ist, den Wert festzulegen, da das Feld nicht unterstützt wird oder aus einem anderen Grund, wird eine Ausnahme ausgelöst. In einigen Fällen kann das Ändern des angegebenen Felds dazu führen, dass die resultierende Datums-Uhrzeit ungültig wird, z. B. das Ändern des Monats von 31. Januar bis Februar, zu einer ungültigen Tageszeit. In solchen Fällen ist das Feld für die Auflösung des Datums verantwortlich. In der Regel wird das vorherige gültige Datum ausgewählt, bei dem es sich um den letzten gültigen Tag im Februar in diesem Beispiel handelt. Wenn es sich bei dem Feld um ein ChronoField handelt, wird die Anpassung hier implementiert. Das feld INSTANT_SECONDS gibt eine Datum-Uhrzeit mit dem angegebenen Instant zurück. Der Offset und nano-of-second sind unverändert. Wenn sich der neue Sofortwert außerhalb des gültigen Bereichs befindet, wird eine DateTimeException ausgelöst. Das feld OFFSET_SECONDS gibt eine Datum-Uhrzeit mit dem angegebenen Offset zurück. Die lokale Datums-/Uhrzeit ist unverändert. Wenn sich der neue Offsetwert außerhalb des gültigen Bereichs befindet, wird eine DateTimeException ausgelöst. Die anderen unterstützten Felder verhalten sich gemäß der übereinstimmenden Methode in LocalDateTime. In diesem Fall ist der Offset nicht Teil der Berechnung und bleibt unverändert. Alle anderen ChronoField-Instanzen lösen eine UnsupportedTemporalTypeException aus. Wenn es sich bei dem Feld nicht um ein ChronoField handelt, wird das Ergebnis dieser Methode durch Aufrufen von TemporalField.adjustInto(Temporal, long) abgerufen, das als Argument übergeben wird. In diesem Fall bestimmt das Feld, ob und wie der Sofortige angepasst werden soll. Diese Instanz ist unveränderlich und von diesem Methodenaufruf nicht betroffen.

Java Referenz für java.time.OffsetDateTime.with.