ITemporalField.AdjustInto(Object, Int64) Método
Definición
Importante
Parte de la información hace referencia a la versión preliminar del producto, que puede haberse modificado sustancialmente antes de lanzar la versión definitiva. Microsoft no otorga ninguna garantía, explícita o implícita, con respecto a la información proporcionada aquí.
Devuelve una copia del objeto temporal especificado con el valor de este 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.ObjectParámetros
- temporal
- Object
el objeto temporal que se va a ajustar, no null
- newValue
- Int64
nuevo valor del campo
Devoluciones
el objeto temporal ajustado, no null
- Atributos
Comentarios
Devuelve una copia del objeto temporal especificado con el valor de este conjunto de campos.
Esto devuelve un nuevo objeto temporal basado en el especificado con el valor de este campo cambiado. Por ejemplo, en , LocalDatese podría usar para establecer el año, el mes o el día del mes. El objeto devuelto tiene el mismo tipo observable que el objeto especificado.
En algunos casos, el cambio de un campo no está totalmente definido. Por ejemplo, si el objeto de destino es una fecha que representa el 31 de enero, cambiar el mes a febrero sería poco claro. En casos como este, la implementación es responsable de resolver el resultado. Normalmente, elegirá la fecha válida anterior, que sería el último día válido de febrero en este ejemplo.
Hay dos formas equivalentes de usar este método. La primera consiste en invocar directamente este método. El segundo es usar Temporal#with(TemporalField, long):
// these two lines are equivalent, but the second approach is recommended
temporal = thisField.adjustInto(temporal);
temporal = temporal.with(thisField);
Se recomienda usar el segundo enfoque, , with(TemporalField)ya que es mucho más claro leer en el código.
Las implementaciones deben realizar consultas o cálculos mediante los campos disponibles en ChronoField. Si el campo no se admite UnsupportedTemporalTypeException , debe iniciarse .
Las implementaciones no deben modificar el objeto temporal especificado. En su lugar, se debe devolver una copia ajustada del original. Esto proporciona un comportamiento equivalente y seguro para implementaciones inmutables y mutables.
Java documentación para java.time.temporal.TemporalField.adjustInto(R, long).
Las partes de esta página son modificaciones basadas en el trabajo creado y compartido por el Android y se usan según los términos descritos en creative Creative Commons 2.5 Attribution License.