Dias decorridos no ano
Em 15 de março de 2024, já passaram 74 dias inteiros do ano, ou seja, é o dia 75 de um ano bissexto. Digite uma data e veja quantos dias se passaram desde 1º de janeiro, que conta como zero. 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-15
- Ano
- 2.024
- Mês
- 3
- Dia
- 15
- Dia do ano
- 75
Esta calculadora de dias decorridos no ano recebe uma única data do calendário gregoriano no formato estrito AAAA-MM-DD e retorna quantos dias inteiros já passaram desde 1º de janeiro daquele mesmo ano. Verificações clássicas incluem 2024-01-01 resultando em zero dias decorridos, 2024-03-15 resultando em setenta e quatro dias em um ano bissexto, e 2023-12-31 resultando em trezentos e sessenta e quatro dias em um ano comum. O mecanismo usa apenas aritmética gregoriana prolética determinística: valida que o dia realmente existe no calendário, soma os comprimentos dos meses anteriores ao mês informado, adiciona o dia do mês, depois subtrai um para que 1º de janeiro seja zero em vez de um.
O que significam os dias decorridos e o que a resposta contém
Dias decorridos desde 1º de janeiro responde a uma pergunta diferente do dia ordinal do ano que às vezes as pessoas imprimem como um a trezentos e sessenta e seis, da distância em dias inteiros entre duas datas arbitrárias, e de calculadoras de dias úteis ou idade. Aqui, o relógio do ano começa em zero em 1º de janeiro: até 15 de março em um ano bissexto, setenta e quatro dias inteiros já terminaram, e o próprio dia do calendário é o dia número setenta e cinco do ano.
Se você precisa de distância entre duas datas, números de semana ISO, navegação de subtração de dias ou análise de múltiplos formatos, use essas ferramentas dedicadas; esta página responde apenas quantos dias inteiros já passaram desde 1º de janeiro do ano que contém a data informada.
Onde a aritmética de progresso do ano se encaixa em planejamento, relatórios e software
Equipes de operações e produto medem os dias decorridos no ano quando um painel mostra o progresso acumulado do ano até a data, quando uma política se refere ao enésimo dia de calendário após o Ano Novo, ou quando uma janela de retenção ou relatório é definida em relação a 1º de janeiro, e não a um relógio ao vivo.
Analistas que constroem coortes anuais usam o mesmo número para rotular posições de observação dentro de um ano, sem erros de contagem em fins de mês e dias bissextos que aparecem quando as pessoas subtraem números seriais de planilha à mão. Educadores e redatores de normas usam a ferramenta para demonstrar que 2024-02-29 é o dia sessenta de um ano bissexto, enquanto esse mesmo comprimento de fevereiro não existe em 2023, sem depender de aplicativos de calculadora opacos que incluem silenciosamente horários do dia.
Combine-a com dias entre datas, auxiliares de semana ISO ou conversão de epoch quando precisar de passos de calendário relacionados, e com outras ferramentas determinísticas gratuitas ao montar um pequeno laboratório de utilitários de data.
Casos de uso
Painéis de progresso do ano até a data
Mostre quantos dias inteiros de calendário já passaram desde 1º de janeiro em painéis, cronogramas de OKR e barras de progresso anual, sem deriva de fuso horário.
Verificações de dia do ano em anos bissextos
Verifique posições ordinais e decorridas que cruzam 29 de fevereiro apenas em anos bissextos, incluindo 31 de dezembro com 364 ou 365 dias decorridos.
Perguntas frequentes
O que acontece com anos bissextos e datas inválidas?
Os comprimentos de mês e os dias bissextos são validados.
Isso é o mesmo que dias entre duas datas?
Não. Esta ferramenta mede apenas a distância a partir de 1º de janeiro do mesmo ano. Para um par arbitrário de datas, use a calculadora de dias entre datas.
Horários do dia ou fusos horários são incluídos?
Não. Esta ferramenta conta apenas dias puros do calendário gregoriano. Ela não interpreta horários, deslocamentos ou o relógio do host.
Por que 1º de janeiro conta como zero?
Porque a contagem mostra dias completos, e em 1º de janeiro nenhum terminou ainda. O número do dia da data é sempre um a mais: em 31 de dezembro de 2023 passaram 364 dias.
Quais formatos de data posso usar?
Apenas ano, mês e dia ligados por hífens, como 2024-03-15. Formas como 2024/03/15, nomes de mês e datas com horário não são aceitos; espaços no começo ou no fim são removidos.
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/days-elapsed-year \
-H "Authorization: Bearer $KIT_KEY" \
-H "Content-Type: application/json" \
-d '{"date":"2024-03-15"}'const res = await fetch("https://api.kit.forhosting.com/date/days-elapsed-year", {
method: "POST",
headers: {
"Authorization": `Bearer ${process.env.KIT_KEY}`,
"Content-Type": "application/json"
},
body: JSON.stringify({
"date": "2024-03-15"
})
});
const { task_id } = await res.json();import os, requests
res = requests.post(
"https://api.kit.forhosting.com/date/days-elapsed-year",
headers={"Authorization": f"Bearer {os.environ['KIT_KEY']}"},
json={
"date": "2024-03-15"
},
)
task_id = res.json()["task_id"]<?php
$res = file_get_contents("https://api.kit.forhosting.com/date/days-elapsed-year", false, stream_context_create([
"http" => [
"method" => "POST",
"header" => "Authorization: Bearer " . getenv("KIT_KEY") . "\r\nContent-Type: application/json",
"content" => '{"date":"2024-03-15"}',
],
]));
$task = json_decode($res, true);body := bytes.NewBufferString(`{"date":"2024-03-15"}`)
req, _ := http.NewRequest("POST", "https://api.kit.forhosting.com/date/days-elapsed-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-15"
}Exemplo de resposta
{
"task_id": "tsk_a1b2c3d4e5f6a1b2c3d4e5f6",
"type": "date.days_elapsed_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.
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 significam os dias decorridos e o que a resposta contém
Você informa uma única data como uma string estrita AAAA-MM-DD; a calculadora valida que o dia é um dia real do calendário gregoriano — 29 de fevereiro apenas em anos bissextos, trinta dias em abril, nunca dia trinta e dois — e então retorna a string de data normalizada, os componentes year, month e day, day_of_year como o ordinal baseado em um, days_elapsed como day_of_year menos um, is_leap como um booleano, days_in_year como trezentos e sessenta e cinco ou trezentos e sessenta e seis, e um breve lembrete de fórmula. Os casos rejeitados incluem campo date ausente, formatos errados como 2024/03/15, meses impossíveis, dias que não existem como 2023-02-29, e anos fora do intervalo de um a 9999.
Como a data é interpretada e como a contagem permanece reproduzível
A string deve corresponder a quatro dígitos, um hífen, dois dígitos, outro hífen e dois dígitos; espaços no início ou no fim são removidos, mas datas parciais, apenas o dia ordinal do ano, nomes de meses e horários embutidos não são expandidos aqui. Depois da análise, o ano deve estar entre 1 e 9999, o mês entre 1 e 12, e o dia entre 1 e o comprimento real desse mês naquele ano, com anos bissextos seguindo a regra gregoriana de divisível por quatro, exceto anos de século não divisíveis por quatrocentos. O campo preferido é date, mas os aliases iso_date, d, value e day são aceitos, para que planilhas, strings de consulta e formulários tipados possam reutilizar o mesmo contrato sem renomear colunas. Internamente, o mecanismo soma os dias de cada mês completo anterior ao mês informado, adiciona o dia do mês para obter day_of_year, e então define days_elapsed como day_of_year menos um — aritmética inteira pura, estável bit a bit entre runtimes. 1º de janeiro sempre resulta em zero decorrido e day_of_year um; 31 de dezembro resulta em trezentos e sessenta e quatro decorridos em um ano comum e trezentos e sessenta e cinco em um ano bissexto. Combine a execução gratuita no navegador desta página com a API paga quando precisar do mesmo número de dias decorridos dentro de um pipeline automatizado.
Onde a aritmética de progresso do ano se encaixa em planejamento, relatórios 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 verificação pontual para um pipeline sem mudar o resultado matemático.
Casos de integração
Fixtures determinísticas para testes
Gere números reproduzíveis de days_elapsed e day_of_year para testes unitários, verificações de propriedades e asserções de CI sem depender de Date.
Perguntas técnicas
Quanto custa a calculadora de dias decorridos no ano?
É gratuita 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 days_elapsed é definido?
days_elapsed é day_of_year menos um. 1º de janeiro resulta em 0; 2 de janeiro resulta em 1. day_of_year é o ordinal baseado em um (1 em 1º de janeiro).