ZonedDateTime Classe
Définition
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.
Date/heure avec un fuseau horaire dans le système de calendrier ISO-8601, tel que 2007-12-03T10:15:30+01:00 Europe/Paris.
[Android.Runtime.Register("java/time/ZonedDateTime", ApiSince=26, DoNotGenerateAcw=true)]
public sealed class ZonedDateTime : Java.Lang.Object, IDisposable, Java.IO.ISerializable, Java.Time.Chrono.IChronoZonedDateTime[<Android.Runtime.Register("java/time/ZonedDateTime", ApiSince=26, DoNotGenerateAcw=true)>]
type ZonedDateTime = class
inherit Object
interface ISerializable
interface IJavaObject
interface IDisposable
interface IJavaPeerable
interface IChronoZonedDateTime
interface IComparable
interface ITemporal
interface ITemporalAccessor- Héritage
- Attributs
- Implémente
Remarques
Date/heure avec un fuseau horaire dans le système de calendrier ISO-8601, tel que 2007-12-03T10:15:30+01:00 Europe/Paris.
ZonedDateTime est une représentation immuable d’une date-heure avec un fuseau horaire. Cette classe stocke tous les champs de date et d’heure, à une précision de nanosecondes et un fuseau horaire, avec un décalage de zone utilisé pour gérer les dates locales ambiguës. Par exemple, la valeur « 2 octobre 2007 à 13:45.30.123456789 +02:00 dans le fuseau horaire Europe/Paris » peut être stockée dans un ZonedDateTime.
Cette classe gère la conversion de la ligne de temps locale vers LocalDateTime la ligne de temps instantanée de Instant. La différence entre les deux lignes de temps est le décalage de UTC/Greenwich, représenté par un ZoneOffset.
La conversion entre les deux lignes de temps implique le calcul du décalage à l’aide de l’accès ZoneRules rules à partir du ZoneId. L’obtention du décalage pour un instant est simple, car il existe exactement un décalage valide pour chaque instant. En revanche, l’obtention du décalage pour une date-heure locale n’est pas simple. Il existe trois cas : <ul><li>Normal, avec un décalage valide. Pour la grande majorité de l’année, le cas normal s’applique, où il existe un décalage valide unique pour la date-heure locale.</li><gap>, avec zéro décalage valide. C’est là que les horloges avancent généralement en raison des économies d’été du printemps qui passent de « l’hiver » à « l’été ». Dans un écart, il existe des valeurs de date/heure locales sans décalage valide.</li><li>Chevauchement, avec deux décalages valides. C’est là que les horloges sont mises en arrière généralement en raison du changement d’été de l’été à l’hiver. Dans un chevauchement, il existe des valeurs de date/heure locales avec deux décalages valides.</li></ul>
Toute méthode qui convertit directement ou implicitement d’une date-heure locale en un instant en obtenant le décalage peut être compliquée.
Pour les écarts, la stratégie générale est que si la date-heure locale tombe au milieu d’un intervalle, l’heure de date interzone résultante aura une date-heure locale décalée vers l’avant par la longueur de l’intervalle, ce qui entraîne une date-heure dans le décalage ultérieur, généralement l’heure d’été.
Pour les chevauchements, la stratégie générale est que si la date locale tombe au milieu d’un chevauchement, le décalage précédent sera conservé. S’il n’existe aucun décalage précédent ou si le décalage précédent n’est pas valide, le décalage précédent est utilisé, généralement l’heure d’été. Deux méthodes supplémentaires, et #withEarlierOffsetAtOverlap(), #withLaterOffsetAtOverlap() aident à gérer le cas d’un chevauchement.
En termes de conception, cette classe doit être vue principalement comme la combinaison d’un LocalDateTime et d’un ZoneId. Il ZoneOffset s’agit d’un élément d’information vital, mais secondaire, utilisé pour s’assurer que la classe représente un instant, en particulier pendant un chevauchement d’économies d’été.
Ajouté dans la version 1.8.
Java documentation pour java.time.ZonedDateTime.
Les parties de cette page sont des modifications basées sur le travail créé et partagé par Android Open Source et utilisées en fonction des termes décrits dans la Creative Commons 2.5 Attribution License.
Propriétés
| Nom | Description |
|---|---|
| Class |
Retourne la classe runtime de ce |
| DayOfMonth |
Obtient le champ jour du mois. |
| DayOfWeek |
Obtient le champ jour de semaine, qui est une énumération DayOfWeek. |
| DayOfYear |
Obtient le champ jour de l’année. |
| Handle |
Handle de l’instance Android sous-jacente. (Hérité de Object) |
| Hour |
Obtient le champ heure de jour. |
| JniIdentityHashCode |
Obtient le code de hachage d’identité affecté à cet homologue Java par le runtime d’interopérabilité. (Hérité de Object) |
| JniManagedPeerState |
Date/heure avec un fuseau horaire dans le système de calendrier ISO-8601, tel que |
| JniPeerMembers |
Date/heure avec un fuseau horaire dans le système de calendrier ISO-8601, tel que |
| Minute |
Obtient le champ minute-of-hour. |
| Month |
Obtient le champ mois de l’année à l’aide de l’énumération Mois. |
| MonthValue |
Obtient le champ mois d’année de 1 à 12. |
| Nano |
Obtient le champ nano-de-seconde. |
| Offset |
Obtient le décalage de zone, tel que « +01:00 ». |
| PeerReference |
Obtient la référence d’objet JNI pour cet homologue Java. (Hérité de Object) |
| Second |
Obtient le champ de seconde minute. |
| ThresholdClass |
Cette API prend en charge l’infrastructure Mono pour Android et n’est pas destinée à être utilisée directement à partir de votre code. (Hérité de Object) |
| ThresholdType |
Cette API prend en charge l’infrastructure Mono pour Android et n’est pas destinée à être utilisée directement à partir de votre code. (Hérité de Object) |
| Year |
Obtient le champ année. |
| Zone |
Obtient le fuseau horaire, tel que « Europe/Paris ». |
Méthodes
| Nom | Description |
|---|---|
| Clone() |
Crée et retourne une copie de cet objet. (Hérité de Object) |
| CompareTo(Object) |
Date/heure avec un fuseau horaire dans le système de calendrier ISO-8601, tel que |
| Construct(JniObjectReference, JniObjectReferenceOptions) |
Date/heure avec un fuseau horaire dans le système de calendrier ISO-8601, tel que |
| Dispose() |
Libère les ressources détenues par cet homologue Java. (Hérité de Object) |
| Dispose(Boolean) |
Libère les ressources détenues par cet homologue Java. (Hérité de Object) |
| DisposeUnlessReferenced() |
Date/heure avec un fuseau horaire dans le système de calendrier ISO-8601, tel que |
| Equals(Object) |
Date/heure avec un fuseau horaire dans le système de calendrier ISO-8601, tel que |
| Equals(Object) |
Indique si un autre objet est « égal à » celui-ci. (Hérité de Object) |
| Format(DateTimeFormatter) |
Met en forme cette date-heure à l’aide du formateur spécifié. |
| From(ITemporalAccessor) |
Obtient une instance de ZonedDateTime à partir d’un objet temporel. |
| Get(ITemporalField) |
Obtient la valeur du champ spécifié à partir de cette date-heure sous forme d’int. |
| GetHashCode() |
Retourne une valeur de code de hachage pour l’objet. (Hérité de Object) |
| GetLong(ITemporalField) |
Obtient la valeur du champ spécifié à partir de cette date-heure à long terme. |
| IsSupported(ITemporalField) |
Vérifie si le champ spécifié est pris en charge. |
| IsSupported(ITemporalUnit) |
Vérifie si l’unité spécifiée est prise en charge. |
| JavaFinalize() |
Appelé par le garbage collector sur un objet lorsque le garbage collection détermine qu’il n’y a plus de références à l’objet. (Hérité de Object) |
| Minus(Int64, ITemporalUnit) |
Retourne une copie de cette date-heure avec le montant spécifié soustrait. |
| Minus(ITemporalAmount) |
Retourne une copie de cette date-heure avec le montant spécifié soustrait. |
| MinusDays(Int64) |
Retourne une copie de cette ZonedDateTime avec le nombre de jours spécifié soustrait. |
| MinusHours(Int64) |
Retourne une copie de cette ZonedDateTime avec le nombre d’heures spécifié soustrait. |
| MinusMinutes(Int64) |
Retourne une copie de cette ZonedDateTime avec le nombre spécifié de minutes soustractées. |
| MinusMonths(Int64) |
Retourne une copie de cette ZonedDateTime avec le nombre spécifié de mois soustraits. |
| MinusNanos(Int64) |
Retourne une copie de cette ZonedDateTime avec le nombre spécifié de nanosecondes soustractées. |
| MinusSeconds(Int64) |
Retourne une copie de cette ZonedDateTime avec le nombre de secondes spécifié soustrait. |
| MinusWeeks(Int64) |
Retourne une copie de cette ZonedDateTime avec le nombre de semaines spécifié soustrait. |
| MinusYears(Int64) |
Retourne une copie de cette ZonedDateTime avec le nombre d’années spécifié soustrait. |
| Notify() |
Réveille un thread unique qui attend le moniteur de cet objet. (Hérité de Object) |
| NotifyAll() |
Réveille tous les threads qui attendent le moniteur de cet objet. (Hérité de Object) |
| Now() |
Date/heure avec un fuseau horaire dans le système de calendrier ISO-8601, tel que |
| Now(Clock) |
Obtient l’heure de date actuelle à partir de l’horloge spécifiée. |
| Now(ZoneId) |
Obtient l’heure de date actuelle à partir de l’horloge système dans le fuseau horaire spécifié. |
| Of(Int32, Int32, Int32, Int32, Int32, Int32, Int32, ZoneId) |
Obtient une instance de ZonedDateTime à partir d’une année, d’un mois, d’un jour, d’une heure, d’une minute, d’une seconde, d’une nanoseconde et d’un fuseau horaire. |
| Of(LocalDate, LocalTime, ZoneId) |
Obtient une instance de ZonedDateTime à partir d’une date et d’une heure locales. |
| Of(LocalDateTime, ZoneId) |
Obtient une instance de ZonedDateTime à partir d’une date-heure locale. |
| OfInstant(Instant, ZoneId) |
Obtient une instance de ZonedDateTime à partir d’un instant. |
| OfInstant(LocalDateTime, ZoneOffset, ZoneId) |
Obtient une instance de ZonedDateTime à partir de l’instant formé en combinant la date-heure locale et le décalage. |
| OfLocal(LocalDateTime, ZoneId, ZoneOffset) |
Obtient une instance de ZonedDateTime à partir d’une date-heure locale à l’aide du décalage préféré si possible. |
| OfStrict(LocalDateTime, ZoneOffset, ZoneId) |
Obtient une instance de ZonedDateTime validant strictement la combinaison de date-heure locale, de décalage et d’ID de zone. |
| Parse(ICharSequence, DateTimeFormatter) |
Obtient une instance de ZonedDateTime à partir d’une chaîne de texte à l’aide d’un formateur spécifique. |
| Parse(ICharSequence) |
Obtient une instance de ZonedDateTime à partir d’une chaîne de texte telle que 2007-12-03T10:15:30+01:00[Europe/Paris]. |
| Parse(String, DateTimeFormatter) |
Date/heure avec un fuseau horaire dans le système de calendrier ISO-8601, tel que |
| Parse(String) |
Date/heure avec un fuseau horaire dans le système de calendrier ISO-8601, tel que |
| Plus(Int64, ITemporalUnit) |
Retourne une copie de cette date-heure avec la quantité spécifiée ajoutée. |
| Plus(ITemporalAmount) |
Retourne une copie de cette date-heure avec la quantité spécifiée ajoutée. |
| PlusDays(Int64) |
Retourne une copie de cette ZonedDateTime avec le nombre spécifié de jours ajoutés. |
| PlusHours(Int64) |
Retourne une copie de cette ZonedDateTime avec le nombre d’heures spécifié ajouté. |
| PlusMinutes(Int64) |
Retourne une copie de cette ZonedDateTime avec le nombre spécifié de minutes ajoutées. |
| PlusMonths(Int64) |
Retourne une copie de cette ZonedDateTime avec le nombre spécifié de mois ajoutés. |
| PlusNanos(Int64) |
Retourne une copie de cette ZonedDateTime avec le nombre spécifié de nanosecondes ajoutées. |
| PlusSeconds(Int64) |
Retourne une copie de cette ZonedDateTime avec le nombre spécifié de secondes ajoutées. |
| PlusWeeks(Int64) |
Retourne une copie de cette ZonedDateTime avec le nombre spécifié de semaines ajoutées. |
| PlusYears(Int64) |
Retourne une copie de cette ZonedDateTime avec le nombre spécifié d’années ajoutées. |
| Query(ITemporalQuery) |
Interroge cette date et heure à l’aide de la requête spécifiée. |
| Range(ITemporalField) |
Obtient la plage de valeurs valides pour le champ spécifié. |
| SetHandle(IntPtr, JniHandleOwnership) |
Définit la propriété Handle. (Hérité de Object) |
| SetPeerReference(JniObjectReference, JniObjectReferenceOptions) |
Date/heure avec un fuseau horaire dans le système de calendrier ISO-8601, tel que |
| ToArray<T>() |
Crée un tableau managé à partir de ce wrapper de tableau Java. (Hérité de Object) |
| ToLocalDate() |
Obtient la partie LocalDate de cette date-heure. |
| ToLocalDateTime() |
Obtient la partie LocalDateTime de cette date-heure. |
| ToLocalTime() |
Obtient la partie LocalTime de cette date-heure. |
| ToOffsetDateTime() |
Convertit cette date-heure en OffsetDateTime. |
| ToString() |
Retourne une représentation sous forme de chaîne de l’objet. (Hérité de Object) |
| TruncatedTo(ITemporalUnit) |
Retourne une copie de cette ZonedDateTime avec l’heure tronquée. |
| UnregisterFromRuntime() |
Annule l’inscription de cet homologue Java à partir du runtime d’interopérabilité. (Hérité de Object) |
| Until(ITemporal, ITemporalUnit) |
Calcule la durée jusqu’à une autre date-heure en termes d’unité spécifiée. |
| Wait() |
Provoque l’attente du thread actuel jusqu’à ce qu’il soit réveillé, généralement en étant <averti par em ou><em>interrompu</em>.<> (Hérité de Object) |
| Wait(Int64, Int32) |
Provoque l’attente du thread actuel jusqu’à ce qu’il soit réveillé, généralement en étant <averti> par< em>ou <em>interrompu/em<,> ou jusqu’à ce qu’une certaine quantité de temps réel s’est écoulée. (Hérité de Object) |
| Wait(Int64) |
Provoque l’attente du thread actuel jusqu’à ce qu’il soit réveillé, généralement en étant <averti> par< em>ou <em>interrompu/em<,> ou jusqu’à ce qu’une certaine quantité de temps réel s’est écoulée. (Hérité de Object) |
| 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. |
| WithDayOfMonth(Int32) |
Retourne une copie de cette ZonedDateTime avec la modification du jour du mois. |
| WithDayOfYear(Int32) |
Retourne une copie de cette ZonedDateTime avec la modification du jour de l’année. |
| WithEarlierOffsetAtOverlap() |
Retourne une copie de cette date-heure qui change le décalage de zone par rapport aux deux décalages valides au chevauchement de la ligne de temps locale. |
| WithFixedOffsetZone() |
Retourne une copie de cette date-heure avec l’ID de zone défini sur le décalage. |
| WithHour(Int32) |
Retourne une copie de cette ZonedDateTime avec la modification de l’heure de la journée. |
| WithLaterOffsetAtOverlap() |
Retourne une copie de cette date-heure modifiant le décalage de zone par la suite des deux décalages valides lors d’un chevauchement de ligne de temps local. |
| WithMinute(Int32) |
Retourne une copie de cette ZonedDateTime avec la modification de minute d’heure. |
| WithMonth(Int32) |
Retourne une copie de cette ZonedDateTime avec la modification du mois de l’année. |
| WithNano(Int32) |
Retourne une copie de cette ZonedDateTime avec la nano-seconde modifiée. |
| WithSecond(Int32) |
Retourne une copie de cette ZonedDateTime avec la seconde minute modifiée. |
| WithYear(Int32) |
Retourne une copie de cette ZonedDateTime avec l’année modifiée. |
| WithZoneSameInstant(ZoneId) |
Retourne une copie de cette date-heure avec un fuseau horaire différent, en conservant l’instant. |
| WithZoneSameLocal(ZoneId) |
Retourne une copie de cette date-heure avec un fuseau horaire différent, en conservant la date-heure locale si possible. |
Implémentations d’interfaces explicites
| Nom | Description |
|---|---|
| IChronoZonedDateTime.Plus(Int64, ITemporalUnit) |
Date/heure avec un fuseau horaire dans le système de calendrier ISO-8601, tel que |
| IChronoZonedDateTime.ToLocalDateTime() |
Date/heure avec un fuseau horaire dans le système de calendrier ISO-8601, tel que |
| IChronoZonedDateTime.With(ITemporalField, Int64) |
Date/heure avec un fuseau horaire dans le système de calendrier ISO-8601, tel que |
| IChronoZonedDateTime.WithEarlierOffsetAtOverlap() |
Date/heure avec un fuseau horaire dans le système de calendrier ISO-8601, tel que |
| IChronoZonedDateTime.WithLaterOffsetAtOverlap() |
Date/heure avec un fuseau horaire dans le système de calendrier ISO-8601, tel que |
| IChronoZonedDateTime.WithZoneSameInstant(ZoneId) |
Date/heure avec un fuseau horaire dans le système de calendrier ISO-8601, tel que |
| IChronoZonedDateTime.WithZoneSameLocal(ZoneId) |
Date/heure avec un fuseau horaire dans le système de calendrier ISO-8601, tel que |
| IJavaPeerable.Disposed() |
Date/heure avec un fuseau horaire dans le système de calendrier ISO-8601, tel que |
| IJavaPeerable.Finalized() |
Date/heure avec un fuseau horaire dans le système de calendrier ISO-8601, tel que |
| IJavaPeerable.JniObjectReferenceControlBlock |
Date/heure avec un fuseau horaire dans le système de calendrier ISO-8601, tel que |
| IJavaPeerable.SetJniIdentityHashCode(Int32) |
Date/heure avec un fuseau horaire dans le système de calendrier ISO-8601, tel que |
| IJavaPeerable.SetJniManagedPeerState(JniManagedPeerStates) |
Date/heure avec un fuseau horaire dans le système de calendrier ISO-8601, tel que |
| IJavaPeerable.SetPeerReference(JniObjectReference) |
Date/heure avec un fuseau horaire dans le système de calendrier ISO-8601, tel que |
| IJavaPeerable.UnregisterFromRuntime() |
Date/heure avec un fuseau horaire dans le système de calendrier ISO-8601, tel que |
Méthodes d’extension
| Nom | Description |
|---|---|
| GetJniTypeName(IJavaPeerable) |
Obtient le nom JNI du type de l’instance |
| JavaAs<TResult>(IJavaPeerable) |
Essayez de forcer |
| JavaCast<TResult>(IJavaObject) |
Effectue une conversion de type vérifiée par le runtime Android. |
| JavaCast<TResult>(IJavaObject) |
Date/heure avec un fuseau horaire dans le système de calendrier ISO-8601, tel que |
| TryJavaCast<TResult>(IJavaPeerable, TResult) |
Essayez de forcer |