Formateo de Fechas

Visión general

El formateo de fechas convierte objetos Date o DateTime en strings legibles (y viceversa). Es esencial para APIs, interfaces de usuario, reportes y cualquier sistema que intercambie datos temporales.

Almacena y transmite siempre las fechas en UTC (ISO 8601), y formatea a hora local solo en la capa de presentación.

Cuándo usarlo

Usa esta recipe cuando:

• Serializas fechas a JSON o XML para APIs
• Muestras fechas en interfaces de usuario con localización apropiada
• Parseas fechas ingresadas por usuarios desde formularios o archivos. Consulta Data Validation para sanitizar input.
• Conviertes entre timezones para aplicaciones globales
• Logueas y auditas eventos con timestamps precisos. Consulta Logging para patrones de observabilidad.

Solución

Python

from datetime import datetime, timezone, timedelta

# Hora UTC actual
now_utc = datetime.now(timezone.utc)
print(now_utc.isoformat())  # 2026-06-10T14:30:00+00:00

# Formatear para display
print(now_utc.strftime("%Y-%m-%d %H:%M:%S"))  # 2026-06-10 14:30:00
print(now_utc.strftime("%A, %B %d, %Y"))      # Tuesday, June 10, 2026

# Parsear string ISO 8601
dt = datetime.fromisoformat("2026-06-10T14:30:00+00:00")

# Convertir timezone
berlin = dt.astimezone(timezone(timedelta(hours=2)))
print(berlin.strftime("%Y-%m-%d %H:%M:%S %z"))  # 2026-06-10 16:30:00 +0200

JavaScript

const now = new Date();

// ISO 8601 (siempre UTC)
console.log(now.toISOString()); // 2026-06-10T14:30:00.000Z

// Formateo locale-specific
console.log(now.toLocaleString('en-US', {
  dateStyle: 'full',
  timeStyle: 'short',
  timeZone: 'America/New_York',
})); // Tuesday, June 10, 2026 at 10:30 AM

// Formatear con Intl.DateTimeFormat
const fmt = new Intl.DateTimeFormat('de-DE', {
  year: 'numeric', month: '2-digit', day: '2-digit',
  hour: '2-digit', minute: '2-digit',
  timeZone: 'Europe/Berlin',
});
console.log(fmt.format(now)); // 10.06.2026, 16:30

// Parsear string ISO
const parsed = new Date('2026-06-10T14:30:00Z');
console.log(parsed.toISOString());

Java

import java.time.*;
import java.time.format.DateTimeFormatter;

// UTC actual
ZonedDateTime nowUtc = ZonedDateTime.now(ZoneOffset.UTC);
System.out.println(nowUtc.format(DateTimeFormatter.ISO_INSTANT));

// Formatear para display
DateTimeFormatter formatter = DateTimeFormatter.ofPattern("yyyy-MM-dd HH:mm:ss z");
System.out.println(nowUtc.format(formatter)); // 2026-06-10 14:30:00 UTC

// Parsear string ISO
ZonedDateTime parsed = ZonedDateTime.parse("2026-06-10T14:30:00Z", DateTimeFormatter.ISO_INSTANT);

// Convertir timezone
ZonedDateTime tokyo = parsed.withZoneSameInstant(ZoneId.of("Asia/Tokyo"));
System.out.println(tokyo.format(formatter)); // 2026-06-10 23:30:00 JST

Patrones de formato comunes

Patrón	Ejemplo	Descripción
yyyy-MM-dd	2026-06-10	Fecha ISO
yyyy-MM-dd'T'HH:mm:ss'Z'	2026-06-10T14:30:00Z	ISO 8601 UTC
MMM d, yyyy	Jun 10, 2026	Nombre de mes corto
EEEE, MMMM d, yyyy	Tuesday, June 10, 2026	Día de semana y mes completos
HH:mm:ss	14:30:00	Hora 24h
h:mm a	2:30 PM	Hora 12h con AM/PM

Lo que funciona

