ForHosting KIT · Datas e tempo

Conversor de semana ISO para data

Transforme um rótulo de semana ISO em um dia de verdade: a segunda da semana 1 de 2024 é 1º de janeiro de 2024, e a da semana 1 de 2015 volta para 29 de dezembro de 2014. Grátis no seu navegador.

Grátis
Funciona no seu navegador
Sem cadastro
Seus dados não saem do seu aparelho

Executar grátis Ver a API

Use pelo WebAPIE-mailTelegramApp em breve

Exemplo resolvido

Se você digitar

Ano: 2.024
Semana: 1
Dia da semana: 1

Você obtém

Nome do dia da semana: Monday
Data: 2024-01-01
Ano do calendário: 2.024
Mês: 1

Este conversor de semana ISO para data mapeia um ano de numeração de semana ISO-8601, um número de semana de um a cinquenta e dois ou cinquenta e três, e um dia da semana ISO de segunda-feira igual a um até domingo igual a sete, para o dia correspondente do calendário gregoriano no formato AAAA-MM-DD. A datação por semana ISO é o padrão usado em logística, calendários de folha de pagamento, cronogramas de fabricação e muitos sistemas empresariais europeus: a semana um sempre contém o dia 4 de janeiro, as semanas sempre começam na segunda-feira, e alguns anos têm uma quinquagésima terceira semana. Você talvez já saiba que a segunda-feira da semana um de 2024 é 2024-01-01, que a segunda-feira da semana um de 2015 cai de volta em dezembro de 2014, e que uma solicitação para a semana cinquenta e três de um ano de cinquenta e duas semanas deve falhar.

O que a conversão de semana ISO para data retorna e quando ela falha

A datação por semana ISO-8601 identifica um dia por três números: o ano de numeração de semana Y, o número de semana W de um até a última semana desse ano, e o dia da semana D, em que segunda-feira é um e domingo é sete.

A semana um do ano Y é definida como a semana que contém o dia 4 de janeiro de Y, que também é a semana que contém a primeira quinta-feira de Y; a partir desse ponto de referência, o mecanismo avança ou retrocede em semanas e dias da semana inteiros. Perto das fronteiras de ano, o ano gregoriano do resultado pode diferir do ano-semana ISO: por exemplo, a segunda-feira de 2015-W01 é 2014-12-29, e a sexta-feira de 2020-W53 é 2021-01-01.

Valores ausentes ou não inteiros de ano, semana ou dia da semana, dias da semana fora do intervalo de um a sete, e anos fora do intervalo suportado de um a nove mil novecentos e noventa e nove também são rejeitados.

Como os três números viram uma data

Strings inteiras e bigints seguros são aceitos quando interpretados como números inteiros dentro dos intervalos documentados; decimais, strings vazias e tokens não numéricos são rejeitados, para que uma célula com erro não vire um dia de envio errado. O cálculo começa a partir do dia 4 de janeiro do ano-semana, encontra seu dia da semana ISO com aritmética inteira pura ao estilo Sakamoto, retrocede até a segunda-feira da semana um, e então soma sete vezes semana menos um, mais dia da semana menos um, em dias.

Ordinais que caem antes de 1º de janeiro ou depois de 31 de dezembro são normalizados através das fronteiras do ano gregoriano com tratamento completo de anos bissextos, incluindo a regra dos quatrocentos anos.

Onde a conversão de semana para data se encaixa em planejamento, logística e software

Equipes de operações encontram rótulos de semana ISO em pedidos de compra, janelas de entrega e planos de produção que dizem semana quarenta e dois sem nomear um mês. Calendários de finanças e RH costumam fechar períodos por semana ISO, e as ferramentas de relatório precisam transformar esses rótulos em datas concretas de início e fim para filtros e exportações.

Desenvolvedores chamam o mesmo contrato a partir de scripts para gerar vetores de teste determinísticos para seletores de data, normalizar strings de semana inseridas por usuários antes do armazenamento, ou atender enunciados de desafios de programação que exigem um dia de calendário em vez de uma aproximação improvisada. Educadores a usam ao ensinar ISO-8601: os estudantes podem verificar que a semana um sempre cobre o dia 4 de janeiro e que apenas anos longos aceitam a semana cinquenta e três.

Ferramentas de produto e integração usam a conversão quando um formulário coleta ano, semana e dia da semana, e o backend precisa armazenar um único AAAA-MM-DD para ordenação e junções.

