SimpleDateFormat 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í.
SimpleDateFormat es una clase concreta para dar formato y analizar fechas de forma sensible a la configuración regional.
[Android.Runtime.Register("java/text/SimpleDateFormat", DoNotGenerateAcw=true)]
public class SimpleDateFormat : Java.Text.DateFormat[<Android.Runtime.Register("java/text/SimpleDateFormat", DoNotGenerateAcw=true)>]
type SimpleDateFormat = class
inherit DateFormat- Herencia
- Atributos
Comentarios
SimpleDateFormat es una clase concreta para dar formato y analizar fechas de forma sensible a la configuración regional. Permite dar formato (fecha → texto), analizar (texto → fecha) y normalización.
SimpleDateFormat permite empezar eligiendo los patrones definidos por el usuario para el formato de fecha y hora. Sin embargo, se recomienda crear un formateador de fecha y hora con getTimeInstance, getDateInstanceo getDateTimeInstance en DateFormat. Cada uno de estos métodos de clase puede devolver un formateador de fecha y hora inicializado con un patrón de formato predeterminado. Puede modificar el patrón de formato mediante los applyPattern métodos que desee. Para obtener más información sobre el uso de estos métodos, vea DateFormat.
<h2>Patrones< de fecha y hora/h2>
Los formatos de fecha y hora se especifican mediante <cadenas de>fecha y hora</em> . Dentro de las cadenas de patrones de fecha y hora, las letras sin comillas de 'A' hacia 'Z' y desde 'a' se 'z' interpretan como letras de patrón que representan los componentes de una cadena de fecha u hora. El texto se puede citar mediante comillas simples (') para evitar la interpretación. "''" representa una comilla simple. No se interpretan todos los demás caracteres; simplemente se copian en la cadena de salida durante el formato o coinciden con la cadena de entrada durante el análisis.
Las siguientes letras de patrón se definen (todos los demás caracteres de 'A' hacia y 'Z' desde 'a' a 'z' están reservados): <blockquote><table class="striped"><caption style="display:none">Chart muestra letras de patrón, componente de fecha y hora, presentación y ejemplos.</caption>thead><tr><th scope="col" style="text-align:left">Letter <th scope="col" style="text-align:left">Date or Time Component <th scope="col" style="text-align:left">Presentation <th scope="col" style="text-align:left">Examples <th scope="col" style="text-align:left">Supported (API Levels) </thead><tbody<>tr<>th scope="row">G<td Era>< designator <td>Text<td>AD<td>1+</td<>tr<>th scope="row"><ytd>Year <td Year td Year<td; 96<>>1996td>1+</td><tr><th scope="row"<Y>td>Week year <td Year<td; 09<>>2009td>24+</td><tr><th scope="row"><Mtd>Month in year (context sensitive) <td Month<td>July>; ; 07<Jultd>1+</td<>tr<>th scope="row"><Ltd>Month in year (formulario independiente) <td Month<td>July>; ; 07<Jultd>TBD</td><tr><th scope="row"<>wtd>Week in year <td<>td td td>27><1+</td><tr><th scope="row">W<td>Week in month <td>Number<td td><2td>1+</td<>trth><scope="row"><Dtd>Day in year <td>Number td td<>189<td>1+/td><tr<>th scope="row"><dtd>Day in month <td>number<td td><10>1+<</td><tr><th scope="row"<F>td>Day of week in month <td>td<td td<><2<>>>< tr th scope="row">E<td>Day name in week <td Text><td>Tuesday; Tue<td>1+</td<>tr<>th scope="row"<u>td>Day number of week (1 = Monday, ..., 7 = Sunday) <td>Number<td td1><>24+</td><tr><th scope="row"a<>td>Am/pm marker <td>Text<td td td<>PM>1+</td><tr<>th scope="row"H><td td>Hour in day (0-23) td Number td td td>0><1+</td><tr<>th scope="row"<>ktd>Hour in day (1-24) <td Number<td24>><td>1+/td tr<>th scope="row"<K>td>Hour in am/pm (0-11) <td>Number<td td<>0>1+<</td<>><tr<>th scope=<><"row"><htd>Hour in am/pm (1-12) <td>Number<td td td>>12<1+</td<>tr><th scope="row">m<td>Minute in hour <td>Number<td td><30>1+</td<>tr><th scope="row">s<td>Second in minute <td>Number<td td><>551+</td><Tr><th scope="row">S<td>Milisecond <td>Number<td td>>978<1+</td<>tr<>th scope="row"z><td>Time zone td>General time zone<< td tdPacific Standard Time>; ; ; GMT-08:00<PSTtd>1+/td><tr<>th scope="row">Z<td Time zone <td>>RFC 822 time zone<td td td>><-08001+<</td><tr><th scope="row"X<>td>Time zone td ISO 8601 time zone<< td td-08>>; -0800; ; -08:00<Las letras de patrón td 24+</td<>/tbody></table></blockquote> normalmente se repiten, ya que su número determina la presentación exacta: <ul<>li><strong>"text">Text:</strong> Para formato, si el número de letras de patrón es 4 o más, se usa el formulario completo; de lo contrario, se usa un formulario abreviado o corto si está disponible.> Para el análisis, se aceptan ambos formularios, independientemente del número de letras de patrón.</li><><strong>"number">Number:</strong> For format, the number of pattern letters is the minimum number of digits, and shorter numbers are zero-padded to this amount. Para el análisis, se omite el número de letras de patrón a menos que sea necesario separar dos campos adyacentes.</li><><strong>"year">Year:</strong> Si el formateador #getCalendar() Calendar es el calendario gregoriano, se aplican las siguientes reglas. <ul><li>Para dar formato, si el número de letras de patrón es 2, el año se trunca a 2 dígitos; de lo contrario, se interpreta como un número. <li>Para analizar, si el número de letras de patrón es superior a 2, el año se interpreta literalmente, independientemente del número de dígitos. Por lo tanto, el uso del patrón "MM/dd/aaaa", "01/11/12" analiza hasta el 11 de enero de 12 A.D. <li>Para analizar con el patrón de año abreviado ("y" o "yy"), SimpleDateFormat debe interpretar el año abreviado en relación con algún siglo. Para ello, ajusta las fechas en un plazo de 80 años y 20 años después de la creación de la SimpleDateFormat instancia. Por ejemplo, con un patrón de "MM/dd/yy" y una SimpleDateFormat instancia creada el 1 de enero de 1997, la cadena "01/11/12" se interpretaría como 11 de enero de 2012, mientras que la cadena "05/04/64" se interpretaría como 4 de mayo de 1964. Durante el análisis, solo se analizarán las cadenas que constan de exactamente dos dígitos, tal como se define en Character#isDigit(char)el siglo predeterminado. Cualquier otra cadena numérica, como una cadena de un dígito, una cadena de tres o más dígitos, o una cadena de dos dígitos que no sea todos los dígitos (por ejemplo, "-1"), se interpreta literalmente. Por lo tanto, se analizan "01/02/3" o "01/02/003", con el mismo patrón que el 2 de enero de 3 AD. Del mismo modo, "01/02/-3" se analiza como el 2 de enero de 4 BC. </ul> De lo contrario, se aplican formularios específicos del sistema de calendario. Para el formato y el análisis, si el número de letras de patrón es 4 o más, se usa un formulario long calendar#LONG específico del calendario. De lo contrario, se usa un formulario abreviado o breve de Calendar#SHORT específico del calendario. <br> If week year 'Y' is specified and the #getCalendar() calendar doesn't support any week years, the calendar year ('y') is used instead. El soporte técnico de los años de semana se puede probar con una llamada a DateFormat#getCalendar() getCalendar().java.util.Calendar#isWeekDateSupported() isWeekDateSupported().</li><><strong>"month">Month:</strong> Si el número de letras de patrón es 3 o más, el mes se interpreta como texto; de lo contrario, se interpreta como un número. <ul><li>Letter <em>M</em> produce nombres de mes contextuales, como la forma incrustada de nombres. La letra <em M></em> distingue contexto en el sentido de que, cuando se usa en el patrón independiente, por ejemplo, "MMMM", proporciona la forma independiente de un nombre de mes y cuando se usa en el patrón que contiene otros campos, por ejemplo, "d MMMM", proporciona el formato de un nombre de mes. Por ejemplo, enero en la lengua catalana es "de gener" en el formato mientras es "gener" en el formato independiente. En este caso, "MMMM" generará "gener" y la parte del mes de "d MMMM" producirá "de gener". Si se ha establecido explícitamente con DateFormatSymbols el constructor #SimpleDateFormat(String,DateFormatSymbols) o el método #setDateFormatSymbols(DateFormatSymbols), se usan los nombres de mes proporcionados por .DateFormatSymbols</li li><>letter <em>L</em> produce la forma independiente de nombres de mes.</li></ul><br></li>><<li strong>"timezone">Zona horaria general:</zonas horarias fuertes> se interpretan como texto si tienen nombres. En el caso de las zonas horarias que representan un valor de desplazamiento GMT, se usa la sintaxis siguiente:
<a id="GMTOffsetTimeZone"><i>GMTOffsetTimeZone:</i></a>
{@code GMT} <i>Sign</i> <i>Hours</i> {@code :} <i>Minutes</i>
<i>Sign:</i> one of
{@code + -}
<i>Hours:</i>
<i>Digit</i>
<i>Digit</i> <i>Digit</i>
<i>Minutes:</i>
<i>Digit</i> <i>Digit</i>
<i>Digit:</i> one of
{@code 0 1 2 3 4 5 6 7 8 9}
Las horas deben estar entre 0 y 23 y minutos deben estar entre 00 y 59. El formato es independiente de la configuración regional y los dígitos deben tomarse del bloque latino básico del estándar Unicode.
Para el análisis, también se aceptan zonas horarias RFC 822.</li><><strong>"rfc822timezone">RFC 8222 time zone:</strong> Para formato, se usa el formato de zona horaria rfC 822 de 4 dígitos:
<i>RFC822TimeZone:</i>
<i>Sign</i> <i>TwoDigitHours</i> <i>Minutes</i>
<i>TwoDigitHours:</i>
<i>Digit Digit</i>
TwoDigitHours debe estar comprendido entre 00 y 23. Otras definiciones son las de zonas horarias generales.
Para el análisis, también se aceptan zonas horarias generales. <li><strong>"iso8601timezone">ISO 8601 Time zone:</strong> El número de letras de patrón designa el formato para el formato y el análisis de la siguiente manera:
<i>ISO8601TimeZone:</i>
<i>OneLetterISO8601TimeZone</i>
<i>TwoLetterISO8601TimeZone</i>
<i>ThreeLetterISO8601TimeZone</i>
<i>OneLetterISO8601TimeZone:</i>
<i>Sign</i> <i>TwoDigitHours</i>
{@code Z}
<i>TwoLetterISO8601TimeZone:</i>
<i>Sign</i> <i>TwoDigitHours</i> <i>Minutes</i>
{@code Z}
<i>ThreeLetterISO8601TimeZone:</i>
<i>Sign</i> <i>TwoDigitHours</i> {@code :} <i>Minutes</i>
{@code Z}
Otras definiciones son como para zonas horarias generales o zonas horarias RFC 822.
Para dar formato, si el valor de desplazamiento de GMT es 0, "Z" se genera. Si el número de letras de patrón es 1, se omite cualquier fracción de una hora. Por ejemplo, si el patrón es "X" y la zona horaria es "GMT+05:30", "+05" se genera.
Para el análisis, la letra "Z" se analiza como el designador de zona horaria UTC (por lo tanto "09:30Z" , se analiza como "09:30 UTC". Las zonas horarias generales son <em>not</em> aceptadas.
Si el número de letras de "X" patrón es 4 o más (por ejemplo XXXX, ), IllegalArgumentException se produce al construir un SimpleDateFormat patrón o #applyPattern(String). </ul>SimpleDateFormat también admite <cadenas>de fecha y hora< localizadas/em> . En estas cadenas, las letras de patrón descritas anteriormente se pueden reemplazar por otras letras dependientes de la configuración regional y de patrón. SimpleDateFormat no trata con la localización del texto distinto de las letras de patrón; eso es hasta el cliente de la clase .
<h3>Ejemplos</h3>
En los ejemplos siguientes se muestra cómo se interpretan los patrones de fecha y hora en la configuración regional de Estados Unidos. La fecha y hora especificadas son 2001-07-04 12:08:56 hora local en la zona horaria del Pacífico de EE. UU. <blockquote><table class="striped"><caption style="display:none">Examples of date and time patterns interpret in the U.S. locale</caption><thead tr><th scope="col" style="text-align:left">Date and Time Pattern <th scope="col" style="text-align:left">Result </thead><><tbody><tr><th scope="row"><"yyyy.MM.dd G 'at' HH:mm:ss z"td>2001.07.04 AD at 12:08:56 PDT<tr<>th scope="row">"EEE, MMM d, ''yy"<Td>Wed, Jul 4, '01<tr><th scope="row"<>"h:mm a"td<>12:08 PMtr<>th scope="row""hh 'o''clock' a, zzzz"<>td>12 o'clock PM, Pacific Daylight Time<tr<>th scope="row"<"K:mm a, z">td>0:08 PM, PDT<tr<>th scope="row""yyyyy.MMMMM.dd GGG hh:mm aaa"><td<>02001.July.04 AD 12:08 PMtr<>th scope="row"><"EEE, d MMM yyyy HH:mm:ss Z"td><Wed, 4 Jul 2001 12:08:56 -0700tr<>th scope="row">"yyMMddHHmmssZ"<td tr th scope="row"td010704120856-0700><tr<>th scope="row""yyyy-MM-dd'T'HH:mm:ss.SSSZ"<>td>2001-07-04T12:08:56.235-0700<Tr><th scope="row">"yyyy-MM-dd'T'HH:mm:ss.SSSXXX"<td2001-07-04T12:08:56.235-07:00><tr><th scope="row""YYYY-'W'ww-u"><td><2001-W27-3/tbody<>/table></blockquote>
<h3>"synchronization">Synchronization</h3>
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.
Documentación de Java para java.text.SimpleDateFormat.
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.
Constructores
| SimpleDateFormat() |
Construye mediante |
| SimpleDateFormat(IntPtr, JniHandleOwnership) |
Constructor utilizado al crear representaciones administradas de objetos JNI; llamado por el tiempo de ejecución. |
| SimpleDateFormat(String) |
Construye un |
| SimpleDateFormat(String, DateFormatSymbols) |
Construye un |
| SimpleDateFormat(String, Locale) |
Construye un |
Campos
| AmPmField |
Constante útil para AM_PM alineación de campos. (Heredado de DateFormat) |
| DateField |
Constante útil para la alineación del campo DATE. (Heredado de DateFormat) |
| DayOfWeekField |
Constante útil para DAY_OF_WEEK alineación de campos. (Heredado de DateFormat) |
| DayOfWeekInMonthField |
Constante útil para DAY_OF_WEEK_IN_MONTH alineación de campos. (Heredado de DateFormat) |
| DayOfYearField |
Constante útil para DAY_OF_YEAR alineación de campos. (Heredado de DateFormat) |
| Default |
Constante para el patrón de estilo predeterminado. (Heredado de DateFormat) |
| EraField |
Constante útil para la alineación de campos ERA. (Heredado de DateFormat) |
| Full |
Constante para el patrón de estilo completo. (Heredado de DateFormat) |
| Hour0Field |
Constante útil para la alineación de campos HOUR basada en cero. (Heredado de DateFormat) |
| Hour1Field |
Constante útil para la alineación de campos HOUR basada en una sola vez. (Heredado de DateFormat) |
| HourOfDay0Field |
Constante útil para la alineación de campos de HOUR_OF_DAY de base cero. (Heredado de DateFormat) |
| HourOfDay1Field |
Constante útil para la alineación de campos de HOUR_OF_DAY basada en una sola vez. (Heredado de DateFormat) |
| Long |
Constante para el patrón de estilo largo. (Heredado de DateFormat) |
| Medium |
Constante para el patrón de estilo medio. (Heredado de DateFormat) |
| MillisecondField |
Constante útil para la alineación de campos MILLISECOND. (Heredado de DateFormat) |
| MinuteField |
Constante útil para la alineación del campo MINUTE. (Heredado de DateFormat) |
| MonthField |
Constante útil para la alineación del campo MONTH. (Heredado de DateFormat) |
| SecondField |
Constante útil para la alineación del campo SECOND. (Heredado de DateFormat) |
| Short |
Constante para el patrón de estilo corto. (Heredado de DateFormat) |
| TimezoneField |
Constante útil para la alineación del campo TIMEZONE. (Heredado de DateFormat) |
| WeekOfMonthField |
Constante útil para WEEK_OF_MONTH alineación de campos. (Heredado de DateFormat) |
| WeekOfYearField |
Constante útil para WEEK_OF_YEAR alineación de campos. (Heredado de DateFormat) |
| YearField |
Constante útil para la alineación del campo YEAR. (Heredado de DateFormat) |
Propiedades
| Calendar |
Obtiene el calendario asociado a este formateador de fecha y hora. -o bien- Establezca el calendario que usará este formato de fecha. (Heredado de DateFormat) |
| Class |
Devuelve la clase en tiempo de ejecución de este |
| DateFormatSymbols |
Obtiene una copia de los símbolos de formato de fecha y hora de este formato de fecha. -o bien- Establece los símbolos de formato de fecha y hora de este formato de fecha. |
| Handle |
Identificador de la instancia de Android subyacente. (Heredado de Object) |
| JniIdentityHashCode |
|
| 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. (Heredado de DateFormat) |
| 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. (Heredado de DateFormat) |
| PeerReference |
|
| 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. |
| TimeZone |
Obtiene la zona horaria. -o bien- Establece la zona horaria del calendario de este |
Métodos
| ApplyLocalizedPattern(String) |
Aplica la cadena de patrón localizada dada a este formato de fecha. |
| ApplyPattern(String) |
Aplica la cadena de patrón especificada a este formato de fecha. |
| Clone() |
Crea y devuelve una copia de este objeto. (Heredado de _Format) |
| Dispose() |
|
| Dispose(Boolean) |
|
| Equals(Object) |
Indica si algún otro objeto es "igual a" este. (Heredado de Object) |
| Format(Date) |
Da formato a en |
| Format(Date, StringBuffer, FieldPosition) |
Da formato al especificado |
| Format(Object) |
Da formato a un objeto para generar una cadena. (Heredado de _Format) |
| Format(Object, StringBuffer, FieldPosition) |
Da formato al especificado |
| FormatToCharacterIterator(Object) |
Da formato a un objeto que genera un |
| Get2DigitYearStart() |
Devuelve la fecha inicial de los años de 100 años de 2 dígitos que se interpretan como dentro. |
| GetHashCode() |
Devuelve un valor de código hash del objeto. (Heredado de Object) |
| 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) |
Analiza el texto desde el principio de la cadena especificada para generar una fecha. (Heredado de DateFormat) |
| Parse(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) |
| ParseObject(String, ParsePosition) |
Analiza el texto de una cadena para generar un |
| Set2DigitYearStart(Date) |
Establece que los años de 2 dígitos de período de 100 años se interpretarán como en para comenzar en la fecha en que especifica el usuario. |
| SetHandle(IntPtr, JniHandleOwnership) |
Establece la propiedad Handle. (Heredado de Object) |
| ToArray<T>() |
|
| ToLocalizedPattern() |
Devuelve una cadena de patrón localizada que describe este formato de fecha. |
| ToPattern() |
Devuelve una cadena de patrón que describe este formato de fecha. |
| ToString() |
Devuelve una representación de cadena del objeto. (Heredado de Object) |
| UnregisterFromRuntime() |
|
| Wait() |
Hace que el subproceso actual espere hasta que se despierta, normalmente por ser em notificado/em> o <em>interrumpido</em>.<>< (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) |
| 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) |
Implementaciones de interfaz explícitas
| IJavaPeerable.Disposed() |
|
| IJavaPeerable.DisposeUnlessReferenced() |
|
| IJavaPeerable.Finalized() |
|
| IJavaPeerable.JniManagedPeerState |
|
| IJavaPeerable.SetJniIdentityHashCode(Int32) |
|
| IJavaPeerable.SetJniManagedPeerState(JniManagedPeerStates) |
|
| IJavaPeerable.SetPeerReference(JniObjectReference) |
|
Métodos de extensión
| JavaCast<TResult>(IJavaObject) |
Realiza una conversión de tipos comprobados en tiempo de ejecución de Android. |
| JavaCast<TResult>(IJavaObject) |
|
| GetJniTypeName(IJavaPeerable) |
|