Sem upload, 100% local, sem conta

Conversor de duração ISO 8601

Insira uma duração ISO 8601 para decompô-la e convertê-la em segundos.

Como o Conversor de duração ISO 8601 funciona

Conversor de Duração ISO 8601 analisa e converte durações escritas no formato ISO 8601 (por exemplo P1Y2M10DT4H30M) em um detalhamento legível por humanos de anos, meses, dias, horas, minutos e segundos, e também calcula o total em segundos para os componentes de tempo. A conversão roda inteiramente no seu navegador; nada do que você digita é transmitido a nenhum servidor, e a ferramenta funciona offline após o carregamento da página.

As strings de duração ISO 8601 começam com 'P' (de Period), seguido de componentes de data (Y para anos, M para meses, W para semanas, D para dias) e opcionalmente um separador 'T' seguido de componentes de tempo (H para horas, M para minutos, S para segundos). Semanas (W) são um caso especial: quando presentes, nenhum outro componente de data pode aparecer. A saída de total de segundos cobre apenas a parte de tempo determinística (horas, minutos, segundos), pois meses e anos têm comprimentos variáveis em dias e não podem ser convertidos em segundos sem uma data de referência.

Escrito por Bastien Sulyan

Como usar o Conversor de duração ISO 8601, passo a passo

  1. Digite ou cole uma string de duração ISO 8601 no campo de entrada (por exemplo P3Y6M4DT12H30M5S).
  2. Leia o detalhamento por componente: anos, meses, semanas, dias, horas, minutos, segundos.
  3. Verifique o valor de total de segundos para a parte de tempo (apenas componentes H/M/S).
  4. Alternativamente, preencha os campos de componentes individuais e a string ISO será gerada para você.

Casos de uso comuns

  • Um desenvolvedor depurando uma resposta de API que retorna durações no formato ISO 8601 precisa verificar os valores analisados.
  • Um escritor técnico documentando um sistema que aceita strings de duração ISO quer mostrar o que cada componente significa.
  • Um analista de dados precisa converter um conjunto de valores de duração ISO de uma exportação de banco de dados em total de segundos para análise estatística.
  • Um desenvolvedor gerando dados de calendário ou agendamento precisa construir uma string de duração ISO 8601 válida a partir de valores individuais de componentes de tempo.

Perguntas frequentes

O que cada letra em uma string de duração ISO 8601 significa?

P marca o início do período. Y = anos, M antes do separador T = meses, W = semanas, D = dias. Após o separador T: H = horas, M = minutos, S = segundos. A string P1Y2M10DT4H30M significa 1 ano, 2 meses, 10 dias, 4 horas e 30 minutos.

Por que a ferramenta pode apenas converter horas, minutos e segundos em total de segundos, e não meses e anos?

Os meses variam de 28 a 31 dias e os anos variam entre 365 e 366 dias. Sem uma data de início de referência, não há um número correto único de segundos para 'um mês'. Horas, minutos e segundos têm comprimentos fixos e se convertem deterministicamente. Para obter o total de segundos para uma duração que inclua meses ou anos, use a ferramenta de adição de datas com uma data de início específica e calcule a diferença de dias.

Qual é a diferença entre PT1H30M e P0Y0M0DT1H30M?

Elas são semanticamente idênticas. Ambas representam uma duração de 1 hora e 30 minutos. O ISO 8601 permite omitir componentes com valor zero, portanto PT1H30M é a forma compacta e P0Y0M0DT1H30M é a forma explícita. Ambas são válidas.

Uma string de duração pode incluir semanas junto com dias?

Não. Quando o designador W (semanas) é usado em uma duração ISO 8601, o padrão proíbe outros designadores de data (Y, M, D) na mesma string. Uma duração somente de semanas tem a forma P3W, significando exatamente 3 semanas.

A string de duração ISO que digito é armazenada ou enviada para algum lugar?

Não. A análise é puramente manipulação de string local sem dependências externas. A string de duração que você insere permanece dentro da aba do navegador e não é registrada, transmitida ou armazenada em cache além da sessão.

Durações negativas são válidas no ISO 8601?

O núcleo do padrão ISO 8601 não define durações negativas. Algumas implementações estendidas permitem um sinal de menos inicial (por exemplo -P1D para significar 'menos um dia'). Esta ferramenta analisa durações padrão não negativas; se seu caso de uso requer durações negativas, verifique a API ou sistema específico com que está trabalhando para confirmar sua convenção.

Ferramentas relacionadas

Mantenha tudo local, explore ferramentas complementares.

Todas as ferramentas de datas e horas