Compartilhar via


Duration.AddTo Método

Definição

Sobrecargas

AddTo(Calendar)

Adiciona essa duração a um Calendar objeto.

AddTo(Date)

Adiciona essa duração a um Date objeto.

AddTo(Calendar)

Adiciona essa duração a um Calendar objeto.

[Android.Runtime.Register("addTo", "(Ljava/util/Calendar;)V", "GetAddTo_Ljava_util_Calendar_Handler")]
public abstract void AddTo (Java.Util.Calendar? calendar);
[<Android.Runtime.Register("addTo", "(Ljava/util/Calendar;)V", "GetAddTo_Ljava_util_Calendar_Handler")>]
abstract member AddTo : Java.Util.Calendar -> unit

Parâmetros

calendar
Calendar

Um objeto de calendário cujo valor será modificado.

Atributos

Exceções

se o parâmetro calendar for null.

Comentários

Adiciona essa duração a um Calendar objeto.

Chamadas java.util.Calendar#add(int,int) na ordem de ANOS, MESES, DIAS, HORAS, MINUTOS, SEGUNDOS e MILISSEGUNDOS se esses campos estiverem presentes. Como a Calendar classe usa int para manter valores, há casos em que esse método não funcionará corretamente (por exemplo, se os valores dos campos excederem o intervalo de int.)

Além disso, como essa classe de duração é uma duração gregoriana, esse método não funcionará corretamente se o objeto fornecido Calendar for baseado em alguns outros sistemas de calendário.

Quaisquer partes fracionárias deste Duration objeto além de milissegundos serão simplesmente ignoradas. Por exemplo, se essa duração for "P1.23456S", 1 será adicionado a SEGUNDOS, 234 será adicionado a MILISSEGUNDOS e o restante não será usado.

Note que por Calendar#add(int, int) estar usando int, Duration com valores além do intervalo de int em seus campos causará estouro/subfluxo para o dado Calendar. XMLGregorianCalendar#add(Duration) fornece a mesma operação básica que este método, evitando os problemas de estouro/subfluxo.

Documentação Java para javax.xml.datatype.Duration.addTo(java.util.Calendar).

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

Aplica-se a

AddTo(Date)

Adiciona essa duração a um Date objeto.

[Android.Runtime.Register("addTo", "(Ljava/util/Date;)V", "GetAddTo_Ljava_util_Date_Handler")]
public virtual void AddTo (Java.Util.Date? date);
[<Android.Runtime.Register("addTo", "(Ljava/util/Date;)V", "GetAddTo_Ljava_util_Date_Handler")>]
abstract member AddTo : Java.Util.Date -> unit
override this.AddTo : Java.Util.Date -> unit

Parâmetros

date
Date

Um objeto de data cujo valor será modificado.

Atributos

Exceções

se o parâmetro Date for null.

Comentários

Adiciona essa duração a um Date objeto.

A data dada é primeiro convertida em um java.util.GregorianCalendar, então a duração é adicionada exatamente como o #addTo(Calendar) método.

O instante de tempo atualizado é então convertido novamente em um Date objeto e usado para atualizar o objeto determinado Date .

Este cálculo um tanto redundante é necessário para determinar inequivocamente a duração de meses e anos.

Documentação Java para javax.xml.datatype.Duration.addTo(java.util.Date).

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

Aplica-se a