ForHosting KIT · Datas e tempo

Equação do tempo aproximada

Em 11 de fevereiro de 2024, dia 42 do ano, um relógio de sol fica cerca de catorze minutos e meio atrás de um relógio médio. Digite uma data e receba a equação do tempo aproximada em minutos: positiva quando o relógio de sol adianta. 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

Data: 2024-02-11

Você obtém

Ano: 2.024
Mês: 2
Dia: 11
Dia do ano: 42

A equação do tempo são os minutos que separam a leitura de um relógio de sol de um relógio médio uniforme no mesmo meridiano. Ela surge porque a órbita da Terra é ligeiramente elíptica e o eixo está inclinado, de modo que o meio-dia solar verdadeiro se adianta ou se atrasa em relação ao meio-dia civil em até cerca de dezesseis minutos ao longo do ano. Projetistas de relógios de sol, rastreadores solares e demonstrações educativas precisam de um valor reproduzível para um dia de calendário escolhido sem chamar um serviço de efemérides. Esta calculadora da equação do tempo aproximada aceita uma única data ISO no formato YYYY-MM-DD, converte-a em dia do ano sob regras gregorianas prolépticas de ano bissexto e avalia a fórmula clássica de três termos dos textos de engenharia solar. O cálculo é puro e determinístico no espaço de calendário UTC a partir apenas da data de entrada — sem rede, sem aleatoriedade e sem depender do relógio do sistema anfitrião.

O que a equação do tempo significa e a aproximação de três termos

O tempo solar aparente é o que um relógio de sol corretamente orientado mostra: o ângulo horário do Sol verdadeiro. O tempo solar médio é o dia uniforme de vinte e quatro horas dos relógios civis na mesma longitude. A diferença entre eles é a equação do tempo.

Ao longo de um ano o desvio oscila de cerca de menos quatorze minutos (relógio de sol atrasado, frequentemente em meados de fevereiro) até cerca de mais dezesseis minutos (relógio de sol adiantado, frequentemente no início de novembro), com zeros perto de meados de abril, meados de junho, início de setembro e final de dezembro conforme o modelo.

Esta capacidade implementa a aproximação de três termos amplamente ensinada: E igual a 9.87 vezes sin de 2B menos 7.53 vezes cos de B menos 1.5 vezes sin de B, onde B é dois pi sobre trezentos e sessenta e cinco vezes N menos oitenta e um, e N é o dia do ano com o primeiro de janeiro igual a um. O deslocamento de oitenta e um dias ancora a fase perto da região do equinócio de março da fórmula clássica.

A aproximação é intencionalmente simples: não inclui séries orbitais de ordem superior nem nutação, mas é precisa o suficiente para layout de relógios de sol, checagens de sala de aula e estimativas de meio-dia solar que só precisam de orientação ao nível do minuto. Anos bissextos ainda alimentam o dia real do calendário em N via regras gregorianas, enquanto o período angular permanece fixo em trezentos e sessenta e cinco como no modelo de livro.

Convenção de sinal relógio de sol menos relógio: uma equação do tempo positiva significa que o meio-dia solar aparente ocorre antes do meio-dia médio, então você subtrai E minutos do relógio de sol para coincidir com o tempo médio, ou soma E ao tempo médio para estimar a hora do relógio de sol.

Onde a equação do tempo faz diferença

Fabricantes de relógios de sol e intérpretes de patrimônio usam uma calculadora da equação do tempo para que visitantes compreendam por que o meio-dia no mostrador nem sempre é meio-dia no relógio de pulso. Instaladores de energia solar estimam o meio-dia solar verdadeiro para checagens de azimute de painéis sem montar uma efeméride planetária completa. Sites de documentação que ranqueiam por equação do tempo aproximada se beneficiam de um caminho gratuito no navegador cujo módulo puro coincide byte a byte com a automação paga.

Como a implementação é matemática analítica parse de nível A, a latência no pior caso permanece desprezível e a validação falha não consome saldo.

Casos de uso

Projeto e interpretação de relógios de sol

Converta uma data ISO escolhida em minutos de desvio relógio de sol versus relógio para que tabelas de correção gravadas e placas de visitantes fiquem consistentes com o modelo de três termos.

Autocorreção em sala de aula e LMS

Avalie tarefas de equação do tempo com um oráculo determinístico que rejeita datas inválidas e sempre devolve os mesmos minutos para o mesmo YYYY-MM-DD.

Perguntas frequentes

O que significa uma equação do tempo positiva?

E positivo significa que o relógio de sol (tempo solar aparente) está à frente do relógio médio. E negativo significa que o relógio de sol está atrás.

A calculadora usa meu fuso horário local?

Não. A entrada é apenas uma data de calendário (rótulo de dia UTC). Longitude e deslocamentos de fuso civil não são aplicados; adicione-os você mesmo se precisar do meio-dia solar local.

Como transformo a leitura de um relógio de sol em hora do relógio?

Subtraia a equação do tempo da leitura do relógio de sol. Em 11 de fevereiro de 2024 o valor é negativo, cerca de catorze minutos e meio, então você soma essa quantidade ao que o relógio de sol mostra para obter a hora média.

Em que época do ano a diferença é maior?

Fica perto de catorze minutos de atraso em meados de fevereiro e de dezesseis minutos de adiantamento no começo de novembro. Os dois relógios coincidem perto de meados de abril, meados de junho, início de setembro e fim de dezembro.