• Almacena en UTC: Persiste todas las fechas en UTC para evitar ambigüedad
• Usa ISO 8601 para APIs: 2026-06-10T14:30:00Z es inequívoco y universalmente parseable
• Formatea en el edge: Convierte a hora local solo al renderizar para el usuario
• Incluye offsets de timezone en respuestas de API: Ayuda a clientes a mostrar hora local correcta
• Evita formatos ambiguos: 02/03/2026 podría ser 2 de marzo o 3 de febrero según el locale
• Usa IDs de timezone conocidos: Prefiere America/New_York sobre EST porque este último no considera DST

Errores comunes

• Almacenar hora local sin información de timezone, causando confusión durante cambios de horario de verano
• Usar Date.parse() con strings no ISO (el comportamiento varía entre browsers)
• Formatear fechas en el backend con el timezone local del servidor en lugar del del usuario
• Ignorar leap seconds y edge cases en aritmética de calendario
• Concatenar fechas como strings en lugar de usar librerías de fechas apropiadas

Cuando No Usar Este Enfoque

• Formatting locale-aware en sistemas distribuidos: si los servidores spanean multiples timezones, formatear fechas localmente por-servidor causa inconsistencias.
• Llamadas de formatting de alta frecuencia: si el formatting se llama millones de veces por segundo, el overhead de strftime o Intl. DateTimeFormat se vuelve significativo.
• Calculos financieros que requieren precision exacta: la aritmetica de floating-point causa errores de redondeo en calculos de dinero (0. 1 + 0. 2 ! = 0. 3).
• URL encoding de strings ya encodeados: double-encoding %20 produce %2520.
• Generacion de UUID en paths performance-critical: la generacion de UUIDv4 usa CSPRNG que es 10-100x mas lento que IDs secuenciales.
• Parsing de argumentos CLI para scripts simples: si un script necesita 2-3 flags, rgparse o commander es excesivo.

Benchmarks de Rendimiento

• Formatting de fechas: strftime en Python formatea 1M fechas en 200-500ms. Intl. DateTimeFormat en JavaScript formatea 1M fechas en 100-300ms.
• URL encoding: encodeURIComponent en JavaScript encodea 1M strings en 50-200ms. urllib. parse. quote de Python encodea 1M strings en 100-400ms.
• Generacion de UUID: uuid. crypto. randomUUID() en Node.
• Truncacion de texto: slicear 1M strings a 100 chars toma 50-150ms en Python y 20-80ms en JavaScript.
• Formatting de phone numbers: la libreria phonenumbers en Python formatea 100K phone numbers en 500ms-2s.
• Generacion de QR codes: qrcode-terminal es mas rapido pero produce output de menor calidad.

Estrategia de Testing

• Test de manejo de timezones: verifica que el formatting de fechas produzca output correcto a traves de timezones (UTC, PST, JST, AEDT).
• Test con input invalido: verifica que phone numbers invalidos, URLs malformadas y fechas out-of-range sean rechazadas con errores claros.
• Test de formatting locale-specific: 56 vs 1.
• Test de edge cases Unicode: verifica que la truncacion no rompa caracteres multi-byte (emoji, CJK).
• Test de unicidad de UUID: UUIDv4 tiene 50% de probabilidad de colision despues de 2.
• Test de edge cases de argumentos CLI: testea con argumentos requeridos faltantes, flags duplicados, numeros negativos como valores y separador —.

Estimacion de Costos

• Tamaño de bundle de libreria de fechas: moment. js es 67KB minificado. date-fns con tree-shaking es 5-15KB. luxon es 25KB. Intl. DateTimeFormat nativo es 0KB (built into the runtime).
• Validacion de phone numbers: libphonenumber-js es 45KB minificado. La validacion server-side con la libreria de Google es gratis pero requiere una dependencia C++.
• Costo de generacion de QR codes: 50-2. 00 en compute.
• Infraestructura de generacion de UUID: UUIDv4 no requiere coordinacion pero causa patrones de I/O random en bases de datos. UUIDv7 o Snowflake IDs mejoran el throughput de escritura 2-5x clusterizando inserts.
• Distribucion de CLI tools: empaquetar un CLI tool con pip o pm es gratis. Distribuir como binario standalone (PyInstaller, pkg) agrega 10-50MB pero elimina la dependencia de runtime. Elije basado en la audiencia de usuarios

