ForHosting KIT · Outils pour développeurs

Durée de l’année hébraïque : de 353 à 385 jours

Ce calculateur renvoie le nombre exact de jours d’une année numérotée du calendrier hébraïque.

● BetaGratuit · dans votre navigateur

Utilisez-le depuis WebAPIE-mailTelegramApp bientôt

Les mois intercalaires et les règles de report donnent six durées possibles : 353, 354 ou 355 jours pour une année commune, et 383, 384 ou 385 pour une année embolismique. Le résultat précise aussi si l’année est défective, régulière ou complète et indique son caractère embolismique, ce qui facilite la création de calendriers, la recherche, la planification et la validation des données.

Pourquoi six durées sont possibles

Le calendrier hébraïque est luni-solaire : ses mois suivent les cycles lunaires, tandis que les années embolismiques maintiennent les fêtes dans leur saison. Une année commune comprend douze mois et une année embolismique en ajoute un treizième. La durée de Heshvan et de Kislev peut également varier, produisant des formes défective, régulière et complète. Elles comptent 353, 354 et 355 jours dans les années communes, contre 383, 384 et 385 dans les années embolismiques. Le calculateur applique toutes ces règles à partir du seul numéro d’année et renvoie l’année, le total exact, sa catégorie et l’indicateur d’intercalation, sans localisation, horloge ni service externe.

Fonctionnement du calcul déterministe

Le calcul compte d’abord les mois lunaires écoulés avant Tishri selon le cycle métonique fixe de dix-neuf ans. Il calcule ensuite les parts traditionnelles du molad et applique les règles de report afin d’obtenir un numéro de jour entier pour Roch Hachana. La même opération sur l’année suivante permet d’obtenir la durée par soustraction. Seules des opérations entières bornées sont utilisées : aucune Date, aucun fuseau horaire, aucune heure courante, aucun hasard et aucun réseau. Une entrée identique produit donc toujours le même JSON en UTC et ailleurs. La plage acceptée garantit aussi l’exactitude des entiers intermédiaires en JavaScript.

Interpréter et exploiter le résultat

Saisissez le numéro entier de l’année hébraïque, par exemple 5784, et non une année grégorienne ou un libellé. Le champ des jours couvre la période de Roch Hachana de cette année à celui de l’année suivante. L’indicateur d’intercalation distingue le groupe commun de douze mois de celui de treize mois. La catégorie décrit la forme variable : défective signifie un jour de moins que la durée régulière du groupe, régulière correspond à la valeur centrale et complète ajoute un jour. Vous pouvez ainsi choisir une table mensuelle, contrôler des données ou expliquer le cycle sans supposition. Ne déduisez pas l’année hébraïque par simple addition d’une constante à l’année grégorienne. Une requête API coûte $0.002.

Cas d’usage

Créer un calendrier hébraïque

Choisissez la bonne table de mois communs ou intercalaires avant de générer les dates d’une année hébraïque.

Valider des données calendaires

Vérifiez que l’année enregistrée et sa durée déclarée constituent l’une des six combinaisons valides.

Expliquer la structure du calendrier

Montrez comment l’intercalation et les formes défective, régulière ou complète produisent six durées.

Questions fréquentes

Quelles valeurs le calculateur peut-il renvoyer ?

Il renvoie 353, 354 ou 355 jours pour une année commune, et 383, 384 ou 385 pour une année embolismique.

Que signifient défective, régulière et complète ?

Ces termes désignent respectivement un jour de moins, la même durée ou un jour de plus que la durée régulière du groupe.

Mon fuseau horaire est-il utilisé ?

Non. Le calcul repose sur une arithmétique calendaire fixe, sans horloge ni fuseau, et reste déterministe en UTC.

Dois-je saisir une année grégorienne ?

Non. Saisissez le numéro de l’année du calendrier hébraïque, par exemple 5784.

Quel est le prix d’une requête API ?

Chaque requête API coûte $0.002, sans supplément lié à une unité d’utilisation.

Pour les développeurs — accès API

Tout sur cette page est disponible par programmation. Cette section s'adresse aux équipes qui veulent l'intégrer à leurs systèmes ; les autres peuvent simplement utiliser l'outil ci-dessus.

Endpoint

POSThttps://api.kit.forhosting.com/date/hebrew-year-length

Authentification par jeton Bearer : un seul POST met la tâche en file d’attente, et le résultat vous parvient par webhook ou lien signé.

Appeler depuis votre stack

curl -X POST https://api.kit.forhosting.com/date/hebrew-year-length \
  -H "Authorization: Bearer $KIT_KEY" \
  -H "Content-Type: application/json" \
  -d '{"year":5784}'

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

import os, requests

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

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

body := bytes.NewBufferString(`{"year":5784}`)
req, _ := http.NewRequest("POST", "https://api.kit.forhosting.com/date/hebrew-year-length", body)
req.Header.Set("Authorization", "Bearer "+os.Getenv("KIT_KEY"))
req.Header.Set("Content-Type", "application/json")
res, _ := http.DefaultClient.Do(req)

Exemple de requête

{
  "year": 5784
}

Exemple de réponse

{
  "task_id": "tsk_a1b2c3d4e5f6a1b2c3d4e5f6",
  "type": "date.hebrew_year_length",
  "status": "queued",
  "_links": {
    "result": "/tasks/tsk_…/result"
  }
}

L’API est asynchrone : chaque appel renvoie un task_id immédiatement, puis vous interrogez l’état à raison d’une requête par seconde.

Tarifs

par requête$0.002

Le prix est publié, sans tokens ni crédits. Une tâche qui échoue n’est pas facturée.

Erreurs

HTTP	Code	Signification
`401`	`unauthorized`	Clé API absente ou invalide : vérifiez l’en-tête Authorization.
`402`	`insufficient_balance`	Solde insuffisant : rechargez votre compte pour lancer cette tâche.
`404`	`unknown_type`	Type de tâche inconnu : vérifiez le champ type de votre requête.
`429`	`rate_limited`	Trop de requêtes : ralentissez la cadence, puis réessayez.

Consulter la documentation complète du KIT →