Lenguaje

DateTimeFormatter.WithChronology(IChronology) Método

Definición

Devuelve una copia de este formateador con una nueva cronología de invalidación.

[Android.Runtime.Register("withChronology", "(Ljava/time/chrono/Chronology;)Ljava/time/format/DateTimeFormatter;", "", ApiSince=26)]
public Java.Time.Format.DateTimeFormatter? WithChronology(Java.Time.Chrono.IChronology? chrono);
[<Android.Runtime.Register("withChronology", "(Ljava/time/chrono/Chronology;)Ljava/time/format/DateTimeFormatter;", "", ApiSince=26)>]
member this.WithChronology : Java.Time.Chrono.IChronology -> Java.Time.Format.DateTimeFormatter

Parámetros

chrono
IChronology

la nueva cronología, null si no hay invalidación

Devoluciones

un formateador basado en este formateador con la cronología de invalidación solicitada, no null

Atributos

Comentarios

Devuelve una copia de este formateador con una nueva cronología de invalidación.

Esto devuelve un formateador con un estado similar a este formateador, pero con el conjunto de cronología de invalidación. De forma predeterminada, un formateador no tiene cronología de invalidación, devolviendo null.

Si se agrega una invalidación, se verá afectada cualquier fecha con formato o análisis.

Al aplicar formato, si el objeto temporal contiene una fecha, se convertirá a una fecha en la cronología de invalidación. Si el valor temporal contiene una fecha se determina consultando el ChronoField#EPOCH_DAY EPOCH_DAY campo. Cualquier hora o zona se conservará sin modificar a menos que se invalide.

Si el objeto temporal no contiene una fecha, pero contiene uno o varios ChronoField campos de fecha, se produce una DateTimeException excepción . En todos los demás casos, la cronología de invalidación se agrega a la temporal, reemplazando cualquier cronología anterior, pero sin cambiar la fecha y hora.

Al analizar, hay dos casos distintos que se deben tener en cuenta. Si se ha analizado una cronología directamente desde el texto, quizás porque DateTimeFormatterBuilder#appendChronologyId() se usó, esta cronología de invalidación no tiene ningún efecto. Si no se ha analizado ninguna zona, esta cronología de invalidación se usará para interpretar los ChronoField valores en una fecha según las reglas de resolución de fecha de la cronología.

Esta instancia es inmutable y no se ve afectada por esta llamada de método.

Java documentación para java.time.format.DateTimeFormatter.withChronology(java.time.chrono.Chronology).

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.

Se aplica a