Monitoring y Observabilidad

• Tasa de errores de formatting: trackea el porcentaje de operaciones de formatting que fallan.
• Latencia de formatting: monitorea el tiempo gastado en formatting de fechas/phone/URL.
• Drift de configuracion de timezone: loguea el timezone del server al startup. Alerta si cambia de UTC.
• Rate de generacion de UUID: monitorea el rate de generacion de UUID.
• Patrones de uso de CLI: loguea que flags de CLI se usan mas frecuentemente.

Deployment Checklist

• Setear el timezone del server a UTC: variable de entorno TZ=UTC. Nunca confies en el timezone default del sistema en codigo de produccion
• Configurar defaults de locale: setea variables de entorno LANG y LC_ALL. Usa Intl.DateTimeFormat con locale explicito en JavaScript
• Setear longitud maxima de input: rechaza strings mas largos que el maximo configurado antes de formatear. Previene agotamiento de memoria por inputs oversized
• Configurar nivel de correccion de errores de QR code: usa nivel M (15% recovery) para uso general, nivel H (30% recovery) para entornos industriales. Niveles mas altos producen codes mas densos
• Setear limites de argumentos CLI: limita el numero de argumentos y su tamaño total. getopt y rgparse tienen limites built-in, pero parsers custom necesitan limites explicitos
• Pinear versiones de librerias: las librerias de fechas y phone cambian frecuentemente. Pinea versiones para evitar breaking changes de updates de timezone database o cambios de formato de locale

Consideraciones de Seguridad

• Bypass de control de acceso basado en timezone: si los checks de control de acceso usan hora local, un cambio de timezone del server puede bypassar restricciones basadas en tiempo.
• Bypass de URL encoding: double-encoding o mixed encoding puede bypassar filtros de seguridad basados en URL.
• Spoofing de phone numbers: el caller ID spoofing significa que la validacion de phone number no verifica identidad.
• Phishing via QR codes: los QR codes pueden encodear URLs maliciosas.
• Predictibilidad de UUID: UUIDv1 contiene la MAC address y timestamp, lo que leakea info de hardware y permite prediccion.
• Inyeccion via parsing de fechas: algunos parsers de fechas ejecutan codigo arbitrario via format strings (ej. strftime con format controlado por el usuario).
• Bypass de XSS via truncacion: truncar HTML a un numero fijo de caracteres puede partir tags y crear HTML invalido que bypassa filtros XSS.
• Inyeccion de argumentos CLI: si los argumentos CLI se pasan a subprocess sin escaping apropiado, un atacante puede inyectar shell commands.
• Perdida de precision en formatting de dinero: convertir entre currencies usando floating-point puede perder precision.
• Leak de metadata de phone numbers: libphonenumber puede revelar el carrier y region de un phone number.
• Inyeccion de contenido en QR codes: si los QR codes se renderizan desde URLs suministradas por el usuario sin validacion, un atacante puede encodear URIs javascript: o data:.
• DoS via format strings de fecha: algunas librerias de formatting de fechas soportan format strings complejas que pueden causar uso excesivo de CPU.

Variantes y Alternativas

• Intl nativo vs librerias: Intl. DateTimeFormat, Intl. NumberFormat e Intl. ListFormat estan built-in en runtimes JS modernos. Son 0KB y 2-5x mas rapidos que moment. js o date-fns.
• UUIDv4 vs UUIDv7 vs ULID vs Snowflake: UUIDv4 es random (bueno para seguridad, malo para indices DB). UUIDv7 es time-ordered (bueno para localidad DB). ULID es lexicograficamente sortable.
• Decimal vs centavos enteros vs floating-point: Decimal es exacto pero lento. Centavos enteros (guardar 199 en lugar de 1. 99) es exacto y rapido pero requiere conversion en boundaries.
• Template literals vs concatenacion de strings: template literals (Hola ) son mas legibles y ligeramente mas rapidos en V8. Concatenacion (“Hola ” + name) es compatible con runtimes antiguos.
• API URL nativa vs parsing con regex: ew URL(string) parsea URLs correctamente incluyendo edge cases (IPv6, userinfo, caracteres encodeados). Parsing basado en regex pierde edge cases. Siempre usa la API URL nativa para manipulacion de URLs
• Comparacion de frameworks CLI: rgparse (Python, stdlib, verbose), click (Python, decorators, clean), yper (Python, type hints, modern), commander (Node. js, widely used), yargs (Node. js, feature-rich).

