DateIntervalInfo Classe

Définition

[Android.Runtime.Register("android/icu/text/DateIntervalInfo", ApiSince=24, DoNotGenerateAcw=true)]
public class DateIntervalInfo : Java.Lang.Object, Android.Icu.Util.IFreezable, IDisposable, Java.IO.ISerializable

[<Android.Runtime.Register("android/icu/text/DateIntervalInfo", ApiSince=24, DoNotGenerateAcw=true)>]
type DateIntervalInfo = class
    inherit Object
    interface IFreezable
    interface ICloneable
    interface IJavaObject
    interface IDisposable
    interface IJavaPeerable
    interface ISerializable

Héritage

Object

JavaObject

Object

DateIntervalInfo

Attributs

RegisterAttribute

Implémente

IFreezable IJavaObject IJavaPeerable ISerializable ICloneable IDisposable

Remarques

DateIntervalInfo est une classe publique pour encapsuler les modèles d’intervalles de date localisables. Il est utilisé par DateIntervalFormat.

Pour la plupart des utilisateurs, l’utilisation ordinaire de DateIntervalFormat n’a pas besoin de créer directement un objet DateIntervalInfo. DateIntervalFormat s’occupe de celui-ci lors de la création d’un formateur d’intervalle de date lorsque l’utilisateur passe dans le squelette et les paramètres régionaux.

Pour les utilisateurs de l’alimentation, qui souhaitent créer leurs propres modèles d’intervalle de date ou pour rétablir les modèles d’intervalle de date, ils peuvent le faire en créant directement DateIntervalInfo et en le manipulant.

Logiquement, les modèles d’intervalle sont des mappages de (squelette, the_largest_different_calendar_field) à (date_interval_pattern).

Un squelette <ol><li> conserve uniquement la lettre de modèle de champ et ignore toutes les autres parties d’un modèle, telles que l’espace, les ponctuations et les littéraux de chaîne. <li> masque l’ordre des champs. <li> peut masquer la longueur de la lettre de motif d’un champ.

Pour ces champs de calendrier non numériques, la longueur de la lettre de modèle est importante, telle que MMM, MMMM et MMMMM ; L’EEE et l’EEEE, et la longueur de la lettre de motif du champ est respectée.

Pour les champs de calendrier de chiffres, tels que M ou MM, d ou dd, aaaa ou aaaa, la longueur du modèle de champ est ignorée et la meilleure correspondance, qui est définie dans les modèles d’heure de date, est retournée sans respecter la longueur de la lettre de modèle de champ dans le squelette. </ol>

Les champs de calendrier que nous prenons en charge pour la mise en forme d’intervalle sont : année, mois, date, jour de la semaine, am-pm, heure, heure de jour, minute et seconde (bien que nous n’avons pas actuellement de données intervalFormat spécifiques pour les squelettes avec secondes). Ces champs de calendrier peuvent être définis dans l’ordre suivant : année > mois > date > am-pm > heure > minute > seconde

Le plus grand nombre de champs de calendrier entre 2 calendriers est le premier champ de calendrier différent dans l’ordre ci-dessus.

Par exemple : les plus grands champs de calendrier entre « 10 janvier 2007 » et « 20 février 2008 » sont l’année.

Il existe un ensemble de chaînes de squelette statiques prédéfinies. Il existe des modèles d’intervalle prédéfinis pour ces squelettes prédéfinis dans les fichiers de ressources des paramètres régionaux. Par exemple, pour un squelette YEAR_ABBR_MONTH_DAY, qui est « yMMMd », dans en_US, si le champ calendrier le plus important entre date1 et date2 est « year », le modèle d’intervalle de date est « MMM d, aaaa - MMM d, aaaa », par exemple « 10 janvier 2007 - 10 janvier 2008 ». Si le plus grand champ de calendrier différent entre date1 et date2 est « mois », le modèle d’intervalle de date est « MMM d - MMM d, aaaa », tel que « 10 janvier - 10 février 2007 ». Si le plus grand champ de calendrier différent entre date1 et date2 est « jour », le modèle d’intervalle de date est « « MMM d-d, aaaa », par exemple « 10-20 janvier 2007 ».

Pour le squelette de date, les modèles d’intervalle lorsque l’année ou le mois ou la date sont différents sont définis dans les fichiers de ressources. Pour le squelette du temps, les modèles d’intervalle lorsque am/pm, ou heure, ou minute sont différents sont définis dans les fichiers de ressources.

Il existe 2 dates dans le modèle d’intervalle. Pour la plupart des paramètres régionaux, la première date dans un modèle d’intervalle est la date antérieure. Il peut y avoir des paramètres régionaux dans lesquels la première date d’un modèle d’intervalle est la date ultérieure. Nous utilisons le format de secours pour l’ordre par défaut pour les paramètres régionaux. Par exemple, si le format de secours est « -{0}{1}« , cela signifie que la première date dans le modèle d’intervalle pour ces paramètres régionaux est une date antérieure. Si le format de secours est « -{1}{0}« , cela signifie que la première date est la date ultérieure. Pour un modèle d’intervalle particulier, l’ordre par défaut peut être substitué en préfixant « latestFirst : » ou « latesttFirst : » au modèle d’intervalle. Par exemple, si le format de secours est «{0} -{1} », mais pour le squelette « yMMMd », le modèle d’intervalle lorsque le jour est différent est « latestFirst :d-d-d MMM yy », cela signifie par défaut, la première date dans le modèle d’intervalle est la date antérieure. Mais pour squelette « yMMMd », quand le jour est différent, la première date dans « d-d MMM yy » est la date ultérieure.

La méthode recommandée pour créer un objet DateIntervalFormat consiste à passer les paramètres régionaux. À l’aide d’un paramètre Locale, l’objet DateIntervalFormat est initialisé avec les modèles d’intervalle prédéfinis pour des paramètres régionaux donnés ou par défaut.

Les utilisateurs peuvent également créer un objet DateIntervalFormat en fournissant leurs propres modèles d’intervalle. Il offre une flexibilité pour l’utilisation de l’alimentation.

Une fois qu’un objet DateIntervalInfo est créé, les clients peuvent modifier les modèles d’intervalle à l’aide de la fonction setIntervalPattern comme vous le souhaitez. Actuellement, les utilisateurs peuvent uniquement définir des modèles d’intervalle lorsque les champs de calendrier suivants sont différents : ERA, YEAR, MONTH, DATE, DAY_OF_MONTH, DAY_OF_WEEK, AM_PM, HOUR, HOUR_OF_DAY, MINUTE, SECOND et MILLISECOND. Les modèles d’intervalle lorsque d’autres champs de calendrier sont différents n’est pas pris en charge.

Les objets DateIntervalInfo peuvent être clonés. Lorsque les clients obtiennent un objet DateIntervalInfo, ils peuvent se sentir libres de le modifier si nécessaire.

DateIntervalInfo n’est pas censé être sous-classé. Les données d’un calendrier sont chargées hors des offres groupées de ressources. Par le biais de l’ICU 4.4, les modèles d’intervalle de date ne sont pris en charge que dans le calendrier grégorien ; Les calendriers non grégoriens sont pris en charge à partir de l’ICU 4.4.1.

Java documentation pour android.icu.text.DateIntervalInfo.

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.