Tiempo/Números
Analizador de duración ISO 8601
Analiza una cadena como "P3Y6M4DT12H30M5S" en un formato legible, o construye una cadena así a partir de años/meses/días/horas/minutos/segundos.
Un campo vacío = 0; los campos en cero no se incluyen en la cadena. El componente de semanas (P4W) solo se admite al analizar — para construir, usa días.
An ISO 8601 duration (e.g. P3Y6M4DT12H30M5S) is a compact, unambiguous way to write a time span, used by many APIs and data formats, but hard to read without parsing it. This tool translates such a string into plain language and lets you build one from separate fields.
How to use it
- Parse: paste an ISO duration string to get years, months, days, hours, minutes, and seconds broken out separately, in a readable form.
- Build: enter the duration components you need and the tool assembles a valid ISO 8601 string.
- The letter T before the time part (hours/minutes/seconds) is required and gets added automatically when needed.
Common uses
- Reading a duration field from an API response (a subscription, a rental period, a timeout) given in this format.
- Building a correctly formatted ISO 8601 string for a request that expects a duration in exactly this format.
- Debugging why a third-party API's parser rejects a hand-built duration — checking it against the standard's exact syntax.
Things to keep in mind
The leading P stands for "period" and is required, just like the T that separates days from hours in the time part.
The base standard doesn't define a sign for durations — negative durations (to mean "ago") are only supported by specific implementations as an unofficial extension.
Artículo sobre esta herramienta: ISO 8601 Duration: cómo escribir una duración en formato estándar
Preguntas frecuentes
¿Qué significa una cadena como P3Y6M4DT12H30M5S?
Este es el formato estándar de duración ISO 8601: P significa "period" (periodo), seguido de años/meses/días hasta la letra T, tras la cual vienen horas/minutos/segundos. En este ejemplo, son 3 años, 6 meses, 4 días, 12 horas, 30 minutos y 5 segundos.
¿En qué se diferencia una duración ISO de una duración simple en horas?
A diferencia de las unidades fijas (como en la calculadora de duración), los componentes "años" y "meses" aquí son de calendario y no tienen un número fijo de segundos — su duración exacta depende de las fechas concretas a las que se apliquen.
¿Se admite el formato semanal P4W?
Sí, pero solo al analizar una cadena existente. Al construir tu propia cadena, las semanas deben expresarse en días, ya que ISO 8601 no permite combinar semanas con otros componentes en una sola cadena.
¿Puedo indicar segundos o minutos decimales?
Sí, el estándar permite una parte decimal solo en el último componente de la cadena — por ejemplo, PT1.5S (1,5 segundos) o PT1H30.5M (1 hora 30,5 minutos) son válidos, pero una parte decimal en cualquier otro componente no lo es.
¿Existen duraciones ISO negativas?
El estándar ISO 8601 básico no define un signo para las duraciones, pero algunas implementaciones (incluida esta herramienta) admiten un signo menos inicial para indicar "hace" o una duración invertida — una extensión común, aunque no oficial.