Pitfalls Comunes en Produccion

• Offset de timezone vs nombre de timezone: +02:00 es un offset que cambia con DST.
• Confusion de codigos de locale: en-US vs en_US vs en — diferentes librerias esperan diferentes formatos.
• Modos de redondeo de currency: ROUND_HALF_UP (banker’s rounding) difiere de ROUND_HALF_EVEN (default Python). Sistemas financieros requieren modos de redondeo especificos.
• Colision de UUID en la practica: la probabilidad de colision de UUIDv4 es despreciable (1 en 2. 7x10^36 para 50% de probabilidad). Pero la colision de UUIDv1 puede ocurrir si la MAC address se reusa o el reloj se setea hacia atras.
• URL encoding de caracteres especiales: , ’, (, ) son tecnicamente seguros en URLs pero algunos servidores los rechazan. encodeURIComponent los encodea; encodeURI no.
• Truncacion con HTML: truncar HTML por conteo de caracteres puede romper tags.

Patrones de Integracion

• Pipeline de internacionalizacion (i18n): extrae strings user-facing -> formatea con funciones locale-specific -> renderiza en UI.
• Pipeline de fecha/tiempo: Nunca almacenes strings de fecha localizados en bases de datos.
• Pipeline de dinero: parsea monto (string a Decimal) -> valida codigo de currency (ISO 4217) -> convierte currency si es necesario (usando exchange rates diarios) -> formatea para display usando locale.
• Pipeline de building de URL: valida URL base -> appendea path segments (URL-encoded) -> appendea query parameters (URL-encoded) -> appendea fragment.
• Pipeline de generacion de UUID: genera UUID -> valida formato -> almacena como string (no tipo UUID para portabilidad) -> usa como primary key.
• Integracion de CLI con archivos de config: flags de CLI overriden valores de config file, que overriden variables de entorno, que overriden defaults. Esta jerarquia es estandar en apps 12-factor.

Manejo de Errores y Recuperacion

• Fallback graceful de locale: si una traduccion falta para r-CA, falla a r, luego en. Loguea traducciones faltantes para agregarlas despues.
• Cadena de fallback de parsing de fechas: prueba ISO 8601 primero, luego formatos locale-specific, luego formatos comunes (MM/DD/YYYY, DD/MM/YYYY). Si todos fallan, retorna null y deja que el caller decida.
• Manejo de errores de conversion de currency: Loguea un warning. Si no hay rate cacheado, rechaza la conversion con un error claro.
• Errores de normalizacion de URL: si el parsing de URL falla, loguea la URL original y el error. No intentes fixear la URL automaticamente — URLs malformadas pueden ser intencionales (ej. para testing).
• Manejo de colisiones de UUID: si ocurre una colision de UUID (extremadamente raro con v4/v7), regenera con un nuevo componente random. Loguea la colision para investigacion.
• Recuperacion de errores de argumentos CLI: si un argumento requerido falta, imprime el texto de ayuda y sale con codigo 2. Si un argumento tiene un valor invalido, imprime el error, el formato esperado, y sale con codigo 2.

Tooling y Ecosistema

• date-fns: libreria modular de fechas para JavaScript. Tree-shakeable (importa solo lo que necesitas). 50M+ downloads/mes. v3 soporta TypeScript nativamente.
• Luxon: libreria moderna de fechas JavaScript por el autor de moment. js. Construida sobre la API Intl. Timezone-aware. 15M+ downloads/mes. Mejor API que moment.
• libphonenumber: libreria de phone numbers de Google. Porteada a 10+ lenguajes.
• decimal.js: aritmetica decimal de precision arbitraria para JavaScript. 8M+ downloads/mes.
• ulid: Universally Unique Lexicographically Sortable Identifier. String de 26 caracteres. Sortable por timestamp. Sin coordinacion necesaria.
• commander.js: framework CLI para Node. js. 40M+ downloads/mes. Subcomandos, opciones, generacion de help text.

