Qué es Generador Intl.DurationFormat?
Intl.DurationFormat es una API integrada del navegador que formatea duraciones de tiempo según las convenciones de la locale. Dado un objeto de duración con campos como hours, minutes y seconds, produce cadenas legibles como '1 hour, 30 minutes' (inglés largo), '1 Std 30 Min.' (alemán corto) o '1:30:00' (digital). Soporta cuatro estilos: long, short, narrow y digital. Disponible en Chrome 104+ y parte de Baseline 2025.
Respuesta rápida
Genere código usando Intl.DurationFormat para mostrar duraciones de tiempo en un formato adaptado a la locale. Elija entre los estilos long, short, narrow y digital. Soporta inglés, alemán, francés, español, japonés y neerlandés. Elimine moment-duration-format y use la API nativa.
Last updated: 2026-06-02
Limitaciones
- Intl.DurationFormat no está disponible en Safari a mediados de 2026. Use un polyfill o biblioteca de respaldo para usuarios de Safari, o implemente un formateador manual simple para casos básicos.
- La API no agrega unidades automáticamente: { hours: 1, minutes: 90 } se formatea como '1 hour, 90 minutes', no '2 hours, 30 minutes'. Normalice su duración antes de formatear si desea conversión automática de unidades.
- Cada locale determina sus propias reglas de formateo y elecciones de palabras. El estilo digital produce una salida numérica consistente, pero los estilos long/short/narrow pueden variar de maneras que afecten el ancho del layout. Pruebe en todas sus locales objetivo para evitar desbordamiento de texto.
Sources:MDN Web Docs · W3C Specifications · jquery.app on GitHub
Cómo usar esta herramienta
- Cree un objeto de duración con los componentes de tiempo que desea formatear: { hours: 1, minutes: 30, seconds: 0 }.
- Construya una nueva instancia de Intl.DurationFormat con su locale elegida y configuración de estilo opcional.
- Llame a format(duracion) en la instancia para obtener la cadena localizada, o llame a formatToParts(duracion) para un array de componentes formateados.
- Experimente con diferentes locales y estilos en la herramienta para ver cómo cambian las cadenas de duración entre idiomas.
Para qué puedes usarla
- Mostrar duración de video o duración de podcast en una interfaz de reproductor multimedia localizada.
- Visualizar tiempo estimado de lectura o tiempo de procesamiento en el formato de idioma preferido del usuario.
- Formatear duraciones del lado del servidor (tiempos de respuesta API, tiempos de ejecución de trabajos) para paneles de administración internacionalizados.