Calendar.Add(CalendarField, Int32) Metodo

[Android.Runtime.Register("add", "(II)V", "GetAdd_IIHandler", ApiSince=24)]
public virtual void Add(Android.Icu.Util.CalendarField field, int amount);

[<Android.Runtime.Register("add", "(II)V", "GetAdd_IIHandler", ApiSince=24)>]
abstract member Add : Android.Icu.Util.CalendarField * int -> unit
override this.Add : Android.Icu.Util.CalendarField * int -> unit

Parametri

Attributi

RegisterAttribute

Commenti

Aggiungere un importo firmato a un campo specificato usando le regole del calendario. Ad esempio, per aggiungere tre giorni alla data corrente, è possibile chiamare add(Calendar.DATE, 3).

Quando si aggiunge a determinati campi, i valori di altri campi possono essere in conflitto e devono essere modificati. Ad esempio, quando si aggiunge uno al campo per la #MONTH MONTH data gregoriana 1/31/96, il #DAY_OF_MONTH DAY_OF_MONTH campo deve essere regolato in modo che il risultato sia 2/29/96 anziché il 2/31/96 non valido.

L'aggiunta di un valore positivo implica sempre lo spostamento in avanti nel tempo, quindi per il calendario gregoriano, a partire da 100 BC e aggiungendo +1 all'anno i risultati in 99 BC (anche se questo riduce effettivamente il valore numerico del campo stesso).

<strong>[icu] Nota:</strong> L'implementazione dell'ICU di questo metodo è in grado di aggiungere a tutti i campi ad eccezione #ERA ERAdi , #DST_OFFSET DST_OFFSETe #ZONE_OFFSET ZONE_OFFSET. Le sottoclassi possono, naturalmente, aggiungere il supporto per altri campi nelle relative sostituzioni di add.

<b Nota:</b>> È consigliabile usare roll sempre e add invece di tentare di eseguire operazioni aritmetiche direttamente nei campi di un oggetto Calendar. È possibile che Calendar le sottoclassi abbiano campi con comportamento non lineare, ad esempio mesi o giorni mancanti durante gli anni non bisestili. I metodi e roll delle sottoclassi add prenderanno in considerazione questo problema, mentre le semplici manipolazioni aritmetiche possono dare risultati non validi.

<b>Subclassing:</b><br> Questa implementazione di add presuppone che il comportamento del campo sia continuo tra il valore minimo e il massimo, che vengono trovati chiamando #getActualMinimum getActualMinimum e #getActualMaximum getActualMaximum. Per tali campi, le semplici operazioni aritmetiche sono sufficienti per eseguire l'aggiunta.

Le sottoclassi con campi per i quali questa ipotesi di continuità viene interrotta devono eseguire l'override add per gestire tali campi in modo speciale. Ad esempio, nel calendario ebraico il mese "Adar I" si verifica solo negli anni bisestili; negli altri anni il calendario passa da Shevat (mese 4) ad Adar (mese 6). Il HebrewCalendar#add HebrewCalendar.add metodo tiene conto di questo, in modo che l'aggiunta di un mese a una data in Shevat restituisca il risultato corretto (Adar) in un anno non bisestile.

per android.icu.util.Calendar.add(int, int).

Le parti di questa pagina sono modifiche basate sul lavoro creato e condiviso dalla e usati in base ai termini descritti in Creative License 2.5 Attribution License.