Resumen de Best Practices

• Almacena fechas en UTC. Convierte a locale del usuario solo en la capa de presentacion
• Usa Decimal o centavos enteros para dinero. Nunca uses floating-point para calculos financieros
• Normaliza URLs con la API URL nativa. Nunca parsees URLs con regex
• Usa UUIDv4 o UUIDv7 para IDs unicos. Evita UUIDv1 (leakea MAC address y timestamp)
• Pinea versiones de librerias de fechas y locale. Las bases de datos de timezone se actualizan frecuentemente
• Testea formatting con edge cases: strings vacios, Unicode, transiciones DST, leap seconds

Tips de Optimizacion de Performance

• Cachea strings de fecha formateados. strftime es caro cuando se llama millones de veces. Usa unctools.lru_cache para formatos repetidos
• Para URL encoding, urllib.parse.quote(safe=”) es mas rapido que encodeURIComponent en Python. Pre-encodea componentes staticos de URL
• Para generacion de UUID, uuid.uuid4() usa os.urandom() que es 10x mas lento que andom.random(). Usa uuid.uuid4() para seguridad, andom para IDs no-security
• Para formatting de phone numbers, cachea el objeto PhoneNumber parseado. Parsing es 5-10x mas lento que formatting
• Para truncacion de texto, ext[:n] (string slice) es O(1) para ASCII. Para Unicode, usa ext.encode(‘utf-8’)[:n].decode(‘utf-8’, errors=‘ignore’) para evitar romper caracteres multi-byte
• Para formatting de dinero, pre-computa el simbolo de currency y separador decimal para cada locale. locale.currency() es 10x mas lento que formatting manual
• Para generacion de QR codes, usa qrcode.make() para casos simples. Para generacion batch, reusaea el objeto QRCode y llama dd_data() + make() para cada code
• Para parsing de argumentos CLI, sys.argv es 100x mas rapido que rgparse para casos simples. Usa rgparse solo cuando necesitas help text y validacion
• Para aritmetica de fechas, datetime.timestamp() es mas rapido que datetime.strftime() para calculos de epoch. Usa enteros para math de fechas
• Para parsing de URL, urllib.parse.urlparse() cachea resultados parseados. Reusaea el objeto ParseResult en lugar de re-parsing

Lectura Adicional

• Documentación oficial: consulta la referencia actualizada del framework o herramienta utilizada.
• Guías relacionadas: explora las guías de data y parsing para profundizar.
• Patrones complementarios: revisa los patrones de diseño aplicables a tu stack tecnológico.
• Postmortems públicos: estudia incidentes reales de equipos que enfrentaron problemas similares en producción.

Notas de Producción

• Despliega gradualmente usando canary o blue-green para detectar regresiones temprano.
• Configura alertas para errores, latencia p99 y tasa de fallos antes de habilitar en producción.
• Documenta el rollback en el runbook; prueba el procedimiento en staging al menos una vez por trimestre.
• Revisa logs estructurados con correlation IDs para trazar requests end-to-end en incidentes.

Puntos Clave

• Aplica formateo de fechas cuando necesites una solución práctica para data.
• Monitorea el rendimiento después de implementar; mide latencia, errores y uso de recursos antes y después.
• Revisa la sección de Troubleshooting ante errores comunes; la mayoría tienen causa raíz documentada con solución.
• Mantén dependencias actualizadas y ejecuta tests en CI para prevenir regresiones en producción.

Errores Comunes en Producción

• Copiar el ejemplo sin adaptarlo a volúmenes y modos de fallo reales.
• Saltar tests de carga e inyección de errores antes del primer despliegue productivo.
• Codificar valores fijos que deberían ser configurables por entorno.
• Olvidar agregar logging y monitoreo en cada paso.
• Desplegar sin plan de rollback ni estrategia de backup probada.
• Asumir que el ejemplo mínimo escalará sin agregar caché o procesamiento por lotes.
• No documentar la versión y configuración usadas en producción.
• Dejar la receta sin cambios cuando evolucionan las dependencias o la escala.