ZonedDateTime.With Méthode

Définition

Espace de noms:: Java.Time

Assembly:: Mono.Android.dll

Important

Certaines informations portent sur la préversion du produit qui est susceptible d’être en grande partie modifiée avant sa publication. Microsoft exclut toute garantie, expresse ou implicite, concernant les informations fournies ici.

Surcharges

Nom	Description
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.

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/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

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

ITemporal

ZonedDateTime basé sur ce paramètre avec le jeu de champs spécifié, et non null

Attributs: RegisterAttribute

Remarques

Retourne une copie de cette date-heure avec le champ spécifié défini sur une nouvelle valeur. Cette opération retourne une valeur ZonedDateTime, basée sur celle-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é. La zone et les nano-secondes sont inchangées. Le résultat aura un décalage dérivé de la nouvelle zone instantanée et d’origine. Si la nouvelle valeur instantanée est en dehors de la plage valide, une DateTimeException est levée. Le champ OFFSET_SECONDS est généralement ignoré. Le décalage d’une zonedDateTime est principalement contrôlé par le fuseau horaire. Par conséquent, la modification du décalage n’est généralement pas logique, car il n’y a qu’un seul décalage valide pour la date et le fuseau horaire local. Si la date-heure interzone se chevauche dans un chevauchement d’économies d’été, le décalage est utilisé pour basculer entre les deux décalages valides. Dans tous les autres cas, le décalage est ignoré. 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. La zone ne fait pas partie du calcul et n’est pas modifiée. Lors de la conversion en ZonedDateTime, si la date locale se chevauche, le décalage sera conservé si possible, sinon le décalage précédent sera utilisé. En cas d’écart, la date et l’heure locale sont ajustées à l’avant par la longueur de l’écart. 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.ZonedDateTime.with.

S’applique à

With(ITemporalAdjuster)

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

[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

Paramètres

adjuster: ITemporalAdjuster

l’ajusteur à utiliser, et non null

Retours

ZonedDateTime

une ZonedDateTime basée sur celle-ci avec l’ajustement effectué, et non null

Attributs: RegisterAttribute

Remarques

Retourne une copie ajustée de cette date-heure. Cette opération renvoie une valeur ZonedDateTime, basée sur celle-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 et LocalTime implémentent TemporalAdjuster. Ainsi, cette méthode peut être utilisée pour modifier la date, l’heure ou le décalage : ZoneOffset implémente également TemporalAdjuster, mais l’utiliser comme argument n’a généralement aucun effet. Le décalage d’une zonedDateTime est principalement contrôlé par le fuseau horaire. Par conséquent, la modification du décalage n’est généralement pas logique, car il n’y a qu’un seul décalage valide pour la date et le fuseau horaire local. Si la date-heure interzone se chevauche dans un chevauchement d’économies d’été, le décalage est utilisé pour basculer entre les deux décalages valides. Dans tous les autres cas, le décalage est ignoré. 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.ZonedDateTime.with.

S’applique à