Permite el manejo de las distintas representaciones y formatos de fechas. Configura una forma y estilo de cómo se visualizará una fecha.
El formato se define mediante un parametro String que adopta el estandar unicode de fechas. Se soportan la mayor parte de las configuraciones a excepción de formatos de las siguientes combinaciones de localización: MMM, MMMM, MMMMM, zzzz y los caracteres: Y, D, q, Q, W, e, E, A, k, K, j.
CONSTRUCTORES
Inicializa el DateFormatter con el formato de fecha del argumento y un desplazamiento en horas igual al argumento utcTimeZoneOffset con respecto a la zona horaria UTC.
Argumentos |
|
format |
String: formato de fecha unicode. |
utcTimeZoneOffset |
Integer: desplazamiento en horas desde UTC |
Excepciones |
|
TimeZoneOffsetOutOfRange – Error trying to create a Date instance with an out of range timezone offset. Range must be between -18 to +18.. |
Se intentó configurar una fecha con un desplazamiento fuera del rango permitido [-18…18] . |
Inicializa el DateFormatter con el formato de fecha del argumento y desplazamiento 0 (zona horaria UTC).
Argumentos |
|
format |
String: formato de fecha unicode. |
Inicializa el DateFormatter con el formato “yyyy-MM-dd’T’HH:mm:ss Z” y desplazamiento 0 (zona horaria UTC).
METODOS PUBLICOS
Date dateFromString(String fecha)
Parsea y convierte el argumento fecha, retornando una nueva instancia Date utilizando el formato con el cual fue configurada la instancia DateFormatter.
Argumentos |
|
fecha |
String: fecha. |
Retorna |
|
Date |
Fecha resultante. |
Excepciones |
|
WrongDateFormat – Error trying to create date formatter with invalid format: [DateFormat]. |
El parámetro fecha no fue posible de convertir a tipo Date debido a que no coincide con el formato configurado. |
String stringFromDate(Date fecha)
Genera la representación en String de la fecha argumento, en base al formato con el cual fue configurada la instancia DateFormatter.
Argumentos |
|
fecha |
Date: fecha. |
Retorna |
|
String |
Representación de fecha resultante. |
Excepciones |
|
WrongDateFormat – Error trying to create date formatter with invalid format: ‘DateFormat’. |
El parámetro fecha no fue posible de convertir a tipo Date debido a que no coincide con el formato configurado. |