Enumeración de los formatos predefinidos de fecha/hora utilizados en toda la interfaz de usuario y las capas de exportación de ProjectForge. Define 16 niveles de formato distintos, desde solo fecha simple (DATE_WITHOUT_YEAR) hasta marcas de tiempo ISO 8601 completas (ISO_TIMESTAMP_MILLIS). Sirve como un catálogo de formatos declarativos: las cadenas de patrón de formato reales se resuelven en tiempo de ejecución mediante DateHelper o la configuración regional del usuario, lo que permite el formato de fecha sensible a la configuración regional sin cadenas de patrón codificadas.
Categorías de Formato
Formatos Solo Fecha
| Constante de Enum | Ejemplo de Patrón | Caso de Uso |
|---|
DATE_WITHOUT_YEAR | dd.MM. / MM/dd / dd/MM | Cumpleaños mostrados sin año, listas de día-mes |
DATE | dd.MM.yyyy / MM/dd/yyyy | Visualización general de fechas, campos de fecha en formularios |
DATE_WITH_DAY_NAME | E, dd.MM.yyyy | Vistas de calendario, páginas de programación que muestran el día de la semana |
DATE_SHORT | dd.MM.yy / MM/dd/yy | Exportaciones a Excel, vistas de lista compactas |
ISO_DATE | yyyy-MM-dd | Consultas a bases de datos, respuestas de API, intercambio de datos |
Formatos de Fecha y Hora
| Constante de Enum | Precisión | Caso de Uso |
|---|
DATE_TIME_SHORT_SECONDS | DATE_SHORT + HH:mm:ss | Registros compactos, entradas de pista de auditoría |
DATE_TIME_SHORT_MINUTES | DATE_SHORT + HH:mm | Horas de eventos de calendario, horarios de reuniones |
DATE_TIME_MILLIS | DATE + HH:mm:ss.SSS | Marcas de tiempo precisas con milisegundos |
DATE_TIME_SECONDS | DATE + HH:mm:ss | Visualización general de marcas de tiempo, registros de auditoría |
DATE_TIME_MINUTES | DATE + HH:mm | Entradas de hoja de horas, seguimiento de tiempo de proyectos |
Formatos Solo Hora
| Constante de Enum | Patrón | Caso de Uso |
|---|
TIME_OF_DAY_SECONDS | HH:mm:ss | Visualizaciones de duración, vistas tipo cronómetro |
TIME_OF_DAY_MINUTES | HH:mm | Entradas de hora, horas de reuniones, horarios de apertura |
Formatos de Marca de Tiempo ISO 8601
| Constante de Enum | Patrón | Caso de Uso |
|---|
ISO_TIMESTAMP_MILLIS | yyyy-MM-dd HH:mm:ss.SSS | Registro de alta precisión, columnas de auditoría de base de datos |
ISO_TIMESTAMP_SECONDS | yyyy-MM-dd HH:mm:ss | Respuestas de API, serialización JSON, endpoints REST |
ISO_TIMESTAMP_MINUTES | yyyy-MM-dd HH:mm | Exportación de calendario (iCal), sistemas de programación |
Formato Especial
| Constante de Enum | Patrón | Caso de Uso |
|---|
DAY_OF_WEEK_SHORT | EE (lun, mar, ...) | Encabezados de semana en vistas de calendario, resumen semanal de hoja de horas |
Conciencia de Configuración Regional
Los comentarios Javadoc para DATE y DATE_WITHOUT_YEAR muestran múltiples ejemplos de patrones ("dd.MM.", "MM/dd", "dd/MM"), lo que indica que estas constantes de enumeración representan la intención del formato más que patrones fijos. La cadena de patrón real es resuelta por DateHelper según la configuración regional del usuario:
- Configuración regional alemana →
dd.MM.yyyy
- Configuración regional de EE. UU. →
MM/dd/yyyy
- Configuración regional del Reino Unido →
dd/MM/yyyy
Esta es una característica de diseño crítica para la base de usuarios internacional de ProjectForge.
Notación de Exportación a Excel
El Javadoc de la constante DATE_SHORT incluye notación específica de Excel: "DD.MM.YY", "MM/DD/YY", "DD/MM/YY". Esto sugiere que las constantes de DateFormatType también son utilizadas por el módulo de exportación a Excel (org.projectforge.business.excel) que asigna estos valores de enumeración a cadenas de formato de celda de Excel, diferentes de los patrones de SimpleDateFormat de Java (el mes es MM en Excel vs MM en Java, pero existen diferencias de mayúsculas).
Relación con DateHelper
Si bien este archivo solo define las constantes de enumeración, la lógica de resolución de formato real reside en DateHelper (en el mismo paquete). Es probable que DateHelper contenga un método getFormat(DateFormatType, Locale) o similar que asigna cada constante de enumeración a una instancia de DateFormat o SimpleDateFormat específica de la configuración regional.
Patrón de Diseño: Enum como Catálogo Declarativo
Esta enumeración sigue un patrón donde el enum sirve como un catálogo declarativo de opciones disponibles, mientras que el comportamiento real se implementa en otro lugar (DateHelper). Esta separación permite:
- Que los componentes de la interfaz de usuario ofrezcan una lista desplegable de todos los formatos disponibles (iteración del enum)
- Que la lógica de negocio haga referencia a los formatos por nombre semántico en lugar de una cadena de patrón
- La resolución centralizada de la configuración regional en DateHelper sin duplicar la lógica de formato en el enum
- La serialización de las preferencias de formato (por ejemplo, el formato de fecha preferido del usuario almacenado como nombre del enum en la base de datos)
Los formatos de marca de tiempo ISO utilizan un separador de espacio (yyyy-MM-dd HH:mm:ss) en lugar del separador T estándar ISO 8601 (yyyy-MM-ddTHH:mm:ss). Aunque es común en contextos de bases de datos y visualización, técnicamente no es ISO 8601 estricto. Los nombres de los formatos sugieren cumplimiento ISO, pero los patrones reales son "similares a ISO".
Las 16 constantes de formato cubren un rango completo desde "sin año" hasta "precisión de milisegundos". Esta granularidad refleja los diversos casos de uso de ProjectForge: gestión de hojas de horas (precisión de minutos), informes financieros (precisión de días), pistas de auditoría (precisión de milisegundos), vistas de calendario (día de la semana) y seguimiento de migraciones de bases de datos (marcas de tiempo ISO). Cada formato cumple un requisito específico de UX o de datos.