ITemporalField.AdjustInto(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 valor desse conjunto de campos.

[Android.Runtime.Register("adjustInto", "(Ljava/time/temporal/Temporal;J)Ljava/time/temporal/Temporal;", "GetAdjustInto_Ljava_time_temporal_Temporal_JHandler:Java.Time.Temporal.ITemporalFieldInvoker, 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? AdjustInto(Java.Lang.Object? temporal, long newValue);

[<Android.Runtime.Register("adjustInto", "(Ljava/time/temporal/Temporal;J)Ljava/time/temporal/Temporal;", "GetAdjustInto_Ljava_time_temporal_Temporal_JHandler:Java.Time.Temporal.ITemporalFieldInvoker, 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 AdjustInto : Java.Lang.Object * int64 -> Java.Lang.Object

Parâmetros

temporal: Object

o objeto temporal a ser ajustado, não nulo

newValue: Int64

o novo valor do campo

Retornos

Object

o objeto temporal ajustado, não nulo

Atributos: RegisterAttribute JavaTypeParametersAttribute

Comentários

Retorna uma cópia do objeto temporal especificado com o valor desse conjunto de campos.

Isso retorna um novo objeto temporal com base no especificado com o valor desse campo alterado. Por exemplo, em um LocalDate, isso pode ser usado para definir o ano, mês ou dia do mês. O objeto retornado tem o mesmo tipo observável que o objeto especificado.

Em alguns casos, a alteração de um campo não está totalmente definida. Por exemplo, se o objeto de destino for uma data que representa o dia 31 de janeiro, a alteração do mês para fevereiro não será clara. Em casos como esse, a implementação é responsável por resolver o resultado. Normalmente, ele escolherá a data válida anterior, que seria o último dia válido de fevereiro neste exemplo.

Há duas maneiras equivalentes de usar esse método. A primeira é invocar esse método diretamente. A segunda é usar Temporal#with(TemporalField, long):

// these two lines are equivalent, but the second approach is recommended
              temporal = thisField.adjustInto(temporal);
              temporal = temporal.with(thisField);

É recomendável usar a segunda abordagem, with(TemporalField)pois é muito mais claro ler no código.

As implementações devem executar consultas ou cálculos usando os campos disponíveis em ChronoField. Se não houver suporte para o campo, um UnsupportedTemporalTypeException deve ser lançado.

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.TemporalField.adjustInto(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