Calculadora do dia do ano
1º de março de 2024 é o dia 61 do ano; em um ano comum seria o dia 60, porque 2024 é bissexto. Digite uma data e veja a posição dela no ano, a duração do ano e os dias que faltam até 31 de dezembro. 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-03-01
- Ano
- 2.024
- Mês
- 3
- Dia
- 1
- Dia do ano
- 61
O dia do ano, às vezes chamado de data ordinal ou dia juliano do ano, é a posição de um dia de calendário dentro do seu ano contando a partir de um no primeiro de janeiro até trezentos e sessenta e cinco ou trezentos e sessenta e seis no trinta e um de dezembro. Engenheiros, analistas e estudantes precisam desse ordinal ao rotular arquivos de log, agendar trabalho sazonal, comparar barras de progresso de metas anuais ou converter entre datas civis e esquemas de numeração de dias usados em ciência e aviação. Esta calculadora aceita uma única data de calendário ISO na forma estrita ano-mês-dia com quatro dígitos, dois dígitos e dois dígitos, verifica se o dia realmente existe no calendário gregoriano incluindo fevereiros bissextos, e devolve o inteiro do dia do ano junto com um indicador de bissexto, o comprimento do ano e quantos dias restam até trinta e um de dezembro. Datas impossíveis como vinte e nove de fevereiro em um ano comum ou trinta e um de abril falham com um erro de validação claro em vez de um ajuste silencioso.
Como o dia do ano é calculado a partir de uma data ISO
Comece com uma data de calendário escrita como ano, mês e dia na forma ISO internacional com hífens e larguras fixas para que todo cliente concorde nos mesmos três inteiros. Confirme primeiro que o ano está em um intervalo gregoriano prático e que o mês está entre um e doze. Em seguida aplique a regra de ano bissexto usada pelos calendários civis em todo o mundo: um ano é bissexto quando é divisível por quatro, exceto que anos de século só são bissextos quando também são divisíveis por quatrocentos.
Essa regra torna legal o vinte e nove de fevereiro em anos como dois mil e vinte e quatro e dois mil, e ilegal em dois mil e vinte e três e mil e novecentos. Com o status bissexto conhecido, consulte o comprimento de cada mês daquele ano e rejeite qualquer dia que ultrapasse o comprimento do mês, por exemplo trinta e um de abril ou trinta de fevereiro.
Quando o triplo é válido, some os comprimentos de todos os meses completos anteriores ao mês dado e depois some o dia do mês. A soma é o ordinal do dia do ano: o primeiro de janeiro é sempre um, o primeiro de março é sessenta e um em ano bissexto e sessenta em ano comum, e o trinta e um de dezembro é trezentos e sessenta e seis ou trezentos e sessenta e cinco.
Onde calculadoras de dia do ano aparecem no trabalho real
Equipes de operações costumam carimbar jobs em lote e partições de data warehouse com números de dia do ano para que pastas anuais ordenem cronologicamente sem chaves de data multiparte. Cadernos de clima e agricultura traçam séries contra o dia do ano para alinhar estações multianuais mesmo quando dias bissextos aparecem. Gestores de projeto acompanham objetivos anuais como fração do ano dividindo o ordinal atual por trezentos e sessenta e cinco ou trezentos e sessenta e seis.
Software que deve ficar livre de bibliotecas de fuso horário ainda precisa de um ordinal de calendário puro para medidores de progresso, janelas de manutenção e calendários de conformidade definidos por datas civis em vez de épocas Unix.
Se mais tarde você precisar da contagem de dias úteis entre duas datas, idade a partir de uma data de nascimento, números de dia juliano completos ou numeração de semana do ano sob ISO oito mil seiscentos e um, trate-os como intenções de busca e landings separadas em vez de sobrecarregar esta página de calculadora do dia do ano.
Casos de uso
Alinhamento científico e sazonal
Mapeie séries climáticas ou agrícolas multianuais em um eixo compartilhado 1–366, deslocando corretamente de março em diante após dias bissextos.
Perguntas frequentes
O que é o dia do ano?
É a posição ordinal de um dia de calendário dentro do seu ano: 1 para 1º de janeiro, até 365 em ano comum ou 366 em ano bissexto para 31 de dezembro.
Ela lida com anos bissextos?
Sim. As regras bissextas gregorianas se aplicam: divisível por 4, exceto séculos que devem ser divisíveis por 400. 29 de fevereiro só é aceito em anos bissextos e desloca os meses posteriores em um dia.
Qual formato de data é exigido?
ISO estrito YYYY-MM-DD com ano de quatro dígitos e mês e dia de dois dígitos. Valores como 2024-3-1 ou 2024/03/01 são rejeitados para que todo cliente concorde na mesma string.
O que acontece com uma data inválida como 2023-02-29?
A mensagem de erro explica que o dia não é válido para aquele ano e mês.
Quanto custa?
A ferramenta do navegador é gratuita e roda localmente.
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/date/day-of-year \
-H "Authorization: Bearer $KIT_KEY" \
-H "Content-Type: application/json" \
-d '{"date":"2024-03-01"}'const res = await fetch("https://api.kit.forhosting.com/date/day-of-year", {
method: "POST",
headers: {
"Authorization": `Bearer ${process.env.KIT_KEY}`,
"Content-Type": "application/json"
},
body: JSON.stringify({
"date": "2024-03-01"
})
});
const { task_id } = await res.json();import os, requests
res = requests.post(
"https://api.kit.forhosting.com/date/day-of-year",
headers={"Authorization": f"Bearer {os.environ['KIT_KEY']}"},
json={
"date": "2024-03-01"
},
)
task_id = res.json()["task_id"]<?php
$res = file_get_contents("https://api.kit.forhosting.com/date/day-of-year", false, stream_context_create([
"http" => [
"method" => "POST",
"header" => "Authorization: Bearer " . getenv("KIT_KEY") . "\r\nContent-Type: application/json",
"content" => '{"date":"2024-03-01"}',
],
]));
$task = json_decode($res, true);body := bytes.NewBufferString(`{"date":"2024-03-01"}`)
req, _ := http.NewRequest("POST", "https://api.kit.forhosting.com/date/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-03-01"
}Exemplo de resposta
{
"task_id": "tsk_a1b2c3d4e5f6a1b2c3d4e5f6",
"type": "date.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
O que você envia e o que recebe de volta
Envie um campo de string obrigatório chamado date contendo um dia de calendário ISO estrito como dois mil e vinte e quatro hífen zero três hífen zero um. Dias que batem com o padrão mas não são datas de calendário reais, incluindo vinte e nove de fevereiro não bissexto e valores de mês fora de um a doze, também falham com uma mensagem que nomeia o problema para que os clientes possam corrigir a entrada sem adivinhar. Verificações clássicas incluem o primeiro de janeiro mapeando para um, o trinta e um de dezembro mapeando para o comprimento completo do ano, e o primeiro de março deslocando-se um dia entre anos bissextos e comuns. Campos ausentes, valores que não são strings e strings que não batem com o padrão de dígitos quatro-dois-dois falham com invalid_input e não são cobrados. Em caso de sucesso a resposta ecoa a string de data normalizada, os componentes numéricos de ano, mês e dia, o inteiro day_of_year de um a trezentos e sessenta e cinco ou trezentos e sessenta e seis, um booleano is_leap_year, days_in_year como trezentos e sessenta e cinco ou trezentos e sessenta e seis, remaining_days até o último dia daquele ano, e uma string formula curta que documenta a regra bissexta. O preço de chamadas API bem-sucedidas é a base publicada de US$ 0,002 por item; falhas de validação não consomem saldo pré-pago.
Onde calculadoras de dia do ano aparecem no trabalho real
Como esta capacidade é um motor de parse puro, o preço da API é a base publicada de US$ 0,002 por item bem-sucedido e a validação falha não consome saldo.
Casos de integração
Acompanhamento de progresso e metas anuais
Converta a data ISO de hoje em day_of_year e remaining_days para que painéis mostrem o percentual do ano concluído sem depender de fusos horários do host.
Rótulos em lote e partições de log
Carimbe arquivos e partições de warehouse com um número ordinal estável derivado de entradas estritas YYYY-MM-DD e invalid_input claro em datas inválidas.