Langage

OffsetDateTime.With Méthode

Définition

Surcharges

Nom Description
With(ITemporalAdjuster)

Retourne une copie ajustée de cette date-heure.

With(ITemporalField, Int64)

Retourne une copie de cette date-heure avec le champ spécifié défini sur une nouvelle valeur.

With(ITemporalAdjuster)

Retourne une copie ajustée de cette date-heure.

[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

Paramètres

adjuster
ITemporalAdjuster

l’ajusteur à utiliser, et non null

Retours

offsetDateTime basé sur ceci avec l’ajustement effectué, et non null

Attributs

Remarques

Retourne une copie ajustée de cette date-heure. Cela retourne un OffsetDateTime, basé sur celui-ci, avec l’heure de date ajustée. L’ajustement a lieu à l’aide de l’objet de stratégie d’ajustement spécifié. Lisez la documentation de l’ajusteur pour comprendre ce que sera fait l’ajustement. Un ajusteur simple peut simplement définir l’un des champs, comme le champ année. Un ajusteur plus complexe peut définir la date du dernier jour du mois. Une sélection des ajustements courants est fournie dans TemporalAdjusters. Il s’agit notamment de trouver le « dernier jour du mois » et le « mercredi prochain ». Les classes date/heure clés implémentent également l’interface TemporalAdjuster, telle que Month et MonthDay. L’ajusteur est responsable de la gestion de cas spéciaux, tels que les durées variables du mois et des années bissextiles. Par exemple, ce code retourne une date le dernier jour de juillet : les classes LocalDate, LocalTime et ZoneOffset implémentent TemporalAdjuster. Ainsi, cette méthode peut être utilisée pour modifier la date, l’heure ou le décalage : le résultat de cette méthode est obtenu en appelant la méthode TemporalAdjuster.adjustInto(Temporal) sur l’ajusteur spécifié en passant cela en tant qu’argument. Cette instance est immuable et non affectée par cet appel de méthode.

Java référence pour java.time.OffsetDateTime.with.

S’applique à

With(ITemporalField, Int64)

Retourne une copie de cette date-heure avec le champ spécifié défini sur une nouvelle valeur.

[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

Paramètres

field
ITemporalField

champ à définir dans le résultat, et non null

newValue
Int64

nouvelle valeur du champ dans le résultat

Retours

OffsetDateTime basé sur ceci avec le jeu de champs spécifié, et non null

Implémente

Attributs

Remarques

Retourne une copie de cette date-heure avec le champ spécifié défini sur une nouvelle valeur. Cela retourne un OffsetDateTime, basé sur celui-ci, avec la valeur du champ spécifié modifié. Cela peut être utilisé pour modifier n’importe quel champ pris en charge, tel que l’année, le mois ou le jour du mois. S’il n’est pas possible de définir la valeur, car le champ n’est pas pris en charge ou pour une autre raison, une exception est levée. Dans certains cas, la modification du champ spécifié peut entraîner l’invalidation de la date-heure résultante, par exemple la modification du mois du 31 janvier au février rend le jour du mois non valide. Dans les cas comme celui-ci, le champ est responsable de la résolution de la date. En règle générale, il choisira la date valide précédente, qui serait le dernier jour valide de février dans cet exemple. Si le champ est un ChronoField, l’ajustement est implémenté ici. Le champ INSTANT_SECONDS retourne une date/heure avec l’instant spécifié. Le décalage et la nano-seconde sont inchangés. Si la nouvelle valeur instantanée est en dehors de la plage valide, une DateTimeException est levée. Le champ OFFSET_SECONDS retourne une date-heure avec le décalage spécifié. L’heure de date locale n’est pas inchangée. Si la nouvelle valeur de décalage se trouve en dehors de la plage valide, une exception DateTimeException est levée. Les autres champs pris en charge se comportent conformément à la méthode correspondante sur LocalDateTime. Dans ce cas, le décalage ne fait pas partie du calcul et sera inchangé. Toutes les autres instances ChronoField lèvent une exception UnsupportedTemporalTypeException. Si le champ n’est pas un ChronoField, le résultat de cette méthode est obtenu en appelant TemporalField.adjustInto(Temporal, long) en passant cela en tant qu’argument. Dans ce cas, le champ détermine si et comment ajuster l’instant. Cette instance est immuable et non affectée par cet appel de méthode.

Java référence pour java.time.OffsetDateTime.with.

S’applique à