Duration.AddTo Método
Definição
Importante
Algumas informações se referem a produtos de pré-lançamento que podem ser substancialmente modificados antes do lançamento. A Microsoft não oferece garantias, expressas ou implícitas, das informações aqui fornecidas.
Sobrecargas
AddTo(Calendar) |
Adiciona essa duração a um |
AddTo(Date) |
Adiciona essa duração a um |
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.