Calendar.Roll Método
Definición
Importante
Parte de la información hace referencia a la versión preliminar del producto, que puede haberse modificado sustancialmente antes de lanzar la versión definitiva. Microsoft no otorga ninguna garantía, explícita o implícita, con respecto a la información proporcionada aquí.
Sobrecargas
| Nombre | Description |
|---|---|
| Roll(CalendarField, Boolean) |
Acumula (arriba/abajo) una sola unidad de tiempo en el campo especificado. |
| Roll(CalendarField, Int32) |
Acumula (up/down) un tiempo de cantidad especificado en el campo especificado. |
Roll(CalendarField, Boolean)
Acumula (arriba/abajo) una sola unidad de tiempo en el campo especificado.
[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
Parámetros
- field
- CalendarField
campo de calendario que se va a implementar.
- up
- Boolean
indica si el valor del campo de hora especificado se va a inscribir o revertir. Use si se está implementando; de lo contrario, false use true .
- Atributos
Comentarios
Acumula (arriba/abajo) una sola unidad de tiempo en el campo especificado. Si el campo se revierte más allá de su valor máximo permitido, se "ajustará" a su mínimo y continuará rodando. Por ejemplo, para poner al día la fecha actual en un día, puede llamar a:
roll({@link #DATE}, true)
Al rodar en el #YEAR campo, se revertirá el valor de año en el intervalo entre 1 y el valor devuelto llamando a #getMaximum getMaximum(#YEAR).
Al rodar en determinados campos, los valores de otros campos pueden entrar en conflicto y deben cambiarse. Por ejemplo, al rodar el MONTH campo para la fecha gregoriana 1/31/96 hacia arriba, el DAY_OF_MONTH campo debe ajustarse para que el resultado sea 2/29/96 en lugar del 2/31/96 no válido.
La puesta al día siempre significa avanzar en el tiempo (a menos que se alcance el límite del campo, en cuyo caso puede anclar o encapsular), por lo que para el calendario gregoriano, a partir de 100 BC y la puesta al día del año en 99 BC. Cuando las eras tienen un comienzo y un fin definitivos (como en el calendario chino, o como en la mayoría de las eras del calendario japonés) entonces la puesta al año más allá de cualquiera de los límites de la era hará que el año se ajuste. Cuando las eras solo tienen un límite en un extremo, al intentar poner el año pasado ese límite, se anclará el año en ese límite. Tenga en cuenta que para la mayoría de los calendarios en los que la era 0 años avanza en el tiempo (como budista, hebreo o islámico), es posible agregar o lanzar para dar lugar a años negativos para la era 0 (es decir, la única manera de representar años antes de la época del calendario en estos calendarios).
<b>Nota:</b> Llamar roll(field, true) n veces es <em>not</em> necesariamente equivalente a llamar a roll(field, N). Por ejemplo, imagine que comienza con la fecha gregoriana fecha 31 de enero de 1995. Si llama a roll(Calendar.MONTH, 2), el resultado será el 31 de marzo de 1995. Pero si llama a roll(Calendar.MONTH, true), el resultado será el 28 de febrero de 1995. Llamarlo una vez más dará el 28 de marzo de 1995, que normalmente no es el resultado deseado.
<b>Nota:</b> Debe usar roll siempre y add en lugar de intentar realizar operaciones aritméticas directamente en los campos de .Calendar Es bastante posible que Calendar las subclases tengan campos con un comportamiento no lineal, por ejemplo, faltan meses o días durante años no bisiestos. Los métodos y roll las subclases add tendrán esto en cuenta, mientras que las manipulaciones aritméticas simples pueden dar resultados no válidos.
Java documentación para android.icu.util.Calendar.roll(int, boolean).
Las partes de esta página son modificaciones basadas en el trabajo creado y compartido por el Android y se usan según los términos descritos en creative Creative Commons 2.5 Attribution License.
Se aplica a
Roll(CalendarField, Int32)
Acumula (up/down) un tiempo de cantidad especificado en el campo especificado.
[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
Parámetros
- field
- CalendarField
campo de calendario que se va a implementar.
- amount
- Int32
la cantidad por la que se debe inscribir el campo.
- Atributos
Comentarios
Acumula (up/down) un tiempo de cantidad especificado en el campo especificado. Por ejemplo, para poner al día actual en tres días, puede llamar a roll(Calendar.DATE, 3). Si el campo se revierte más allá de su valor máximo permitido, se "ajustará" a su mínimo y continuará rodando. Por ejemplo, llamar a roll(Calendar.DATE, 10) en un calendario gregoriano establecido en 4/25/96 dará como resultado la fecha 4/5/96.
Al rodar en determinados campos, los valores de otros campos pueden entrar en conflicto y deben cambiarse. Por ejemplo, al rodar el #MONTH MONTH campo para la fecha gregoriana 1/31/96 por +1, el #DAY_OF_MONTH DAY_OF_MONTH campo debe ajustarse para que el resultado sea 2/29/96 en lugar del 2/31/96 no válido.
Rodar por un valor positivo siempre significa avanzar en el tiempo (a menos que se alcance el límite del campo, en cuyo caso puede anclar o encapsular), por lo que para el calendario gregoriano, a partir de 100 BC y rodar el año por + 1 da como resultado 99 BC. Cuando las eras tienen un comienzo y un fin definitivos (como en el calendario chino, o como en la mayoría de las eras del calendario japonés) entonces la puesta al año más allá de cualquiera de los límites de la era hará que el año se ajuste. Cuando las eras solo tienen un límite en un extremo, al intentar poner el año pasado ese límite, se anclará el año en ese límite. Tenga en cuenta que para la mayoría de los calendarios en los que la era 0 años avanza en el tiempo (como budista, hebreo o islámico), es posible agregar o lanzar para dar lugar a años negativos para la era 0 (es decir, la única manera de representar años antes de la época del calendario en estos calendarios).
<strong>[icu] Nota:</strong> la implementación de ICU de este método es capaz de implementar todos los campos excepto #ERA ERA, #DST_OFFSET DST_OFFSETy #ZONE_OFFSET ZONE_OFFSET. Por supuesto, las subclases pueden agregar compatibilidad con campos adicionales en sus invalidaciones de roll.
<b>Nota:</b> Debe usar roll siempre y add en lugar de intentar realizar operaciones aritméticas directamente en los campos de .Calendar Es bastante posible que Calendar las subclases tengan campos con un comportamiento no lineal, por ejemplo, faltan meses o días durante años no bisiestos. Los métodos y roll las subclases add tendrán esto en cuenta, mientras que las manipulaciones aritméticas simples pueden dar resultados no válidos.
<b>Subclasing:</b><br> Esta implementación de roll supone que el comportamiento del campo es continuo entre su mínimo y máximo, que se encuentran llamando a #getActualMinimum getActualMinimum y #getActualMaximum getActualMaximum. Para la mayoría de estos campos, las operaciones simples de suma, resta y módulo son suficientes para realizar el rollo. Para los campos relacionados con la semana, los resultados de #getFirstDayOfWeek getFirstDayOfWeek y #getMinimalDaysInFirstWeek getMinimalDaysInFirstWeek también son necesarios. Las subclases pueden invalidar estos dos métodos si sus valores difieren de los valores predeterminados.
Las subclases que tienen campos para los que la suposición de continuidad se divide deben invalidar roll para controlar esos campos especialmente. Por ejemplo, en el calendario hebreo el mes "Adar I" solo se produce en años bisiestos; en otros años, el calendario salta de Shevat (mes n.º 4) a Adar (mes n.º 6). El HebrewCalendar#roll HebrewCalendar.roll método tiene esto en cuenta, de modo que la rotación del mes de Shevat por una proporciona el resultado adecuado (Adar) en un año no bisiesto.
Java documentación para android.icu.util.Calendar.roll(int, int).
Las partes de esta página son modificaciones basadas en el trabajo creado y compartido por el Android y se usan según los términos descritos en creative Creative Commons 2.5 Attribution License.