ZonedDateTime.With Methode

Definition

Namespace:: Java.Time

Assembly:: Mono.Android.dll

Wichtig

Einige Informationen beziehen sich auf Vorabversionen, die vor dem Release ggf. grundlegend überarbeitet werden. Microsoft übernimmt hinsichtlich der hier bereitgestellten Informationen keine Gewährleistungen, seien sie ausdrücklich oder konkludent.

Überlädt

Name	Beschreibung
With(ITemporalField, Int64)	Gibt eine Kopie dieser Datums-Uhrzeit zurück, bei der das angegebene Feld auf einen neuen Wert festgelegt ist.
With(ITemporalAdjuster)	Gibt eine angepasste Kopie dieser Datums-Uhrzeit zurück.

With(ITemporalField, Int64)

Gibt eine Kopie dieser Datums-Uhrzeit zurück, bei der das angegebene Feld auf einen neuen Wert festgelegt ist.

[Android.Runtime.Register("with", "(Ljava/time/temporal/TemporalField;J)Ljava/time/ZonedDateTime;", "", 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/ZonedDateTime;", "", 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

field: ITemporalField

das Feld, das im Ergebnis festgelegt werden soll, nicht NULL

newValue: Int64

der neue Wert des Felds im Ergebnis

Gibt zurück

ITemporal

eine ZonedDateTime basierend auf dieser Mit dem angegebenen Feldsatz, nicht null

Attribute: RegisterAttribute

Hinweise

Gibt eine Kopie dieser Datums-Uhrzeit zurück, bei der das angegebene Feld auf einen neuen Wert festgelegt ist. Dadurch wird ein ZonedDateTime-Wert zurückgegeben, basierend auf diesem, 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. Die Zone und nano-of-second sind unverändert. Das Ergebnis hat einen Offset, der von der neuen sofort- und ursprünglichen Zone abgeleitet wird. Wenn sich der neue Sofortwert außerhalb des gültigen Bereichs befindet, wird eine DateTimeException ausgelöst. Das feld OFFSET_SECONDS wird in der Regel ignoriert. Der Offset einer ZonedDateTime wird in erster Linie durch die Zeitzone gesteuert. Das Ändern des Offsets ist in der Regel nicht sinnvoll, da nur ein gültiger Offset für die lokale Datums- und Zeitzone vorhanden ist. Wenn sich die zonenbezogene Datums-/Uhrzeit in einer Sommerzeit überlappen, wird der Offset verwendet, um zwischen den beiden gültigen Offsets zu wechseln. In allen anderen Fällen wird der Offset ignoriert. 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. Die Zone ist nicht Teil der Berechnung und bleibt unverändert. Bei der Konvertierung zurück in ZonedDateTime, wenn sich die lokale Datum-Uhrzeit in einer Überlappung befindet, wird der Offset nach Möglichkeit beibehalten, andernfalls wird der frühere Offset verwendet. Bei einer Lücke wird die lokale Datum-Uhrzeit um die Länge der Lücke vorwärts angepasst. 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.ZonedDateTime.with.

Gilt für:

With(ITemporalAdjuster)

Gibt eine angepasste Kopie dieser Datums-Uhrzeit zurück.

[Android.Runtime.Register("with", "(Ljava/time/temporal/TemporalAdjuster;)Ljava/time/ZonedDateTime;", "", ApiSince=26)]
public Java.Time.ZonedDateTime? With(Java.Time.Temporal.ITemporalAdjuster? adjuster);

[<Android.Runtime.Register("with", "(Ljava/time/temporal/TemporalAdjuster;)Ljava/time/ZonedDateTime;", "", ApiSince=26)>]
member this.With : Java.Time.Temporal.ITemporalAdjuster -> Java.Time.ZonedDateTime

Parameter

adjuster: ITemporalAdjuster

der zu verwendende Anpassungs-, nicht NULL-Wert

Gibt zurück

ZonedDateTime

ein ZonedDateTime-Wert basierend auf dieser Anpassung, nicht null

Attribute: RegisterAttribute

Hinweise

Gibt eine angepasste Kopie dieser Datums-Uhrzeit zurück. Dies gibt einen ZonedDateTime-Wert zurück, basierend auf diesem, wobei die Datums-/Uhrzeit angepasst wurde. 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 und LocalTime implementieren TemporalAdjuster, damit diese Methode verwendet werden kann, um Datum, Uhrzeit oder Offset zu ändern: ZoneOffset implementiert auch TemporalAdjuster, jedoch als Argument in der Regel keine Auswirkung. Der Offset einer ZonedDateTime wird in erster Linie durch die Zeitzone gesteuert. Das Ändern des Offsets ist in der Regel nicht sinnvoll, da nur ein gültiger Offset für die lokale Datums- und Zeitzone vorhanden ist. Wenn sich die zonenbezogene Datums-/Uhrzeit in einer Sommerzeit überlappen, wird der Offset verwendet, um zwischen den beiden gültigen Offsets zu wechseln. In allen anderen Fällen wird der Offset ignoriert. Das Ergebnis dieser Methode wird durch Aufrufen der TemporalAdjuster.adjustInto(Temporal)-Methode für den angegebenen Anpassungsparameter abgerufen, der dies als Argument übergibt. Diese Instanz ist unveränderlich und von diesem Methodenaufruf nicht betroffen.

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

Gilt für: