Calculadora do dia do ano a partir de uma data
O dia 31 de dezembro de 2024 é o dia 366 do ano, porque 2024 é bissexto. Digite uma data no formato ano-mês-dia e veja a posição dela no ano, contando 1º de janeiro como dia 1; datas impossíveis são recusadas. Grátis no seu navegador.
- Grátis
- Funciona no seu navegador
- Sem cadastro
- Seus dados não saem do seu aparelho
Executar grátis
Exemplo resolvido
- Data
- 2024-12-31
- Dia do ano
- 366
Esta calculadora converte uma data do calendário em sua posição ordinal no ano. Informe uma data no formato YYYY-MM-DD para receber um inteiro de 1 a 365, ou até 366 em um ano bissexto. O cálculo aplica as regras gregorianas, valida a quantidade real de dias de cada mês e rejeita datas impossíveis em vez de ajustá-las silenciosamente. É útil sempre que uma data legível precisa virar um índice anual compacto.
Transforme uma data em número ordinal
O dia do ano responde quantos dias corridos decorreram desde 1 de janeiro até a data informada, contando o próprio 1 de janeiro como dia 1. Digite quatro algarismos para o ano, dois para o mês e dois para o dia, separados por hífens. Uma data no começo de janeiro gera um número pequeno; outra no fim de dezembro fica próxima de 365 ou 366.
O formato é propositalmente rigoroso: anos abreviados, componentes invertidos, timestamps e formatos regionais são recusados por poderem variar entre sistemas. A calculadora usa o calendário gregoriano e aceita os anos 0001 a 9999. Ela não depende do relógio do servidor, do fuso horário, do horário de verão nem da data atual, portanto a mesma entrada sempre produz a mesma saída.
Como anos bissextos e meses são tratados
O ordinal é calculado somando a duração completa dos meses anteriores ao mês solicitado e depois o dia informado. Fevereiro é o único mês variável. Pelas regras gregorianas, um ano divisível por quatro normalmente é bissexto, mas um ano secular só é bissexto quando também é divisível por quatrocentos.
Assim, 2024 e 2000 têm 29 de fevereiro, enquanto 1900 e 2100 não têm. Isso afeta todas as datas posteriores: 1 de março é o dia 61 em um ano bissexto e o dia 60 em um ano comum. A validação aplica essas regras antes da soma.
Datas como 31 de abril, 30 de fevereiro, dia zero, mês treze ou 29 de fevereiro em ano comum geram erro. A calculadora nunca transfere uma data inválida para o mês seguinte, evitando que um ordinal plausível esconda uma origem malformada.
Use o resultado com segurança em dados e agendas
Dias ordinais ajudam quando a posição no ano importa, mas as divisões entre meses não. Observações ambientais podem ser agrupadas por estação, registros industriais podem identificar um dia de produção e relatórios podem formar sequências anuais consistentes para gráficos. O valor também facilita comparar datas do mesmo ano, mas não deve substituir a data original em registros de anos diferentes: o dia 32 existe em todos os anos.
Mantenha o ano ao lado do ordinal quando a identificação ou a ordem cronológica atravessar a virada do ano. Em eventos recorrentes, lembre-se de que anos bissextos deslocam os ordinais após 28 de fevereiro; um aniversário fixo pode assumir números diferentes. Da mesma forma, um ordinal fixo pode corresponder a outra data perto de fevereiro.
Casos de uso
Indexar observações anuais
Converta medições meteorológicas, agrícolas ou laboratoriais datadas em uma posição anual consistente para análise sazonal.
Validar rótulos de produção
Compare o ordinal usado em fabricação, logística ou lotes com a data original do calendário.
Preparar datas para relatórios
Inclua o dia do ano em conjuntos de dados e gráficos sem depender da localidade ou do fuso horário da planilha.
Perguntas frequentes
Qual é o intervalo possível do resultado?
O resultado vai de 1 a 365 em um ano comum e de 1 a 366 em um ano bissexto.
Qual formato de data é aceito?
Use exatamente YYYY-MM-DD, incluindo zeros à esquerda em meses e dias de um algarismo.
Como os anos bissextos são definidos?
Anos divisíveis por quatro são bissextos, mas anos seculares também precisam ser divisíveis por quatrocentos.
O que acontece se a data for inválida?
A solicitação retorna um erro de entrada inválida para formatos incorretos e datas impossíveis.
O cálculo depende de fuso horário?
Não. Ele faz aritmética de calendário diretamente e não transforma a data em timestamp.
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
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/astro/day-of-year \
-H "Authorization: Bearer $KIT_KEY" \
-H "Content-Type: application/json" \
-d '{"date":"2024-12-31"}'const res = await fetch("https://api.kit.forhosting.com/astro/day-of-year", {
method: "POST",
headers: {
"Authorization": `Bearer ${process.env.KIT_KEY}`,
"Content-Type": "application/json"
},
body: JSON.stringify({
"date": "2024-12-31"
})
});
const { task_id } = await res.json();import os, requests
res = requests.post(
"https://api.kit.forhosting.com/astro/day-of-year",
headers={"Authorization": f"Bearer {os.environ['KIT_KEY']}"},
json={
"date": "2024-12-31"
},
)
task_id = res.json()["task_id"]<?php
$res = file_get_contents("https://api.kit.forhosting.com/astro/day-of-year", false, stream_context_create([
"http" => [
"method" => "POST",
"header" => "Authorization: Bearer " . getenv("KIT_KEY") . "\r\nContent-Type: application/json",
"content" => '{"date":"2024-12-31"}',
],
]));
$task = json_decode($res, true);body := bytes.NewBufferString(`{"date":"2024-12-31"}`)
req, _ := http.NewRequest("POST", "https://api.kit.forhosting.com/astro/day-of-year", 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
{
"date": "2024-12-31"
}Exemplo de resposta
{
"task_id": "tsk_a1b2c3d4e5f6a1b2c3d4e5f6",
"type": "astro.day_of_year",
"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
Preço publicado, sem tokens nem créditos escondidos. Tarefa que falha não é cobrada.
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
Transforme uma data em número ordinal
O resultado contém um único inteiro day_of_year, fácil de armazenar, comparar ou reutilizar.
Use o resultado com segurança em dados e agendas
A API custa US$ 0,002 por solicitação, enquanto o navegador executa localmente o mesmo cálculo determinístico, sem rede, localização ou configuração de fuso horário.
Perguntas técnicas
Quanto custa uma solicitação à API?
Cada solicitação à API custa US$ 0,002. O mesmo cálculo também pode ser executado localmente no navegador.