# Construtor de Duração ISO 8601

Converte entre durações em linguagem natural e ISO 8601 (PnYnMnDTnHnMnS) em ambas as direções, validando casos limite

> Página canônica: https://elysiatools.com/pt/tools/iso-8601-duration-builder

- **Categoria:** Development

- **Palavras-chave:** iso 8601, duração, converter, intervalo

## Visão geral

Conversor bidirecional de durações ISO 8601 (formato de intervalo "PnYnMnDTnHnMnS"), complementando o conversor de pontos de data/hora ISO 8601.

Linguagem natural → ISO 8601: digite "3 years 2 months 14 days", "2.5 hours", "36 hours", "1 week 12 hours", "3天2小时" ou formas coladas como "2h30m" / "3days". Reconhece palavras em inglês, números por extenso ("two") e numerais/unidades em chinês, emitindo a string ISO 8601 canônica.

ISO 8601 → linguagem natural: cole P3Y2M14D, PT36H, P1W, P0.5D etc. e obtenha um detalhamento legível mais os valores por componente.

A validação cobre as regras difíceis do ISO 8601:
- "T" deve ser seguido de unidades de tempo (H/M/S), nunca de data.
- Semanas (W) não devem ser combinadas com anos, meses ou dias.
- Frações decimais apenas no menor componente.
- Pelo menos um componente é necessário (P sozinho é inválido).

Também oferece um total aproximado em segundos/minutos/horas/dias (1 ano ≈ 365,25 d, 1 mês ≈ 30,4375 d).

## Entradas

- **Entrada** (text): Natural: 3 years 2 months 14 days · 2h30m · 3天2小时 ISO 8601: P3Y2M14D · PT2H30M · P1WT12H
- **Direção** (select)

## Quando usar

- Ao configurar durações e intervalos de tempo em arquivos de configuração ou bancos de dados que exigem o padrão estrito ISO 8601.
- Ao traduzir expressões de tempo informais ou em linguagem natural para strings de duração estruturadas para APIs.
- Ao depurar e validar strings de duração ISO 8601 complexas recebidas de sistemas externos.

## Como funciona

- Insira a duração desejada no campo de entrada, seja em formato ISO 8601 (como PT2H30M) ou em linguagem natural (como '3 days 2 hours').
- Selecione a direção da conversão ou deixe em 'Auto' para que a ferramenta detecte o formato de entrada automaticamente.
- A ferramenta analisa a entrada, valida as regras do padrão ISO 8601 (como o uso correto do indicador T e frações decimais) e gera o resultado convertido com o detalhamento dos componentes e o total aproximado de segundos.

## Casos de uso

- Integração de APIs: Converter prazos de expiração de tokens descritos em linguagem natural para o formato ISO 8601 exigido por servidores de autenticação.
- Validação de dados: Verificar se strings de intervalo geradas por sistemas legados estão em conformidade com as regras estritas do padrão ISO 8601.
- Documentação técnica: Traduzir durações complexas em formato ISO 8601 para descrições legíveis por humanos em relatórios ou manuais.

## Perguntas frequentes

### O que significa a letra 'T' na duração ISO 8601?

O 'T' é o delimitador que separa os componentes de data (como anos, meses e dias) dos componentes de tempo (como horas, minutos e segundos).

### Posso combinar semanas (W) com outros componentes de data no ISO 8601?

Não, a especificação ISO 8601 não permite combinar semanas com anos, meses ou dias na mesma string de duração.

### Onde posso usar frações decimais em uma string de duração?

Frações decimais são permitidas apenas no menor componente de tempo presente na string de duração.

### Como a ferramenta calcula o total aproximado de segundos?

O cálculo utiliza aproximações padrão do calendário, considerando 1 ano como 365,25 dias e 1 mês como 30,4375 dias.

### A ferramenta aceita entradas em outros idiomas além do inglês?

Sim, a ferramenta reconhece expressões de tempo em inglês, português e chinês, além de abreviações comuns como '2h30m'.

## Ferramentas relacionadas

- [Explicador de Expressões Cron](https://elysiatools.com/pt/tools/cron-expression-explainer): Analisa uma expressão cron (5/6 campos ou Quartz) em uma descrição em linguagem natural, detalha os campos e lista as próximas N execuções em qualquer zona IANA, com explicação por IA
- [Conversor de cURL para Go (net/http)](https://elysiatools.com/pt/tools/curl-to-go): Converte um comando cURL em um snippet de código Go net/http com http.NewRequest, cabeçalhos e corpo
- [Conversor de cURL para JavaScript (axios)](https://elysiatools.com/pt/tools/curl-to-js-axios): Converte um comando cURL em um snippet de código JavaScript axios com objeto de configuração, cabeçalhos e dados
- [Conversor de cURL para JavaScript (fetch)](https://elysiatools.com/pt/tools/curl-to-js-fetch): Converte um comando cURL em um snippet de código JavaScript fetch() com cabeçalhos, corpo e método
- [Conversor de cURL para PHP (cURL)](https://elysiatools.com/pt/tools/curl-to-php): Converte um comando cURL em um snippet de código PHP cURL com curl_setopt, cabeçalhos e campos POST
- [Conversor de cURL para Python (requests)](https://elysiatools.com/pt/tools/curl-to-python): Converte um comando cURL em um snippet de código Python requests com cabeçalhos, dados e método
- [Testador de Requisições HTTP](https://elysiatools.com/pt/tools/http-request-tester): Cliente HTTP leve no navegador (mini Postman): envie requisições GET/POST/PUT/DELETE com cabeçalhos e corpo personalizados, inspecione status, cabeçalhos, tempo e resposta formatada — tudo no navegador
- [Visualizador de codificadores Gray, termômetro e one-hot](https://elysiatools.com/pt/tools/gray-code-and-thermometer-bcd-encoder-visualizer): Converte um valor de N bits em binário, Gray, one-hot e termômetro com tabela verdade de contagem, gráfico de distância Hamming e módulos Verilog/VHDL.

## Exemplos

- [Exemplos de Processamento de Imagem Web Python](https://elysiatools.com/pt/samples/web-image-processing-python): Exemplos de processamento de imagem Web Python usando PIL/Pillow incluindo leitura, salvamento, redimensionamento e conversão de formato
- [Exemplos de Processamento de Imagem Android Java](https://elysiatools.com/pt/samples/android-image-processing-java): Exemplos de processamento de imagem Android Java incluindo leitura/escrita, dimensionamento e conversão de formato
- [Exemplos de Processamento de Imagem Android Kotlin](https://elysiatools.com/pt/samples/android-image-processing-kotlin): Exemplos de processamento de imagem Android Kotlin incluindo leitura/escrita, dimensionamento e conversão de formato
- [Exemplos de Processamento de Imagem Web Rust](https://elysiatools.com/pt/samples/web-image-processing-rust): Exemplos de processamento de imagem Web Rust incluindo leitura/gravação, redimensionamento e conversão de formato