Casos de uso

Cronogramas de logística e produção

Transforme rótulos de semana ISO em pedidos e planos em datas concretas de envio e produção no formato AAAA-MM-DD.

Calendários de folha de pagamento e relatórios

Resolva períodos de semana ISO em dias gregorianos de início e fim para filtros, exportações e fechamentos de período.

Perguntas frequentes

Quando a semana 53 é rejeitada?

Quando o ano-semana ISO tem apenas 52 semanas.

O ano do calendário pode diferir do ano-semana ISO?

Sim. Dias perto das fronteiras de ano frequentemente caem no ano gregoriano anterior ou seguinte, ainda pertencendo ao ano-semana ISO solicitado.

Esta ferramenta converte uma data de calendário em uma semana ISO?

Não. Ela apenas mapeia ano-semana, semana e dia da semana para uma data. Use a calculadora de número de semana ISO para a direção inversa.

O que significam os três números que eu digito?

O primeiro é o ano-semana ISO, o segundo é o número da semana, de 1 a 52 ou 53, e o terceiro é o dia, de 1 para segunda a 7 para domingo. Assim, 2024, 1 e 1 dão 1º de janeiro de 2024.

Posso digitar um número decimal ou deixar um valor em branco?

Não. Os três valores precisam ser números inteiros; decimais, valores em branco e texto são recusados, para que uma célula errada da planilha não vire uma data de entrega errada.

Ferramentas relacionadas

Para desenvolvedores — acesso via API

Tudo nesta página está disponível via API. Esta seção é para equipes que querem integrar a ferramenta aos próprios sistemas; quem não precisa disso pode simplesmente usar a ferramenta acima.

Endpoint

POSThttps://api.kit.forhosting.com/date/iso-week-to-date

Autenticação por token Bearer. Um único POST coloca a tarefa na fila; o resultado chega por webhook ou link assinado.

Chame do seu código

curl -X POST https://api.kit.forhosting.com/date/iso-week-to-date \
  -H "Authorization: Bearer $KIT_KEY" \
  -H "Content-Type: application/json" \
  -d '{"year":2024,"week":1,"weekday":1}'

const res = await fetch("https://api.kit.forhosting.com/date/iso-week-to-date", {
  method: "POST",
  headers: {
    "Authorization": `Bearer ${process.env.KIT_KEY}`,
    "Content-Type": "application/json"
  },
  body: JSON.stringify({
    "year": 2024,
    "week": 1,
    "weekday": 1
  })
});
const { task_id } = await res.json();

import os, requests

res = requests.post(
    "https://api.kit.forhosting.com/date/iso-week-to-date",
    headers={"Authorization": f"Bearer {os.environ['KIT_KEY']}"},
    json={
    "year": 2024,
    "week": 1,
    "weekday": 1
},
)
task_id = res.json()["task_id"]

<?php
$res = file_get_contents("https://api.kit.forhosting.com/date/iso-week-to-date", false, stream_context_create([
  "http" => [
    "method"  => "POST",
    "header"  => "Authorization: Bearer " . getenv("KIT_KEY") . "\r\nContent-Type: application/json",
    "content" => '{"year":2024,"week":1,"weekday":1}',
  ],
]));
$task = json_decode($res, true);

body := bytes.NewBufferString(`{"year":2024,"week":1,"weekday":1}`)
req, _ := http.NewRequest("POST", "https://api.kit.forhosting.com/date/iso-week-to-date", body)
req.Header.Set("Authorization", "Bearer "+os.Getenv("KIT_KEY"))
req.Header.Set("Content-Type", "application/json")
res, _ := http.DefaultClient.Do(req)

Exemplo de requisição

{
  "year": 2024,
  "week": 1,
  "weekday": 1
}

Exemplo de resposta

{
  "task_id": "tsk_a1b2c3d4e5f6a1b2c3d4e5f6",
  "type": "date.iso_week_to_date",
  "status": "queued",
  "_links": {
    "result": "/tasks/tsk_…/result"
  }
}

A API é assíncrona: cada chamada devolve um task_id na hora. Se preferir polling, consulte o status a até 1 requisição por segundo.

Preço

por chamadaUS$ 0,002

Preço publicado, sem tokens nem créditos escondidos. Tarefa que falha não é cobrada.

