ITemporalUnit.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;", "GetAddTo_Ljava_time_temporal_Temporal_JHandler:Java.Time.Temporal.ITemporalUnitInvoker, Mono.Android, Version=0.0.0.0, Culture=neutral, PublicKeyToken=null", 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;", "GetAddTo_Ljava_time_temporal_Temporal_JHandler:Java.Time.Temporal.ITemporalUnitInvoker, Mono.Android, Version=0.0.0.0, Culture=neutral, PublicKeyToken=null", ApiSince=26)>]
[<Java.Interop.JavaTypeParameters(new System.String[] { "R extends java.time.temporal.Temporal" })>]
abstract member 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

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);
              temporal = temporal.plus(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 ou ChronoUnit os campos disponíveis em ChronoField. Se não houver suporte para a unidade, será necessário gerar uma UnsupportedTemporalTypeException unidade.

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 documentação para java.time.temporal.TemporalUnit.addTo(R, long).

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