ForHosting KIT · Ferramentas para dev

Data Juliana para data e hora gregoriana

Esta calculadora converte uma Data Juliana astronômica na data correspondente do calendário gregoriano proléptico e no horário do dia.

● BetaGrátis · no seu navegador

Executar grátis Ver a API

Use pelo WebAPIE-mailTelegramApp em breve

Informe um número finito e receba campos separados para ano, mês, dia, horas, minutos, segundos e milissegundos. O cálculo segue o algoritmo inverso padrão e considera a convenção astronômica de que uma Data Juliana inteira começa ao meio-dia, não à meia-noite. Nenhuma rede, relógio do sistema ou base de fusos horários é usada; portanto, a mesma entrada sempre gera o mesmo resultado. Você pode conferir valores no navegador ou automatizar fluxos científicos pela API por US$ 0,002 a cada solicitação.

Entenda a convenção antes da conversão

Uma Data Juliana é uma contagem contínua de dias e frações de dia usada em astronomia, análise orbital, arquivos históricos e software científico. Ela não é uma data escrita no antigo calendário juliano. Na contagem astronômica, cada limite inteiro ocorre ao meio-dia do Tempo Universal, e não à meia-noite civil. Por exemplo, 2451545.0 corresponde a 1 de janeiro de 2000 às 12:00:00, enquanto 2451544.5 corresponde ao mesmo dia às 00:00:00. A calculadora compensa automaticamente esse deslocamento de meio dia. Forneça julian_date como número JSON finito; jd também é aceito. A resposta separa ano, mês, dia, horas, minutos, segundos e milissegundos. A numeração astronômica inclui o ano zero, e as regras do calendário gregoriano proléptico valem mesmo antes da reforma histórica. Strings, valores ausentes, NaN e infinitos são rejeitados para impedir datas enganosas.

Como o cálculo produz os campos

A conversão começa somando meio dia à Data Juliana informada. A parte inteira passa a identificar o dia civil iniciado à meia-noite, e a fração restante indica o tempo decorrido. O algoritmo inverso aplica a correção gregoriana dos séculos, monta termos inteiros intermediários e obtém dia, mês e ano por operações limitadas de piso. A fração do dia é convertida em milissegundos e depois dividida em horas, minutos, segundos e milissegundos. O arredondamento ao milissegundo mantém o JSON estável e preserva mais precisão do que a maioria dos valores publicados. Se o arredondamento chegar exatamente ao fim do dia, a data avança corretamente, inclusive em mudanças de mês, ano e dia bissexto. O cálculo não chama Date, não consulta fuso horário nem efemérides e não usa aleatoriedade. Ele também não determina se a fonte usa UTC, TT, TAI ou outra escala; essa informação pertence ao conjunto de dados e deve acompanhá-lo.

Use o resultado com segurança

A calculadora ajuda quando tabelas de observação, listas de eventos espaciais, exportações de efemérides ou artigos fornecem Datas Julianas, mas leitores precisam de campos gregorianos reconhecíveis. Ela também cria casos determinísticos para testar bibliotecas de calendário sem depender do ambiente do computador. Em uma importação, confirme que cada célula seja numérica e preserve a Data Juliana original ao lado dos campos convertidos para manter a rastreabilidade. A resposta entrega componentes em vez de uma frase localizada; assim, seu aplicativo pode montar textos ISO, colunas de banco ou rótulos sem interpretar prosa. Nenhuma conversão de fuso local é feita. O navegador atende verificações pontuais, e a API custa US$ 0,002 por solicitação. Ao comparar resultados, confirme que as ferramentas usam Data Juliana astronômica, calendário gregoriano, a mesma escala de tempo e precisão semelhante. Essas verificações explicam diferenças aparentes de um dia, doze horas ou menos de um segundo.

Casos de uso

Registros de observação astronômica

Transforme marcas julianas contínuas em componentes gregorianos legíveis para relatórios, índices e análises.

Ingestão de dados científicos

Normalize colunas numéricas mantendo campos determinísticos e separados de data e horário.

Testes de bibliotecas de calendário

Crie casos repetíveis para épocas conhecidas, dias bissextos, viradas de mês e dias fracionários.

Perguntas frequentes

Quanto custa uma conversão pela API?

Cada solicitação à API custa US$ 0,002; você pode usar a calculadora no navegador para verificações interativas.

Por que Datas Julianas inteiras representam o meio-dia?

Por convenção, os dias julianos astronômicos começam ao meio-dia; o algoritmo soma meio dia antes de extrair a data civil.

Qual calendário é usado no resultado?

É usado o calendário gregoriano proléptico, com suas regras de anos bissextos aplicadas a todos os anos aceitos.

A calculadora usa meu fuso horário local?

Não. Ela retorna o horário codificado pela Data Juliana sem consultar fuso horário nem relógio do sistema.

Quais entradas causam erro?

Valores ausentes, strings, objetos, NaN e infinitos são rejeitados porque a entrada precisa ser um número finito.

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/datetime-from-julian-date

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/datetime-from-julian-date \
  -H "Authorization: Bearer $KIT_KEY" \
  -H "Content-Type: application/json" \
  -d '{"julian_date":2451545}'

const res = await fetch("https://api.kit.forhosting.com/astro/datetime-from-julian-date", {
  method: "POST",
  headers: {
    "Authorization": `Bearer ${process.env.KIT_KEY}`,
    "Content-Type": "application/json"
  },
  body: JSON.stringify({
    "julian_date": 2451545
  })
});
const { task_id } = await res.json();

import os, requests

res = requests.post(
    "https://api.kit.forhosting.com/astro/datetime-from-julian-date",
    headers={"Authorization": f"Bearer {os.environ['KIT_KEY']}"},
    json={
    "julian_date": 2451545
},
)
task_id = res.json()["task_id"]

<?php
$res = file_get_contents("https://api.kit.forhosting.com/astro/datetime-from-julian-date", false, stream_context_create([
  "http" => [
    "method"  => "POST",
    "header"  => "Authorization: Bearer " . getenv("KIT_KEY") . "\r\nContent-Type: application/json",
    "content" => '{"julian_date":2451545}',
  ],
]));
$task = json_decode($res, true);

body := bytes.NewBufferString(`{"julian_date":2451545}`)
req, _ := http.NewRequest("POST", "https://api.kit.forhosting.com/astro/datetime-from-julian-date", 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

{
  "julian_date": 2451545
}

Exemplo de resposta

{
  "task_id": "tsk_a1b2c3d4e5f6a1b2c3d4e5f6",
  "type": "astro.datetime_from_julian_date",
  "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 →