ForHosting KIT · Ferramentas para dev

Calculadora da data de início do Pessach por ano

A calculadora do início do Pessach encontra a data civil gregoriana em que a celebração começa ao pôr do sol no ano solicitado.

● BetaGrátis · no seu navegador

Executar grátis Ver a API

Use pelo WebAPIE-mailTelegramApp em breve

Ela aplica as regras fixas do calendário hebraico, inclusive o ciclo de dezenove anos, o cálculo do molad, os adiamentos de Rosh Hashaná e a duração variável dos meses. O resultado também informa a data civil seguinte, correspondente a 15 de Nissan, e o respectivo ano hebraico. Todo o processamento é local e determinístico, sem serviço de calendário, relógio atual, consulta de fuso horário ou acesso à rede.

O que significa a data de início retornada

No calendário hebraico, o dia começa ao pôr do sol, e não à meia-noite. Por isso, a data do Pessach pode ser apresentada de duas formas relacionadas. Esta calculadora usa como data de início do Pessach principal o dia civil em que a celebração começa ao entardecer. Ela também retorna <code>first_day_date</code>, a data civil gregoriana seguinte, correspondente ao período diurno de 15 de Nissan. Se 15 de Nissan cair em uma terça-feira, por exemplo, o resultado principal será a segunda-feira, pois a celebração começa na noite de segunda. A presença das duas datas elimina uma ambiguidade comum em agendas, viagens, calendários escolares e integrações de software. A resposta ainda inclui o ano hebraico, o rótulo da data hebraica e um indicador booleano de início ao pôr do sol. O ano informado na entrada é sempre o ano gregoriano em cuja primavera ocorre o Pessach. Assim, você pode exibir tanto o início noturno quanto o primeiro dia sem deslocar a data inadvertidamente.

Como as regras aritméticas hebraicas definem a data

Primeiro, o cálculo associa a primavera gregoriana solicitada ao ano hebraico correspondente. Em seguida, calcula a conjunção lunar média de Tishrei com base nos meses transcorridos no ciclo metônico de dezenove anos. As regras de adiamento determinam 1º de Tishrei: um molad tardio pode adiar o ano-novo, duas condições adicionais protegem anos comuns e anos posteriores a um ano bissexto, e Rosh Hashaná não pode ocorrer no domingo, na quarta-feira nem na sexta-feira. A distância entre dois anos-novos hebraicos consecutivos mostra se Cheshvan e Kislev têm a forma curta ou longa. Depois, o algoritmo soma as durações exatas de Tishrei, Cheshvan, Kislev, Tevet, Shevat e do mês ou dos meses adequados de Adar até alcançar 15 de Nissan. Por fim, converte uma contagem inteira de dias fixos em ano, mês e dia do calendário gregoriano proléptico. A subtração de um dia fixo fornece a data civil do início noturno. São regras aritméticas consolidadas, não uma observação da Lua, uma tabela anual ou uma operação dependente da localidade.

Determinismo, anos aceitos e aplicações práticas

A calculadora aceita um ano gregoriano inteiro de 1 a 9999. Ela não lê o relógio do sistema, não cria um objeto <code>Date</code>, não deduz o fuso horário do visitante, não usa aleatoriedade e não consulta serviços externos. Portanto, a mesma entrada produz o mesmo resultado JSON no navegador, em um processo API, em um pipeline de compilação ou em um ambiente de testes. Isso é útil para gerar calendários futuros, conferir eventos importados, preparar comunicações recorrentes e criar conjuntos de dados reproduzíveis. Como o horário exato do pôr do sol depende da localização e das condições atmosféricas, esta capacidade retorna deliberadamente uma data civil, e não um horário do ocaso. Se você precisar da hora local exata para acender velas ou iniciar a celebração, combine a data retornada com um cálculo solar que considere a localização. Em usos históricos, o resultado projeta o calendário hebraico aritmético fixo sobre o calendário gregoriano proléptico; ele não reconstrói costumes de observação, proclamações regionais nem sistemas civis antigos. Cada solicitação API custa US$ 0,002, e o navegador usa o mesmo núcleo aritmético puro.

Casos de uso

Montar um calendário anual de celebrações

Gere a data do início ao pôr do sol e a do primeiro dia sem manter tabelas específicas para cada ano.

Conferir eventos importados

Compare uma data recebida com um resultado independente calculado pelas regras aritméticas do calendário hebraico.

Programar comunicações antecipadamente

Identifique a noite civil correta antes de preparar lembretes ou avisos operacionais sobre a celebração.

Perguntas frequentes

A data retornada indica o pôr do sol ou o dia seguinte?

O campo principal <code>date</code> é a data gregoriana em que o Pessach começa ao pôr do sol. <code>first_day_date</code> é a data civil seguinte, correspondente a 15 de Nissan.

Quanto custa uma solicitação?

Uma solicitação API custa US$ 0,002. A capacidade executa um cálculo aritmético limitado e contabiliza um item por solicitação.

O cálculo consulta algum calendário judaico on-line?

Não. Ele usa aritmética inteira determinística e não faz nenhuma solicitação de rede.

A ferramenta calcula o horário exato do pôr do sol no local?

Não. O horário exato exige uma localização e um cálculo astronômico. Esta capacidade retorna a data civil gregoriana em que ocorre o início ao entardecer.

Por que o Pessach pode começar na data anterior a 15 de Nissan?

O dia hebraico começa ao pôr do sol. Assim, a noite que inicia 15 de Nissan fica na data civil gregoriana anterior.

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/passover-start

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/passover-start \
  -H "Authorization: Bearer $KIT_KEY" \
  -H "Content-Type: application/json" \
  -d '{"year":2026}'

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

import os, requests

res = requests.post(
    "https://api.kit.forhosting.com/date/passover-start",
    headers={"Authorization": f"Bearer {os.environ['KIT_KEY']}"},
    json={
    "year": 2026
},
)
task_id = res.json()["task_id"]

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

body := bytes.NewBufferString(`{"year":2026}`)
req, _ := http.NewRequest("POST", "https://api.kit.forhosting.com/date/passover-start", 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

{
  "year": 2026
}

Exemplo de resposta

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