Qual é a precisão da aproximação de três termos?

Ela deixa de fora termos orbitais de ordem superior e a nutação, então serve como guia de minuto e não como efeméride exata. Isso basta para traçar um relógio de sol, corrigir exercícios ou estimar o meio-dia solar.

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/equation-of-time-approx

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/equation-of-time-approx \
  -H "Authorization: Bearer $KIT_KEY" \
  -H "Content-Type: application/json" \
  -d '{"date":"2024-02-11"}'

const res = await fetch("https://api.kit.forhosting.com/date/equation-of-time-approx", {
  method: "POST",
  headers: {
    "Authorization": `Bearer ${process.env.KIT_KEY}`,
    "Content-Type": "application/json"
  },
  body: JSON.stringify({
    "date": "2024-02-11"
  })
});
const { task_id } = await res.json();

import os, requests

res = requests.post(
    "https://api.kit.forhosting.com/date/equation-of-time-approx",
    headers={"Authorization": f"Bearer {os.environ['KIT_KEY']}"},
    json={
    "date": "2024-02-11"
},
)
task_id = res.json()["task_id"]

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

body := bytes.NewBufferString(`{"date":"2024-02-11"}`)
req, _ := http.NewRequest("POST", "https://api.kit.forhosting.com/date/equation-of-time-approx", 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-02-11"
}

Exemplo de resposta

{
  "task_id": "tsk_a1b2c3d4e5f6a1b2c3d4e5f6",
  "type": "date.equation_of_time_approx",
  "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.

Notas técnicas

O resultado é equation_of_time_min (idêntico a sundial_minus_clock_min): positivo quando o relógio de sol está à frente do relógio médio, negativo quando está atrás.

Contrato de entrada, campos de resposta e erros de validação

A data é tratada apenas como rótulo de dia de calendário UTC; longitude e deslocamentos civis locais ficam fora do escopo. A faixa válida do ano é 0001 a 9999 sob regras gregorianas prolépticas de bissexto (fevereiro tem vinte e nove dias quando o ano é divisível por quatro mas não por cem, salvo se também for divisível por quatrocentos). Envie por POST um objeto JSON com o campo de string obrigatório date na forma ISO estrita YYYY-MM-DD — ano de quatro dígitos, mês de dois e dia de dois, sem componente de hora e sem sufixo de fuso. Os aliases iso, day e d são aceitos para o mesmo campo. Valores que não sejam strings, ausentes, strings vazias, formas incorretas como 2024/02/11 e dias de calendário impossíveis como 2023-02-29 falham com invalid_input e não são cobrados. Em caso de sucesso o corpo ecoa date, year, month, day, day_of_year e is_leap_year; devolve equation_of_time_min e o idêntico sundial_minus_clock_min arredondados para goldens estáveis entre runtimes; inclui b_rad (o ângulo intermediário B em radianos); e fornece formula, method igual a three_term_approx e um breve sign_note. Fluxo de exemplo: envie date 2024-02-11, receba day_of_year quarenta e dois e uma equação do tempo negativa perto do extremo de meados de fevereiro (relógio de sol atrás do relógio médio), adequada para ajustar uma leitura de relógio de sol horizontal em direção ao tempo médio. Combine os minutos com sua própria correção de longitude (quatro minutos por grau de longitude a partir do meridiano padrão) se precisar do meio-dia solar local frente a um relógio de fuso; este endpoint devolve apenas a peça da equação do tempo.

Onde uma API de equação do tempo aproximada se paga

Laboratórios de sala de aula e autocorretores de MOOC precisam de um oráculo determinístico que sempre mapeie a mesma data ISO para os mesmos minutos, incluindo deslocamentos de dia do ano em bissextos, para que planilhas de alunos e checagens API nunca discordem. Scripts de automação que carimbam fotos ou logs com anotações de tempo solar podem chamar a API pré-paga ao preço base publicado US$ 0,002 por item bem-sucedido, sem tokens de modelo e sem rede de saída do worker. Mantenha a solicitação em uma única data de calendário, fixe equation_of_time_min arredondado nos testes e você obtém desvios relógio de sol–relógio reproduzíveis para educação, UX de produto e workers de borda sem embutir bibliotecas astronômicas próprias.

Casos de integração

Estimativas de meio-dia solar para instaladores

Combine equation_of_time_min com minutos de longitude a partir do meridiano para aproximar o meio-dia solar aparente local frente a um relógio de fuso sem serviço de efemérides.

Perguntas técnicas

Como calcular a equação do tempo aproximada para uma data?

Envie {"date":"YYYY-MM-DD"}. A API devolve equation_of_time_min (e sundial_minus_clock_min) com E=9.87·sin(2B)−7.53·cos(B)−1.5·sin(B), B=2π/365·(N−81) e N=dia do ano.

Quais datas são rejeitadas?

Data ausente ou não string, formas diferentes de YYYY-MM-DD, anos fora de 0001–9999 e dias impossíveis como 2023-02-29 falham com invalid_input e não são cobrados.

Quanto custa a calculadora da equação do tempo aproximada?

A ferramenta do navegador é grátis. Solicitações API usam saldo pré-pago KIT a US$ 0,002 por chamada bem-sucedida; entrada inválida não é cobrada.

Ver a documentação completa do KIT →

Executar grátis