ForHosting KIT · Outils pour développeurs

Durée d’une année hégirienne : 354 ou 355 jours

Ce calculateur détermine si une année du calendrier islamique tabulaire compte 354 ou 355 jours.

● BetaGratuit · dans votre navigateur

Utilisez-le depuis WebAPIE-mailTelegramApp bientôt

Saisissez une année hégirienne entière et positive pour obtenir sa position dans le cycle de 30 ans, son statut bissextile et son nombre exact de jours. Le résultat repose sur une règle arithmétique fixe : il ne dépend ni du lieu, ni de l’observation lunaire, ni du fuseau horaire, ni de l’heure actuelle, ni d’un service externe. Il convient aux logiciels, aux calculs historiques, aux tests et à l’enseignement qui utilisent explicitement le calendrier tabulaire.

Ce que désigne ici une année hégirienne

Le calendrier islamique est lunaire, mais ses différentes mises en œuvre ne fixent pas toujours les limites des mois de la même manière. Ce calculateur emploie le calendrier islamique tabulaire, un modèle arithmétique fondé sur un cycle répétitif de trente ans. Une année ordinaire compte 354 jours, tandis qu’une année bissextile désignée en compte 355, car le dernier mois reçoit un jour supplémentaire. Cette définition est essentielle : un calendrier reposant sur l’observation locale du croissant, une annonce officielle ou un modèle de visibilité astronomique peut attribuer une autre date civile près d’un changement de mois. Saisissez une année hégirienne entière et positive, par exemple 1446. La réponse fournit l’année initiale, sa position de 1 à 30 dans le cycle, son statut bissextile et le nombre de jours obtenu. Utilisez cette capacité si votre cahier des charges mentionne le calendrier islamique tabulaire ou arithmétique, ou si vous avez besoin de résultats reproductibles. Elle ne constitue pas une décision religieuse sur le début d’une célébration dans une communauté donnée.

Calcul du résultat de 354 ou 355 jours

Le calcul place d’abord l’année indiquée dans l’une des trente positions du cycle tabulaire. Les positions 2, 5, 7, 10, 13, 16, 18, 21, 24, 26 et 29 sont bissextiles ; toutes les autres sont ordinaires. Une position bissextile donne 355 jours et une position ordinaire 354. Il s’agit d’une arithmétique entière exacte, et non d’une estimation des phases lunaires. L’implémentation n’utilise pas l’objet Date de JavaScript, ne consulte pas l’horloge système, n’effectue aucune requête réseau et ne dépend d’aucune base de fuseaux horaires. UTC et les réglages locaux ne peuvent donc pas modifier la réponse. L’entrée doit être un entier numérique positif et sûr : les chaînes numériques, fractions, zéros, années négatives, infinis et entiers non sûrs sont refusés. La position du cycle figure dans la sortie afin que vous puissiez contrôler la décision. Cette règle transparente facilite aussi les tests unitaires, les migrations et les vérifications entre langages.

Choisir le modèle de calendrier adapté

Utilisez ce résultat pour les systèmes qui adoptent expressément une chronologie tabulaire conventionnelle : bibliothèques de conversion configurées pour le calendrier islamique arithmétique, simulations de récurrence, démonstrations pédagogiques, validation de bases de données et calculs historiques exigeant une parfaite reproductibilité. Si vous intégrez les données d’un autre système, vérifiez d’abord sa variante de calendrier. Les termes hégirien, islamique, civil, tabulaire, Umm al-Qura et observationnel ne sont pas toujours interchangeables. Un calendrier national officiel peut appliquer des critères astronomiques et diverger du cycle fixe. Ce service répond uniquement à la question précise annoncée : combien de jours compte l’année hégirienne tabulaire fournie. Il ne convertit pas de dates, ne prédit pas la visibilité du croissant, n’identifie pas les fêtes et ne déclare pas le début d’un mois dans une juridiction. Par API, chaque requête coûte $0.002. La réponse étant compacte et déterministe, vous pouvez la mettre en cache par année, même si le calcul direct est déjà constant et sans dépendance externe.

Cas d’usage

Valider des données calendaires

Vérifiez la conformité des nombres de jours enregistrés avec le calendrier hégirien arithmétique avant toute importation ou publication.

Créer des tests déterministes

Produisez des valeurs attendues stables pour les logiciels qui implémentent le même cycle islamique tabulaire de 30 ans.

Expliquer les années bissextiles

Présentez la position dans le cycle, le statut bissextile et la durée de l’année sans consulter un service calendaire actuel.

Questions fréquentes

Tous les calendriers islamiques donnent-ils ce résultat ?

Non. Ce calculateur concerne uniquement le calendrier islamique tabulaire ; les calendriers observationnels et officiels peuvent suivre d’autres règles.

Quelles positions du cycle sont bissextiles ?

Les positions 2, 5, 7, 10, 13, 16, 18, 21, 24, 26 et 29 de chaque cycle de 30 ans sont bissextiles.

Pourquoi une année hégirienne bissextile compte-t-elle 355 jours ?

Le système tabulaire ajoute un jour au dernier mois des années bissextiles désignées, faisant passer le total de 354 à 355.

UTC ou mon fuseau horaire influencent-ils le résultat ?

Non. Seule une arithmétique entière fixe est utilisée, sans horloge, objet Date, fuseau horaire ni service externe.

Combien coûte une requête API ?

Chaque requête API coûte $0.002.

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

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

import os, requests

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

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

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

Exemple de réponse

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