Calendar.Roll Méthode
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.
Surcharges
| Nom | Description |
|---|---|
| Roll(CalendarField, Boolean) |
Rolls (up/down) une unité de temps unique sur le champ donné. |
| Roll(CalendarField, Int32) |
Rolls (up/down) une durée spécifiée sur le champ donné. |
Roll(CalendarField, Boolean)
Rolls (up/down) une unité de temps unique sur le champ donné.
[Android.Runtime.Register("roll", "(IZ)V", "", ApiSince=24)]
public void Roll(Android.Icu.Util.CalendarField field, bool up);
[<Android.Runtime.Register("roll", "(IZ)V", "", ApiSince=24)>]
member this.Roll : Android.Icu.Util.CalendarField * bool -> unit
Paramètres
- field
- CalendarField
champ calendrier à déployer.
- up
- Boolean
indique si la valeur du champ d’heure spécifié doit être roulée ou annulée. Utilisez-la si vous effectuez true un déploiement, false sinon.
- Attributs
Remarques
Rolls (up/down) une unité de temps unique sur le champ donné. Si le champ est roulé au-delà de sa valeur maximale autorisée, il revient à son minimum et continue à rouler. Par exemple, pour annuler la date actuelle d’un jour, vous pouvez appeler :
roll({@link #DATE}, true)
Lorsque vous effectuez un déploiement sur le #YEAR champ, la valeur de l’année est déployée dans la plage comprise entre 1 et la valeur retournée par l’appel #getMaximum getMaximum(#YEAR).
Lors du déploiement sur certains champs, les valeurs d’autres champs peuvent être en conflit et doivent être modifiées. Par exemple, lors du déploiement du MONTH champ pour la date grégorienne 1/31/96 vers le haut, le DAY_OF_MONTH champ doit être ajusté afin que le résultat soit 2/29/96 plutôt que le 2/31/96 non valide.
Le cumul signifie toujours avancer dans le temps (sauf si la limite du champ est atteinte, auquel cas elle peut épingler ou encapsuler), donc pour le calendrier grégorien, à partir de 100 BC et le déploiement de l’année en résultats en 99 BC. Lorsque les ères ont un début et une fin définitifs (comme dans le calendrier chinois, ou comme dans la plupart des ères dans le calendrier japonais), puis que la fin de l’année passée l’année entraînera le retour de l’année. Lorsque les ères n’ont qu’une limite à une fin, la tentative de cumul de l’année précédente entraîne l’épinglage de l’année à cette limite. Notez que pour la plupart des calendriers dans lesquels les années 0 avancent dans le temps (comme bouddhiste, hébreu ou islamique), il est possible d’ajouter ou de rouler pour entraîner des années négatives pour l’ère 0 (c’est-à-dire la seule façon de représenter des années avant l’époque du calendrier dans ces calendriers).
<b>Remarque :</b> Appels roll(field, true) N heures n’est>< pas< nécessairement> équivalent à l’appel roll(field, N). Par exemple, imaginez que vous commencez par la date grégorienne du 31 janvier 1995. Si vous appelez roll(Calendar.MONTH, 2), le résultat sera le 31 mars 1995. Mais si vous appelez roll(Calendar.MONTH, true), le résultat sera le 28 février 1995. L’appel d’une autre fois donnera le 28 mars 1995, ce qui n’est généralement pas le résultat souhaité.
<b>Remarque :</b> Vous devez toujours utiliser roll et add plutôt que de tenter d’effectuer des opérations arithmétiques directement sur les champs d’un Calendar. Il est tout à fait possible que Calendar les sous-classes aient des champs avec un comportement non linéaire, par exemple des mois ou des jours manquants pendant des années non bissextiles. Les sous-classes et addroll les méthodes prennent cela en compte, tandis que des manipulations arithmétiques simples peuvent donner des résultats non valides.
Java documentation pour android.icu.util.Calendar.roll(int, boolean).
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.
S’applique à
Roll(CalendarField, Int32)
Rolls (up/down) une durée spécifiée sur le champ donné.
[Android.Runtime.Register("roll", "(II)V", "GetRoll_IIHandler", ApiSince=24)]
public virtual void Roll(Android.Icu.Util.CalendarField field, int amount);
[<Android.Runtime.Register("roll", "(II)V", "GetRoll_IIHandler", ApiSince=24)>]
abstract member Roll : Android.Icu.Util.CalendarField * int -> unit
override this.Roll : Android.Icu.Util.CalendarField * int -> unit
Paramètres
- field
- CalendarField
champ calendrier à déployer.
- amount
- Int32
montant par lequel le champ doit être roulé.
- Attributs
Remarques
Rolls (up/down) une durée spécifiée sur le champ donné. Par exemple, pour annuler la date actuelle de trois jours, vous pouvez appeler roll(Calendar.DATE, 3). Si le champ est roulé au-delà de sa valeur maximale autorisée, il revient à son minimum et continue à rouler. Par exemple, l’appel roll(Calendar.DATE, 10) sur un calendrier grégorien défini sur 4/25/96 entraîne la date 4/5/96.
Lors du déploiement sur certains champs, les valeurs d’autres champs peuvent être en conflit et doivent être modifiées. Par exemple, lors du déploiement du #MONTH MONTH champ pour la date grégorienne 1/31/96 de +1, le #DAY_OF_MONTH DAY_OF_MONTH champ doit être ajusté afin que le résultat soit 2/29/96 plutôt que le 2/31/96 non valide.
Le déploiement par une valeur positive signifie toujours avancer dans le temps (sauf si la limite du champ est atteinte, auquel cas elle peut épingler ou encapsuler), donc pour le calendrier grégorien, à partir de 100 BC et de rouler l’année de + 1 résultats en 99 BC. Lorsque les ères ont un début et une fin définitifs (comme dans le calendrier chinois, ou comme dans la plupart des ères dans le calendrier japonais), puis que la fin de l’année passée l’année entraînera le retour de l’année. Lorsque les ères n’ont qu’une limite à une fin, la tentative de cumul de l’année précédente entraîne l’épinglage de l’année à cette limite. Notez que pour la plupart des calendriers dans lesquels les années 0 avancent dans le temps (comme bouddhiste, hébreu ou islamique), il est possible d’ajouter ou de rouler pour entraîner des années négatives pour l’ère 0 (c’est-à-dire la seule façon de représenter des années avant l’époque du calendrier dans ces calendriers).
<strong>[icu] Remarque :</strong> l’implémentation de l’ICU de cette méthode est en mesure de déployer tous les champs à l’exception de #ERA ERA, #DST_OFFSET DST_OFFSETet #ZONE_OFFSET ZONE_OFFSET. Les sous-classes peuvent, bien sûr, ajouter la prise en charge des champs supplémentaires dans leurs remplacements .roll
<b>Remarque :</b> Vous devez toujours utiliser roll et add plutôt que de tenter d’effectuer des opérations arithmétiques directement sur les champs d’un Calendar. Il est tout à fait possible que Calendar les sous-classes aient des champs avec un comportement non linéaire, par exemple des mois ou des jours manquants pendant des années non bissextiles. Les sous-classes et addroll les méthodes prennent cela en compte, tandis que des manipulations arithmétiques simples peuvent donner des résultats non valides.
<b>Subclassing :</b><br> Cette implémentation roll suppose que le comportement du champ est continu entre son minimum et son maximum, qui sont trouvés en appelant #getActualMinimum getActualMinimum et #getActualMaximum getActualMaximum. Pour la plupart de ces champs, l’ajout simple, la soustraction et les opérations de module sont suffisants pour effectuer le déploiement. Pour les champs liés à la semaine, les résultats et #getFirstDayOfWeek getFirstDayOfWeek#getMinimalDaysInFirstWeek getMinimalDaysInFirstWeek sont également nécessaires. Les sous-classes peuvent remplacer ces deux méthodes si leurs valeurs diffèrent des valeurs par défaut.
Les sous-classes qui ont des champs pour lesquels l’hypothèse d’une interruption de continuité doit être remplacée roll pour gérer ces champs spécialement. Par exemple, dans le calendrier hébreu, le mois « Adar I » se produit uniquement dans les années bissextiles ; dans les autres années, le calendrier passe de Shevat (mois #4) à Adar (mois #6). La HebrewCalendar#roll HebrewCalendar.roll méthode prend cela en compte, de sorte que le mois de Shevat par un donne le résultat approprié (Adar) dans une année non bissextile.
Java documentation pour android.icu.util.Calendar.roll(int, int).
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.