DateIntervalInfo Clase

Definición

[Android.Runtime.Register("android/icu/text/DateIntervalInfo", ApiSince=24, DoNotGenerateAcw=true)]
public class DateIntervalInfo : Java.Lang.Object, Android.Icu.Util.IFreezable, IDisposable, Java.IO.ISerializable

[<Android.Runtime.Register("android/icu/text/DateIntervalInfo", ApiSince=24, DoNotGenerateAcw=true)>]
type DateIntervalInfo = class
    inherit Object
    interface IFreezable
    interface ICloneable
    interface IJavaObject
    interface IDisposable
    interface IJavaPeerable
    interface ISerializable

Herencia

Object

JavaObject

Object

DateIntervalInfo

Atributos

RegisterAttribute

Implementaciones

IFreezable IJavaObject IJavaPeerable ISerializable ICloneable IDisposable

Comentarios

DateIntervalInfo es una clase pública para encapsular patrones de intervalo de fecha y hora localizables. Lo usa DateIntervalFormat.

Para la mayoría de los usuarios, el uso normal de DateIntervalFormat no necesita crear directamente el objeto DateIntervalInfo. DateIntervalFormat se encargará de él al crear un formateador de intervalo de fecha cuando el usuario pase el esqueleto y la configuración regional.

Para los usuarios avanzados, que quieran crear sus propios patrones de intervalo de fecha, o que quieran volver a establecer patrones de intervalo de fecha, podrían hacerlo creando directamente DateIntervalInfo y manipulandolo.

Lógicamente, los patrones de intervalo son asignaciones de (esqueleto, the_largest_different_calendar_field) a (date_interval_pattern).

Un esqueleto ol <><li> solo mantiene la letra de patrón de campo y omite todas las demás partes de un patrón, como el espacio, los signos de puntuación y los literales de cadena. <li> oculta el orden de los campos. <li> puede ocultar la longitud de letra de patrón de un campo.

Para esos campos de calendario que no son de dígitos, la longitud de la letra de patrón es importante, como MMM, MMMM y MMMMM; EEE y EEEE, y se respeta la longitud de letra de patrón del campo.

Para los campos de calendario de dígitos, como M o MM, d o dd, aaaa o aaaa, se omite la longitud del patrón de campo y la mejor coincidencia, que se define en los patrones de fecha y hora, se devolverá sin respetar la longitud de la letra del patrón de campo en esqueleto. </ol>

Los campos de calendario que se admiten para el formato de intervalo son: año, mes, fecha, día de la semana, am-pm, hora, hora del día, minuto y segundo (aunque actualmente no tenemos datos intervalFormat específicos para esqueletos con segundos). Esos campos de calendario se pueden definir en el orden siguiente: año > mes > fecha > am-pm > hora > minute > segundo

Los campos de calendario más grandes entre 2 calendarios es el primer campo de calendario diferente en el orden anterior.

Por ejemplo: los campos de calendario más grandes entre "10 de enero de 2007" y "20 de febrero de 2008" es el año.

Hay un conjunto de cadenas de esqueleto estáticas predefinidas. Hay patrones de intervalo predefinidos para esos esqueletos predefinidos en los archivos de recursos locales. Por ejemplo, para un esqueleto YEAR_ABBR_MONTH_DAY, que es "yMMMd", en en_US, si el campo de calendario más grande entre date1 y date2 es "year", el patrón de intervalo de fecha es "MMM d, aaaa - MMM d, aaaa", como "10 de enero de 2007 - 10 de enero de 2008". Si el campo de calendario más grande entre date1 y date2 es "month", el patrón de intervalo de fecha es "MMM d - MMM d, aaaa", como "10 de enero - 10 de febrero de 2007". Si el campo de calendario más grande entre date1 y date2 es "day", el patrón de intervalo de fecha es ""MMM d-d, aaaa", como "Jan 10-20, 2007".

Para el esqueleto de fecha, los patrones de intervalo cuando el año o el mes o la fecha son diferentes se definen en los archivos de recursos. Para el esqueleto de tiempo, los patrones de intervalo cuando am/pm, hora o minuto son diferentes se definen en los archivos de recursos.

Hay 2 fechas en el patrón de intervalo. Para la mayoría de las configuraciones regionales, la primera fecha de un patrón de intervalo es la fecha anterior. Puede haber una configuración regional en la que la primera fecha de un patrón de intervalo es la fecha posterior. Usamos el formato de reserva para el orden predeterminado de la configuración regional. Por ejemplo, si el formato de reserva es " -{0}{1}", significa que la primera fecha del patrón de intervalo para esta configuración regional es anterior. Si el formato de reserva es " -{1}{0}", significa que la primera fecha es la fecha posterior. Para un patrón de intervalo determinado, el orden predeterminado se puede invalidar mediante el prefijo "latestFirst:" o "earliestFirst:" en el patrón de intervalo. Por ejemplo, si el formato de reserva es "{0}-{1}", pero para el esqueleto "yMMMd", el patrón de intervalo cuando el día es diferente es "latestFirst:d-d MMM yy", significa de forma predeterminada, la primera fecha en el patrón de intervalo es la fecha anterior. Pero para el esqueleto "yMMMd", cuando el día es diferente, la primera fecha en "d-d MMM yy" es la fecha posterior.

La manera recomendada de crear un objeto DateIntervalFormat es pasar en la configuración regional. Mediante el uso de un parámetro Locale, el objeto DateIntervalFormat se inicializa con los patrones de intervalo predefinidos para una configuración regional determinada o predeterminada.

Los usuarios también pueden crear un objeto DateIntervalFormat proporcionando sus propios patrones de intervalo. Proporciona flexibilidad para el uso de energía.

Después de crear un objeto DateIntervalInfo, los clientes pueden modificar los patrones de intervalo mediante la función setIntervalPattern como desee. Actualmente, los usuarios solo pueden establecer patrones de intervalo cuando los siguientes campos de calendario son diferentes: ERA, YEAR, MONTH, DATE, DAY_OF_MONTH, DAY_OF_WEEK, AM_PM, HOUR, HOUR_OF_DAY, MINUTE, SECOND y MILISECOND. No se admiten patrones de intervalo cuando otros campos de calendario son diferentes.

Los objetos DateIntervalInfo se pueden clonar. Cuando los clientes obtienen un objeto DateIntervalInfo, pueden sentirse libres de modificarlo según sea necesario.

No se espera que DateIntervalInfo se subclase. Los datos de un calendario se cargan fuera de los conjuntos de recursos. A través de ICU 4.4, los patrones de intervalo de fecha solo se admiten en el calendario gregoriano; Los calendarios no gregorianos son compatibles con ICU 4.4.1.

Java documentación para android.icu.text.DateIntervalInfo.

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.