ChronoUnit.AddTo(Object, Int64) Método

Definição

Namespace:: Java.Time.Temporal

Assembly:: Mono.Android.dll

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.

Retorna uma cópia do objeto temporal especificado com o período especificado adicionado.

[Android.Runtime.Register("addTo", "(Ljava/time/temporal/Temporal;J)Ljava/time/temporal/Temporal;", "", ApiSince=26)]
[Java.Interop.JavaTypeParameters(new System.String[] { "R extends java.time.temporal.Temporal" })]
public Java.Lang.Object? AddTo(Java.Lang.Object? temporal, long amount);

[<Android.Runtime.Register("addTo", "(Ljava/time/temporal/Temporal;J)Ljava/time/temporal/Temporal;", "", ApiSince=26)>]
[<Java.Interop.JavaTypeParameters(new System.String[] { "R extends java.time.temporal.Temporal" })>]
abstract member AddTo : Java.Lang.Object * int64 -> Java.Lang.Object
override this.AddTo : Java.Lang.Object * int64 -> Java.Lang.Object

Parâmetros

temporal: Object

o objeto temporal a ser ajustado, não nulo

amount: Int64

a quantidade desta unidade a ser adicionada, positiva ou negativa

Retornos

Object

o objeto temporal ajustado, não nulo

Implementações

AddTo(Object, Int64)

Atributos: RegisterAttribute JavaTypeParametersAttribute

Comentários

Retorna uma cópia do objeto temporal especificado com o período especificado adicionado. O período adicionado é um múltiplo desta unidade. Por exemplo, esse método pode ser usado para adicionar "3 dias" a uma data chamando esse método na instância que representa "dias", passando a data e o período "3". O período a ser adicionado pode ser negativo, o que equivale à subtração. Há duas maneiras equivalentes de usar esse método. A primeira é invocar esse método diretamente. A segunda é usar Temporal.plus(long, TemporalUnit):

// these two lines are equivalent, but the second approach is recommended
temporal = thisUnit.addTo(temporal, amount);
temporal = temporal.plus(amount, thisUnit);

É recomendável usar a segunda abordagem, plus(TemporalUnit), pois é muito mais claro ler no código. As implementações devem executar consultas ou cálculos usando as unidades disponíveis no ChronoUnit ou os campos disponíveis em ChronoField. Se a unidade não tiver suporte, um UnsupportedTemporalTypeException deverá ser gerado. As implementações não devem alterar o objeto temporal especificado. Em vez disso, uma cópia ajustada do original deve ser retornada. Isso fornece comportamentos equivalentes e seguros para implementações imutáveis e mutáveis.

Java referência para java.time.temporal.ChronoUnit.addTo.

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

Aplica-se a