Idioma

Calendar.Add(CalendarField, Int32) Método

Definição

Adicione um valor assinado a um campo especificado usando as regras deste calendário.

[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

Parâmetros

field
CalendarField

o campo de tempo.

amount
Int32

o valor a ser adicionado ao campo.

Atributos

Comentários

Adicione um valor assinado a um campo especificado usando as regras deste calendário. Por exemplo, para adicionar três dias à data atual, você pode chamar add(Calendar.DATE, 3).

Ao adicionar a determinados campos, os valores de outros campos podem entrar em conflito e precisam ser alterados. Por exemplo, ao adicionar um ao #MONTH MONTH campo para a data gregoriana 1/31/96, o #DAY_OF_MONTH DAY_OF_MONTH campo deve ser ajustado para que o resultado seja 2/29/96 em vez do 31/02/96 inválido.

Adicionar um valor positivo sempre significa avançar no tempo, portanto, para o calendário gregoriano, começando com 100 a.C. e adicionando +1 ao ano resulta em 99 BC (embora isso realmente reduza o valor numérico do próprio campo).

<strong>[icu] Observação:</strong> A implementação da UTI desse método é capaz de adicionar a todos os campos, exceto por #ERA ERA, #DST_OFFSET DST_OFFSETe #ZONE_OFFSET ZONE_OFFSET. As subclasses podem, naturalmente, adicionar suporte para campos adicionais em suas substituições de add.

<b>Observação:</b> Você sempre deve usar roll e add , em vez de tentar executar operações aritméticas diretamente nos campos de um Calendar. É bem possível que Calendar subclasses tenham campos com comportamento não linear, por exemplo, meses ou dias ausentes durante anos não bissextos. As subclasses add e roll os métodos levarão isso em conta, enquanto manipulações aritméticas simples podem fornecer resultados inválidos.

<b>Subclasse:</b><br> Essa implementação add pressupõe que o comportamento do campo é contínuo entre o mínimo e o máximo, que são encontrados por chamada #getActualMinimum getActualMinimum e #getActualMaximum getActualMaximum. Para esses campos, operações aritméticas simples são suficientes para executar a adição.

As subclasses que têm campos para os quais essa suposição de continuidade é interrompida devem substituir add para lidar especialmente com esses campos. Por exemplo, no calendário hebraico, o mês "Adar I" ocorre apenas em anos bissextos; em outros anos, o calendário salta de Shevat (mês nº 4) para Adar (mês nº 6). O HebrewCalendar#add HebrewCalendar.add método leva isso em conta, de modo que adicionar um mês a uma data em Shevat dá o resultado adequado (Adar) em um ano não bissexto.

Java documentação para android.icu.util.Calendar.add(int, int).

Partes desta página são modificações baseadas no trabalho criado e compartilhado pelo Project Open Source do Open Source e usadas de acordo com os termos descritos na Creative Commons 2.5.

Aplica-se a