ForHosting KIT · Ferramentas para dev

Calculadora do dia do ano a partir de uma data

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.

● BetaGrátis · no seu navegador

Executar grátis Ver a API

Use pelo WebAPIE-mailTelegramApp em breve

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 resultado contém um único inteiro day_of_year, fácil de armazenar, comparar ou reutilizar. 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. 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.

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.

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.

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/astro/day-of-year

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

por chamadaUS$ 0,002

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.

Ver a documentação completa do KIT →