DateTimeFormatter.WithZone(ZoneId) 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 de este formateador con una nueva zona de invalidación.
[Android.Runtime.Register("withZone", "(Ljava/time/ZoneId;)Ljava/time/format/DateTimeFormatter;", "", ApiSince=26)]
public Java.Time.Format.DateTimeFormatter? WithZone(Java.Time.ZoneId? zone);[<Android.Runtime.Register("withZone", "(Ljava/time/ZoneId;)Ljava/time/format/DateTimeFormatter;", "", ApiSince=26)>]
member this.WithZone : Java.Time.ZoneId -> Java.Time.Format.DateTimeFormatterParámetros
- zone
- ZoneId
nueva zona de invalidación, null si no hay invalidación
Devoluciones
un formateador basado en este formateador con la zona de invalidación solicitada, no null
- Atributos
Comentarios
Devuelve una copia de este formateador con una nueva zona de invalidación.
Esto devuelve un formateador con un estado similar a este formateador, pero con el conjunto de zonas de invalidación. De forma predeterminada, un formateador no tiene ninguna zona de invalidación y devuelve null.
Si se agrega una invalidación, se verá afectado cualquier instante con formato o análisis.
Al aplicar formato, si el objeto temporal contiene un instante, se convertirá en una fecha y hora con zona mediante la zona de invalidación. Si el valor temporal es un instante se determina consultando el ChronoField#INSTANT_SECONDS INSTANT_SECONDS campo. Si la entrada tiene una cronología, se conservará a menos que se invalide. Si la entrada no tiene una cronología, como Instant, se usará la cronología ISO.
Si el objeto temporal no contiene un instante, pero contiene un desplazamiento, se realiza una comprobación adicional. Si la zona de invalidación normalizada es un desplazamiento que difiere del desplazamiento de la temporal, se produce una DateTimeException excepción . En todos los demás casos, la zona de invalidación se agrega a la temporal, reemplazando cualquier zona 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 zona directamente desde el texto, quizás porque DateTimeFormatterBuilder#appendZoneId() se usó, esta zona de invalidación no tiene ningún efecto. Si no se ha analizado ninguna zona, esta zona de invalidación se incluirá en el resultado del análisis donde se puede usar para crear instantáneas y horas de fecha.
Esta instancia es inmutable y no se ve afectada por esta llamada de método.
Documentación de Java para java.time.format.DateTimeFormatter.withZone(java.time.ZoneId).
Las partes de esta página son modificaciones basadas en el trabajo creado y compartido por el proyecto de código abierto de Android y se usan según los términos descritos en la licencia de atribución de Creative Commons 2.5.