ForHosting KIT · Outils pour développeurs

Différence en décennies entre deux dates

Le calculateur d’écart en décennies mesure le nombre de périodes calendaires complètes de dix ans séparant deux dates ISO explicites.

● BetaGratuit · dans votre navigateur
Utilisez-le depuis WebAPIE-mailTelegramApp bientôt

Saisissez une date de début et une date de fin au format YYYY-MM-DD : le résultat est positif si la seconde est postérieure, négatif si elle est antérieure, et nul si moins de dix années entières se sont écoulées. Le calcul applique des règles grégoriennes fixes en UTC, sans dépendre de l’heure actuelle, du fuseau du navigateur ni d’un service externe.

Ce qu’est une décennie entière dans ce calcul

Une décennie entière correspond à un intervalle calendaire de dix ans achevé depuis la première date, et non à une simple comparaison des noms de décennies. Du 15 juin 2000 au 14 juin 2020, une seule décennie complète s’est écoulée, car il manque encore un jour avant le deuxième anniversaire décennal. Le 15 juin 2020, le résultat passe à deux. Cette distinction évite d’arrondir à la hausse des dates proches d’un anniversaire sous prétexte que leurs années diffèrent de vingt. Deux dates peuvent donc appartenir à des décennies nominales différentes tout en donnant zéro. Le résultat est volontairement entier et ignore tout reliquat incomplet après le dernier anniversaire de dix ans. Cette méthode convient aux politiques, archives, contrats et rapports qui parlent de décennies accomplies plutôt que d’une durée approximative. Les deux entrées doivent être des dates ISO explicites au format YYYY-MM-DD, afin que leur interprétation soit visible et reproductible.

Signe, règles UTC et jours bissextiles

Le signe respecte l’ordre dans lequel vous fournissez les dates. Si la seconde est postérieure à la première, le nombre est positif. Si elle est antérieure, le même nombre de décennies entières devient un entier négatif. Deux dates identiques donnent zéro. Inverser la paire inverse donc le signe sans modifier la valeur absolue, ce qui facilite tris, comparaisons et calculs orientés. La validation et l’arithmétique suivent le calendrier grégorien proleptique sans utiliser l’objet Date de JavaScript. Aucune conversion de fuseau local, transition d’heure d’été, horloge courante, requête réseau ou analyse dépendante de la langue n’intervient. Pour une date initiale au 29 février, l’anniversaire est ramené au 28 février lorsque l’année cible n’est pas bissextile. Cette convention explicite stabilise le résultat aux frontières des années bissextiles tout en respectant l’arithmétique habituelle des durées calendaires. Les années admises vont de 0001 à 9999.

Bien exploiter le résultat

Envoyez la date ISO initiale dans le champ from et la date ISO finale dans le champ to. La réponse reprend les deux entrées validées, fournit le nombre signé de décennies et indique une direction vers l’avenir, vers le passé ou nulle. Utilisez directement cet entier pour compter des périodes de dix ans achevées, par exemple afin de regrouper des programmes anciens, de vérifier le franchissement d’un anniversaire ou de décrire l’écart entre des documents historiques. Ne l’interprétez pas comme une estimation décimale en années : un résultat de trois signifie que trois décennies calendaires complètes se sont écoulées, et non qu’il ne reste aucun mois ni jour au-delà de trente ans. Cet outil ne déduit pas non plus de dates depuis du langage naturel, des formats régionaux, des horodatages ou l’instant présent. Ces exclusions rendent chaque appel répété déterministe. Une requête par API coûte $0.002, tandis que la version dans le navigateur exécute le même calcul pur et fournit un résultat identique.

Contrôler un anniversaire à long terme

Vérifiez si un projet, une institution, un accord ou une collection a accompli un nombre précis d’anniversaires décennaux.

Comparer des archives historiques

Obtenez un écart signé stable entre deux dates d’archives sans dépendre du fuseau de l’ordinateur ni de l’horloge actuelle.

Créer des règles de rapport déterministes

Classez des dossiers par décennies calendaires entières avec les mêmes limites dans le navigateur et les traitements par API.

Que signifie le signe ?

Un nombre positif indique que 'to' est postérieur à 'from', un nombre négatif qu’il est antérieur, et zéro qu’aucune décennie entière ne les sépare.

Les décennies partielles sont-elles arrondies ?

Non. Seuls les anniversaires calendaires complets de dix ans sont comptés ; tout reliquat incomplet est ignoré.

Quel format de date est accepté ?

Les deux valeurs doivent être des dates ISO explicites au format YYYY-MM-DD, avec une année comprise entre 0001 et 9999.

Comment le 29 février est-il traité ?

Si un anniversaire décennal tombe dans une année non bissextile, le 29 février est ramené au 28 février pour la comparaison.

Le fuseau horaire ou l’heure d’été influencent-ils le résultat ?

Non. Le calcul emploie une arithmétique grégorienne déterministe en UTC et ne consulte jamais le fuseau local.

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

Chaque requête par API coûte $0.002. Vous pouvez aussi effectuer gratuitement le calcul dans le navigateur.

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.

POSThttps://api.kit.forhosting.com/date/diff-in-decades

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é.

curl -X POST https://api.kit.forhosting.com/date/diff-in-decades \
  -H "Authorization: Bearer $KIT_KEY" \
  -H "Content-Type: application/json" \
  -d '{"from":"1985-07-25","to":"2026-07-25"}'
{
  "from": "1985-07-25",
  "to": "2026-07-25"
}
{
  "task_id": "tsk_a1b2c3d4e5f6a1b2c3d4e5f6",
  "type": "date.diff_in_decades",
  "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.

par requête$0.002

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

HTTPCodeSignification
401unauthorizedClé API absente ou invalide : vérifiez l’en-tête Authorization.
402insufficient_balanceSolde insuffisant : rechargez votre compte pour lancer cette tâche.
404unknown_typeType de tâche inconnu : vérifiez le champ type de votre requête.
429rate_limitedTrop de requêtes : ralentissez la cadence, puis réessayez.

Consulter la documentation complète du KIT →