DateFormat Clase
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í.
DateFormat es una clase abstracta para las subclases de formato de fecha y hora que da formato y analiza fechas u hora de forma independiente del lenguaje.
[Android.Runtime.Register("java/text/DateFormat", DoNotGenerateAcw=true)]
public abstract class DateFormat : Java.Text._Format
[<Android.Runtime.Register("java/text/DateFormat", DoNotGenerateAcw=true)>]
type DateFormat = class
inherit _Format
- Herencia
- Derivado
- Atributos
Comentarios
DateFormat es una clase abstracta para las subclases de formato de fecha y hora que da formato y analiza fechas u hora de forma independiente del lenguaje. La subclase de formato de fecha y hora, como SimpleDateFormat, permite dar formato (es decir, fecha → texto), análisis (texto → fecha) y normalización. La fecha se representa como un Date objeto o como milisegundos desde el 1 de enero de 1970, 00:00:00 GMT.
DateFormat proporciona muchos métodos de clase para obtener formateadores de fecha y hora predeterminados en función de la configuración regional predeterminada o de una configuración regional determinada y una serie de estilos de formato. Los estilos de formato incluyen #FULL, #LONG, #MEDIUMy #SHORT. En las descripciones del método se proporcionan más detalles y ejemplos de uso de estos estilos.
DateFormat le ayuda a formatear y analizar fechas para cualquier configuración regional. El código puede ser completamente independiente de las convenciones de configuración regional durante meses, días de la semana o incluso el formato del calendario: lunar frente a solar.
Para dar formato a una fecha para la configuración regional actual, use uno de los métodos de fábrica estáticos: <blockquote>
{@code
myString = DateFormat.getDateInstance().format(myDate);
}
</blockquote>
Si da formato a varias fechas, es más eficaz obtener el formato y usarlo varias veces para que el sistema no tenga que capturar la información sobre las convenciones de idioma y país locales varias veces. <blockquote>
{@code
DateFormat df = DateFormat.getDateInstance();
for (int i = 0; i < myDate.length; ++i) {
output.println(df.format(myDate[i]) + "; ");
}
}
</blockquote>
Para dar formato a una fecha para una configuración regional diferente, especifíquela en la llamada a #getDateInstance(int, Locale) getDateInstance().
<blockquote>
{@code
DateFormat df = DateFormat.getDateInstance(DateFormat.LONG, Locale.FRANCE);
}
</blockquote>
También puede usar dateFormat para analizar. <blockquote>
{@code
myDate = df.parse(myString);
}
</blockquote>
Use getDateInstance para obtener el formato de fecha normal para ese país. Hay otros métodos de fábrica estáticos disponibles. Use getTimeInstance para obtener el formato de hora de ese país. Use getDateTimeInstance para obtener un formato de fecha y hora. Puede pasar diferentes opciones a estos métodos de fábrica para controlar la longitud del resultado; de #SHORT a #MEDIUM a #LONG#FULL. El resultado exacto depende de la configuración regional, pero generalmente: <ul><li>#SHORT es completamente numérico, como 12.13.52 o 3:30pm<li>#MEDIUM es más largo, como Jan 12, 1952<li>#LONG es más largo, como January 12, 1952 o3:30:32pm< li>#FULL está bastante especificado, como .Tuesday, April 12, 1952 AD or 3:30:42pm PST
</ul>
También puede establecer la zona horaria en el formato si lo desea. Si desea tener aún más control sobre el formato o el análisis , (o quiere proporcionar a los usuarios más control), puede intentar convertir los que DateFormat obtiene de los métodos de fábrica a .SimpleDateFormat Esto funcionará para la mayoría de los países; recuerde colocarlo en un try bloque en caso de que encuentre uno inusual.
También puede usar formas de los métodos de análisis y formato con ParsePosition y FieldPosition para permitirle <analizar ul><li>progresivamente a través de fragmentos de una cadena.
<li>alinee cualquier campo determinado o averigüe dónde está para la selección en la pantalla.
</ul>
<h2>"synchronization">Synchronization</h2>
Los formatos de fecha no se sincronizan. Se recomienda crear instancias de formato independientes para cada subproceso. Si varios subprocesos acceden a un formato simultáneamente, debe sincronizarse externamente.
Agregado en la versión 1.1.
Java documentación para java.text.DateFormat.
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.
Constructores
| Nombre | Description |
|---|---|
| DateFormat() |
Cree un nuevo formato de fecha. |
| DateFormat(IntPtr, JniHandleOwnership) |
Constructor utilizado al crear representaciones administradas de objetos JNI; llamado por el tiempo de ejecución. |
Campos
| Nombre | Description |
|---|---|
| AmPmField |
Constante útil para AM_PM alineación de campos. |
| DateField |
Constante útil para la alineación del campo DATE. |
| DayOfWeekField |
Constante útil para DAY_OF_WEEK alineación de campos. |
| DayOfWeekInMonthField |
Constante útil para DAY_OF_WEEK_IN_MONTH alineación de campos. |
| DayOfYearField |
Constante útil para DAY_OF_YEAR alineación de campos. |
| Default |
Constante para el patrón de estilo predeterminado. |
| EraField |
Constante útil para la alineación de campos ERA. |
| Full |
Constante para el patrón de estilo completo. |
| Hour0Field |
Constante útil para la alineación de campos HOUR basada en cero. |
| Hour1Field |
Constante útil para la alineación de campos HOUR basada en una sola vez. |
| HourOfDay0Field |
Constante útil para la alineación de campos de HOUR_OF_DAY de base cero. |
| HourOfDay1Field |
Constante útil para la alineación de campos de HOUR_OF_DAY basada en una sola vez. |
| Long |
Constante para el patrón de estilo largo. |
| Medium |
Constante para el patrón de estilo medio. |
| MillisecondField |
Constante útil para la alineación de campos MILLISECOND. |
| MinuteField |
Constante útil para la alineación del campo MINUTE. |
| MonthField |
Constante útil para la alineación del campo MONTH. |
| SecondField |
Constante útil para la alineación del campo SECOND. |
| Short |
Constante para el patrón de estilo corto. |
| TimezoneField |
Constante útil para la alineación del campo TIMEZONE. |
| WeekOfMonthField |
Constante útil para WEEK_OF_MONTH alineación de campos. |
| WeekOfYearField |
Constante útil para WEEK_OF_YEAR alineación de campos. |
| YearField |
Constante útil para la alineación del campo YEAR. |
Propiedades
| Nombre | Description |
|---|---|
| Calendar |
Obtiene el calendario asociado a este formateador de fecha y hora. -o bien- Establezca el calendario que usará este formato de fecha. |
| Class |
Devuelve la clase en tiempo de ejecución de este |
| DateInstance |
Obtiene el formateador de fecha con el estilo de formato predeterminado para la configuración regional predeterminada |
| DateTimeInstance |
Obtiene el formateador de fecha y hora con el estilo de formato predeterminado para la configuración regional predeterminada |
| Handle |
Identificador de la instancia de Android subyacente. (Heredado de Object) |
| Instance |
Obtenga un formateador de fecha y hora predeterminado que use el estilo SHORT para la fecha y la hora. |
| JniIdentityHashCode |
Obtiene el código hash de identidad asignado a este Java del mismo nivel por el tiempo de ejecución de interoperabilidad. (Heredado de Object) |
| JniManagedPeerState |
|
| JniPeerMembers |
|
| Lenient |
Indique si el análisis de fecha y hora es flexible. -o bien- Especifique si el análisis de fecha y hora es lenciente o no. |
| NumberFormat |
Obtiene el formateador de números que usa este formateador de fecha y hora para dar formato y analizar una hora. -o bien- Permite establecer el formateador de números. |
| PeerReference |
Obtiene la referencia de objeto JNI para este Java del mismo nivel. (Heredado de Object) |
| ThresholdClass |
Esta API admite la infraestructura mono para Android y no está pensada para usarse directamente desde el código. |
| ThresholdType |
Esta API admite la infraestructura mono para Android y no está pensada para usarse directamente desde el código. |
| TimeInstance |
Obtiene el formateador de tiempo con el estilo de formato predeterminado para la configuración regional predeterminada |
| TimeZone |
Obtiene la zona horaria. -o bien- Establece la zona horaria del calendario de este |
Métodos
| Nombre | Description |
|---|---|
| Clone() |
Crea y devuelve una copia de este objeto. (Heredado de _Format) |
| Construct(JniObjectReference, JniObjectReferenceOptions) |
|
| Dispose() |
Libera los recursos mantenidos por este Java del mismo nivel. (Heredado de Object) |
| Dispose(Boolean) |
Libera los recursos mantenidos por este Java del mismo nivel. (Heredado de Object) |
| DisposeUnlessReferenced() |
|
| Equals(Object) |
|
| Equals(Object) |
Indica si algún otro objeto es "igual a" este. (Heredado de Object) |
| Format(Date, StringBuffer, FieldPosition) |
Da formato a en |
| Format(Date) |
Da formato a en |
| Format(Object, StringBuffer, FieldPosition) |
Da formato al especificado |
| Format(Object) |
Da formato a un objeto para generar una cadena. (Heredado de _Format) |
| FormatToCharacterIterator(Object) |
Da formato a un objeto que genera un |
| GetAvailableLocales() |
Devuelve una matriz de todas las configuraciones regionales para las que los |
| GetDateInstance(Int32, Locale) |
Obtiene el formateador de fecha con el estilo de formato especificado para la configuración regional especificada. |
| GetDateInstance(Int32) |
Obtiene el formateador de fecha con el estilo de formato especificado para la configuración regional predeterminada |
| GetDateTimeInstance(Int32, Int32, Locale) |
Obtiene el formateador de fecha y hora con los estilos de formato especificados para la configuración regional especificada. |
| GetDateTimeInstance(Int32, Int32) |
Obtiene el formateador de fecha y hora con los estilos de formato de fecha y hora especificados para la configuración regional predeterminada |
| GetHashCode() |
Devuelve un valor de código hash para el objeto . (Heredado de Object) |
| GetTimeInstance(Int32, Locale) |
Obtiene el formateador de tiempo con el estilo de formato especificado para la configuración regional especificada. |
| GetTimeInstance(Int32) |
Obtiene el formateador de tiempo con el estilo de formato especificado para la configuración regional predeterminada |
| JavaFinalize() |
Lo llama el recolector de elementos no utilizados en un objeto cuando la recolección de elementos no utilizados determina que no hay más referencias al objeto . (Heredado de Object) |
| Notify() |
Activa un único subproceso que está esperando en el monitor de este objeto. (Heredado de Object) |
| NotifyAll() |
Activa todos los subprocesos que están esperando en el monitor de este objeto. (Heredado de Object) |
| Parse(String, ParsePosition) |
Analice una cadena de fecha y hora según la posición de análisis especificada. |
| Parse(String) |
Analiza el texto desde el principio de la cadena especificada para generar una fecha. |
| ParseObject(String, ParsePosition) |
Analiza el texto de una cadena para generar un |
| ParseObject(String) |
Analiza el texto desde el principio de la cadena especificada para generar un objeto . (Heredado de _Format) |
| SetHandle(IntPtr, JniHandleOwnership) |
Establece la propiedad Handle. (Heredado de Object) |
| SetPeerReference(JniObjectReference, JniObjectReferenceOptions) |
|
| ToArray<T>() |
Crea una matriz administrada a partir de este contenedor de matriz Java. (Heredado de Object) |
| ToString() |
Devuelve una representación de cadena del objeto . (Heredado de Object) |
| UnregisterFromRuntime() |
Anula el registro de este Java del mismo nivel del tiempo de ejecución de interoperabilidad. (Heredado de Object) |
| Wait() |
Hace que el subproceso actual espere hasta que se despierte, normalmente por ser em notificado/em< o >em<interrumpido>/em<.><> (Heredado de Object) |
| Wait(Int64, Int32) |
Hace que el subproceso actual espere hasta que se despierte, normalmente por ser <em>notificado</em> o <em>interrumpido</em>, o hasta que haya transcurrido una cierta cantidad de tiempo real. (Heredado de Object) |
| Wait(Int64) |
Hace que el subproceso actual espere hasta que se despierte, normalmente por ser <em>notificado</em> o <em>interrumpido</em>, o hasta que haya transcurrido una cierta cantidad de tiempo real. (Heredado de Object) |
Implementaciones de interfaz explícitas
| Nombre | Description |
|---|---|
| IJavaPeerable.Disposed() |
|
| IJavaPeerable.Finalized() |
|
| IJavaPeerable.JniObjectReferenceControlBlock |
|
| IJavaPeerable.SetJniIdentityHashCode(Int32) |
|
| IJavaPeerable.SetJniManagedPeerState(JniManagedPeerStates) |
|
| IJavaPeerable.SetPeerReference(JniObjectReference) |
|
| IJavaPeerable.UnregisterFromRuntime() |
|
Métodos de extensión
| Nombre | Description |
|---|---|
| GetJniTypeName(IJavaPeerable) |
Obtiene el nombre JNI del tipo de la instancia |
| JavaAs<TResult>(IJavaPeerable) |
Intente coerción |
| JavaCast<TResult>(IJavaObject) |
Realiza una conversión de tipos comprobados en tiempo de ejecución de Android. |
| JavaCast<TResult>(IJavaObject) |
|
| TryJavaCast<TResult>(IJavaPeerable, TResult) |
Intente coerción |