ZonedDateTime.With 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í.
Sobrecargas
| Nombre | Description |
|---|---|
| With(ITemporalField, Int64) |
Devuelve una copia de esta fecha y hora con el campo especificado establecido en un nuevo valor. |
| With(ITemporalAdjuster) |
Devuelve una copia ajustada de esta fecha y hora. |
With(ITemporalField, Int64)
Devuelve una copia de esta fecha y hora con el campo especificado establecido en un nuevo valor.
[Android.Runtime.Register("with", "(Ljava/time/temporal/TemporalField;J)Ljava/time/ZonedDateTime;", "", ApiSince=26)]
public Java.Time.Temporal.ITemporal? With(Java.Time.Temporal.ITemporalField? field, long newValue);
[<Android.Runtime.Register("with", "(Ljava/time/temporal/TemporalField;J)Ljava/time/ZonedDateTime;", "", ApiSince=26)>]
abstract member With : Java.Time.Temporal.ITemporalField * int64 -> Java.Time.Temporal.ITemporal
override this.With : Java.Time.Temporal.ITemporalField * int64 -> Java.Time.Temporal.ITemporal
Parámetros
- field
- ITemporalField
el campo que se va a establecer en el resultado, no null
- newValue
- Int64
nuevo valor del campo en el resultado
Devoluciones
un zonedDateTime basado en esto con el conjunto de campos especificado, no null
- Atributos
Comentarios
Devuelve una copia de esta fecha y hora con el campo especificado establecido en un nuevo valor. Esto devuelve un objeto ZonedDateTime, basado en este, con el valor del campo especificado cambiado. Esto se puede usar para cambiar cualquier campo admitido, como el año, el mes o el día del mes. Si no es posible establecer el valor, porque el campo no se admite o por algún otro motivo, se produce una excepción. En algunos casos, cambiar el campo especificado puede hacer que la fecha y hora resultante no sean válidas, como cambiar el mes del 31 de enero a febrero haría que el día del mes no sea válido. En casos como este, el campo es responsable de resolver la fecha. Normalmente, elegirá la fecha válida anterior, que sería el último día válido de febrero en este ejemplo. Si el campo es un ChronoField, el ajuste se implementa aquí. El campo INSTANT_SECONDS devolverá una fecha y hora con el instante especificado. La zona y nano-of-second no se modifican. El resultado tendrá un desplazamiento derivado de la nueva zona instantánea y original. Si el nuevo valor instantáneo está fuera del intervalo válido, se producirá una excepción DateTimeException. Normalmente, se omitirá el campo OFFSET_SECONDS. El desplazamiento de zonedDateTime se controla principalmente por la zona horaria. Por lo tanto, cambiar el desplazamiento no suele tener sentido, ya que solo hay un desplazamiento válido para la fecha y la zona locales. Si la fecha y hora con zona se superponen al horario de verano, el desplazamiento se usa para cambiar entre los dos desplazamientos válidos. En todos los demás casos, se omite el desplazamiento. Si el nuevo valor de desplazamiento está fuera del intervalo válido, se producirá una excepción DateTimeException. Los demás campos admitidos se comportarán según el método coincidente en LocalDateTime. La zona no forma parte del cálculo y no se modificará. Al volver a convertir a ZonedDateTime, si la fecha y hora local está en superposición, el desplazamiento se conservará si es posible; de lo contrario, se usará el desplazamiento anterior. Si está en un hueco, la fecha y hora local se ajustará hacia delante por la longitud del intervalo. Todas las demás instancias de ChronoField producirán una excepción UnsupportedTemporalesTypeException. Si el campo no es un ChronoField, el resultado de este método se obtiene invocando TemporalField.adjustInto(Temporal, long) pasando esto como argumento. En este caso, el campo determina si y cómo ajustar el instante. Esta instancia es inmutable y no se ve afectada por esta llamada de método.
referencia Java referencia para java.time.ZonedDateTime.with.
Se aplica a
With(ITemporalAdjuster)
Devuelve una copia ajustada de esta fecha y hora.
[Android.Runtime.Register("with", "(Ljava/time/temporal/TemporalAdjuster;)Ljava/time/ZonedDateTime;", "", ApiSince=26)]
public Java.Time.ZonedDateTime? With(Java.Time.Temporal.ITemporalAdjuster? adjuster);
[<Android.Runtime.Register("with", "(Ljava/time/temporal/TemporalAdjuster;)Ljava/time/ZonedDateTime;", "", ApiSince=26)>]
member this.With : Java.Time.Temporal.ITemporalAdjuster -> Java.Time.ZonedDateTime
Parámetros
- adjuster
- ITemporalAdjuster
el ajustador que se va a usar, no null
Devoluciones
zonedDateTime en función de esto con el ajuste realizado, no null
- Atributos
Comentarios
Devuelve una copia ajustada de esta fecha y hora. Esto devuelve zonedDateTime, basado en este, con la fecha y hora ajustada. El ajuste tiene lugar mediante el objeto de estrategia del ajustador especificado. Lea la documentación del ajustador para comprender qué ajuste se realizará. Un ajustador simple podría simplemente establecer uno de los campos, como el campo año. Un ajustador más complejo podría establecer la fecha en el último día del mes. Se proporciona una selección de ajustes comunes en TemporalAdjusters. Estos incluyen buscar el "último día del mes" y "el próximo miércoles". Las clases clave de fecha y hora también implementan la interfaz TemporalAdjuster, como Month y MonthDay. El ajustador es responsable de manejar casos especiales, como las distintas longitudes de mes y años bisiestos. Por ejemplo, este código devuelve una fecha el último día de julio: las clases LocalDate y LocalTime implementan TemporalAdjuster, por lo que este método se puede usar para cambiar la fecha, hora o desplazamiento: ZoneOffset también implementa TemporalAdjuster, pero su uso como argumento normalmente no tiene ningún efecto. El desplazamiento de zonedDateTime se controla principalmente por la zona horaria. Por lo tanto, cambiar el desplazamiento no suele tener sentido, ya que solo hay un desplazamiento válido para la fecha y la zona locales. Si la fecha y hora con zona se superponen al horario de verano, el desplazamiento se usa para cambiar entre los dos desplazamientos válidos. En todos los demás casos, se omite el desplazamiento. El resultado de este método se obtiene invocando el método TemporalAdjuster.adjustInto(Temporal) en el ajustador especificado pasando esto como argumento. Esta instancia es inmutable y no se ve afectada por esta llamada de método.
referencia Java referencia para java.time.ZonedDateTime.with.