Limites

`year_min`	1
`year_max`	9999

Erros

HTTP	Código	O que significa
`401`	`unauthorized`	Token ausente ou inválido. Confira o header Authorization.
`402`	`insufficient_balance`	Saldo insuficiente para esta tarefa. Faça uma recarga e tente de novo.
`404`	`unknown_type`	Esse tipo de tarefa não existe. Confira o campo type no catálogo.
`429`	`rate_limited`	Muitas requisições em pouco tempo. Espere um instante e tente de novo.

Notas técnicas

O que a conversão de semana ISO para data retorna e quando ela falha

Este conversor resolve essa tripla em uma única string de data no formato estendido AAAA-MM-DD, além de campos estruturados de ano, mês e dia do calendário, o nome legível do dia da semana, a iso_week_string canônica como 2024-W01, e a contagem weeks_in_iso_year usada na validação. A solicitação é rejeitada com invalid_input quando o número de semana excede a contagem de semanas do ano — a maioria dos anos tem cinquenta e duas semanas, e apenas anos cujo primeiro ou último dia é uma quinta-feira têm cinquenta e três — então a semana cinquenta e três de 2024 falha porque 2024 tem apenas cinquenta e duas semanas. Não há deslocamento de fuso horário, nenhum primeiro dia de semana dependente de localidade, e nenhuma dependência do relógio de parede: o caminho ou constrói uma data determinística ou falha com uma mensagem clara, adequada para formulários, testes unitários e clientes de API.

Como year, week e weekday são interpretados e como a data permanece reproduzível

Os campos preferidos são year para o ano de numeração de semana ISO, week para o número de semana, e weekday para o dia da semana ISO, com os aliases iso_week_year, week_year e y para year; iso_week, week_number e w para week; e iso_weekday, day e dow para weekday, para que planilhas, strings de consulta e formulários tipados possam reutilizar o mesmo contrato. Combine a execução gratuita no navegador desta página com a API paga quando precisar do mesmo resultado matemático dentro de um pipeline automatizado, conector de ERP ou gerador de calendário de folha de pagamento, sem distribuir uma segunda biblioteca de calendário.

Onde a conversão de semana para data se encaixa em planejamento, logística e software

Nesta página o trabalho roda inteiramente no seu navegador; pela API, cada consulta bem-sucedida custa US$ 0,002, a validação com falha não é cobrada, e nada é armazenado depois que a resposta é devolvida. Essa divisão — exploração interativa gratuita e uma API paga e idêntica — segue o padrão do resto do catálogo tier A do KIT e permite passar de uma demonstração de planejamento para um pipeline automatizado sem mudar o resultado matemático. Combine-a com a calculadora de número de semana ISO quando precisar do mapeamento inverso, de uma data de calendário para semana e ano-semana, e com outros endpoints de data ao montar um pequeno laboratório de auxiliares de calendário gratuitos e determinísticos.

Casos de integração

Fixtures determinísticas para testes

Gere datas de calendário reproduzíveis a partir de triplas ano/semana/dia-da-semana para testes unitários e asserções de CI.

Perguntas técnicas

Quanto custa o conversor de semana ISO para data?

É gratuito no navegador, nesta página. Pela API, uma solicitação bem-sucedida custa US$ 0,002; entradas inválidas não são cobradas.

Como year, week e weekday são definidos?

Year é o ano de numeração de semana ISO, week é 1 a 52 ou 53, e weekday é segunda-feira=1 até domingo=7, conforme a ISO-8601.

Ver a documentação completa do KIT →

Executar grátis

Exemplo resolvido

O que a conversão de semana ISO para data retorna e quando ela falha

Como os três números viram uma data

Onde a conversão de semana para data se encaixa em planejamento, logística e software

Casos de uso

Cronogramas de logística e produção

Calendários de folha de pagamento e relatórios

Perguntas frequentes

Ferramentas relacionadas

Para desenvolvedores — acesso via API

Endpoint

Chame do seu código

Exemplo de requisição

Exemplo de resposta

Preço

Limites

Erros

Notas técnicas

O que a conversão de semana ISO para data retorna e quando ela falha

Como year, week e weekday são interpretados e como a data permanece reproduzível

Onde a conversão de semana para data se encaixa em planejamento, logística e software

Casos de integração

Fixtures determinísticas para testes

Perguntas técnicas

obrigado