ForHosting KIT · Dates et temps

Calculateur de numéro d'anniversaire

Trouvez quel anniversaire marque un jour donné : une personne embauchée le 15 mars 2014 fête son 10e anniversaire d'ancienneté le 15 mars 2024. Les dates du dernier et du prochain anniversaire sont aussi affichées. Gratuit dans votre navigateur.

Gratuit
Fonctionne dans votre navigateur
Sans inscription
Vos données restent sur votre appareil

Lancer gratuitement Voir l’API

Utilisez-le depuis WebAPIE-mailTelegramApp bientôt

Exemple résolu

Si vous saisissez

Date de l'événement: 2014-03-15
As of: 2024-03-15

Vous obtenez

Numéro de l'anniversaire: 10
Numéro d'anniversaire: 10th
Date du dernier anniversaire: 2024-03-15
Date du prochain anniversaire: 2024-03-15

On cherche quel numéro d'anniversaire lorsqu'il faut une réponse claire à une question pratique : si quelqu'un a été embauché un jour civil donné, quel anniversaire professionnel tombe à une date ultérieure—le cinquième, le dixième, le vingt-cinquième ? Le même besoin apparaît pour les anniversaires de mariage, les jalons de lancement produit, les renouvellements d'adhésion et les récompenses d'ancienneté déclenchées sur des années pleines accomplies depuis un événement d'origine. Les outils génériques d'écart de dates renvoient un total de jours ou un âge détaillé ; ils ne disent pas « c'est le dixième anniversaire » avec une étiquette ordinale et un indicateur indiquant si le jour de référence est le jour d'anniversaire observé. Cette capacité accepte deux dates civiles ISO strictes, valide les règles grégoriennes bissextiles, compte les années pleines accomplies avec une logique mois-jour de type âge, traite les événements du vingt-neuf février comme observés le vingt-huit les années non bissextiles, et renvoie le numéro d'anniversaire, l'ordinal anglais, les chaînes ISO du dernier et du prochain anniversaire, et une courte formule.

Comment le numéro d'anniversaire est calculé à partir de deux dates ISO

Partez de deux dates civiles au format international ISO année-mois-jour à largeurs fixes afin que chaque client s'accorde sur les six mêmes entiers : la date d'événement d'origine (jour d'embauche, mariage, fondation, premier prélèvement d'abonnement) et la date de référence que vous souhaitez étiqueter.

Pour chaque chaîne, confirmez que l'année se situe dans la plage grégorienne pratique de un à neuf mille neuf cent quatre-vingt-dix-neuf, que le mois est entre un et douze, et que le jour existe pour ce mois selon les règles bissextiles grégoriennes : une année est bissextile lorsqu'elle est divisible par quatre, sauf que les années séculaires ne le sont que si elles sont aussi divisibles par quatre cents.

Cette règle rend le vingt-neuf février légal en deux mille vingt-quatre et deux mille, et illégal en deux mille vingt-trois et dix-neuf cents. Lorsque les deux triplets sont valides et que le jour de référence n'est pas antérieur à l'événement, soustrayez l'année de l'événement de l'année de référence pour obtenir un décompte candidat d'années, puis vérifiez si le mois et le jour de référence ont déjà atteint le jour d'anniversaire observé dans l'année de référence.

Si le jour de référence se situe encore avant ce mois et ce jour observés, soustrayez un afin de ne jamais revendiquer un anniversaire accompli qui n'a pas encore eu lieu. Le jour d'anniversaire observé est le même mois et le même jour que l'événement, sauf qu'un événement du vingt-neuf février est observé le vingt-huit les années non bissextiles pour qu'il y ait toujours un jour civil concret. Le jour même de l'événement, le nombre accompli est zéro—le jour de l'événement, pas encore le premier anniversaire.

Un an plus tard le jour observé, le nombre est un ; dix ans plus tard il est dix, et ainsi de suite.

Où les calculateurs de numéro d'anniversaire interviennent au travail

Les équipes RH et d'opérations personnes produisent des listes de récompenses d'ancienneté indiquant qui atteint le cinquième, dixième ou vingt-cinquième anniversaire professionnel un jour civil donné ou dans une fenêtre à venir, et ont besoin d'un nombre déterministe plutôt qu'une chaîne d'âge en texte libre. Les planificateurs de mariages et d'événements programment des dîners commémoratifs le jour exact de l'anniversaire et veulent un ordinal clair pour invitations et programmes imprimés.

Les systèmes produit et d'adhésion débloquent badges, remises ou paliers de fidélité sur des années accomplies depuis l'inscription ou le premier achat et doivent s'accorder avec la page d'anniversaire côté client. Si plus tard vous avez besoin de jours absolus entre deux dates non ordonnées, d'un âge en années mois et jours, de jours ouvrés excluant les week-ends, ou d'une simple addition de jours à une base unique, traitez-les comme des intentions de recherche et des pages d'atterrissage distinctes plutôt que de surcharger cette page de numéro d'anniversaire.

Cas d’usage

Listes de récompenses professionnelles et d'ancienneté

À partir d'une date ISO d'embauche et d'un jour de référence, obtenez le numéro et l'ordinal d'anniversaire professionnel accompli pour que les RH signalent les cinquième, dixième et vingt-cinquième récompenses sans compter à la main.

Jalons de mariage et personnels

Étiquetez quel anniversaire de mariage ou de relation tombe à une date de célébration prévue, y compris si ce jour est le jour d'anniversaire observé exact.

Seuils annuels d'adhésion et de fidélité

Débloquez badges ou remises annuelles lorsqu'un jour de référence de membre atteint un numéro d'anniversaire accompli depuis l'inscription ou le premier achat.

Questions fréquentes

Quel est le numéro d'anniversaire le jour original de l'événement ?

Zéro. Le jour de l'événement est le départ, pas encore le premier anniversaire. Un an plus tard le jour observé le nombre est 1 ; dix ans plus tard il est 10.

Comment sont traités les événements du 29 février (jour bissextile) ?

Les années non bissextiles, l'anniversaire est observé le 28 février pour qu'il y ait toujours un jour civil concret. Les années bissextiles, il reste le 29 février.

Quel numéro obtient-on si l'anniversaire de l'année n'est pas encore arrivé ?

Le précédent. Seules les années révolues comptent : la veille du 15 mars 2024, une personne embauchée le 15 mars 2014 en est encore à son neuvième anniversaire, pas au dixième.

L'outil indique-t-il la date du prochain anniversaire ?

Oui. En plus du numéro, vous obtenez la date de l'anniversaire le plus récent et celle du suivant, ainsi qu'une indication précisant si le jour vérifié est le jour même de l'anniversaire.

Peut-on l'utiliser pour un mariage ou une entreprise ?

Oui. Tout événement d'origine convient : une embauche, un mariage, la fondation d'une entreprise ou une première adhésion. Saisissez ce jour d'origine et le jour à vérifier.

Outils associés

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/anniversary-number

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/anniversary-number \
  -H "Authorization: Bearer $KIT_KEY" \
  -H "Content-Type: application/json" \
  -d '{"event_date":"2014-03-15","as_of":"2024-03-15"}'

const res = await fetch("https://api.kit.forhosting.com/date/anniversary-number", {
  method: "POST",
  headers: {
    "Authorization": `Bearer ${process.env.KIT_KEY}`,
    "Content-Type": "application/json"
  },
  body: JSON.stringify({
    "event_date": "2014-03-15",
    "as_of": "2024-03-15"
  })
});
const { task_id } = await res.json();

import os, requests

res = requests.post(
    "https://api.kit.forhosting.com/date/anniversary-number",
    headers={"Authorization": f"Bearer {os.environ['KIT_KEY']}"},
    json={
    "event_date": "2014-03-15",
    "as_of": "2024-03-15"
},
)
task_id = res.json()["task_id"]

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

body := bytes.NewBufferString(`{"event_date":"2014-03-15","as_of":"2024-03-15"}`)
req, _ := http.NewRequest("POST", "https://api.kit.forhosting.com/date/anniversary-number", 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

{
  "event_date": "2014-03-15",
  "as_of": "2024-03-15"
}

Exemple de réponse

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

Notes techniques

Le chemin gratuit du navigateur et l'API partagent un unique module pur et déterministe, sans horloge hôte et sans objet Date JavaScript, de sorte que scripts RH, planificateurs de cérémonies et démonstrations pédagogiques s'accordent toujours.

Ce que vous envoyez et ce que vous recevez en retour

Envoyez deux champs chaîne obligatoires : event_date et as_of, chacun un jour civil ISO strict tel que deux mille quatorze trait zéro trois trait un cinq et deux mille vingt-quatre trait zéro trois trait un cinq. Des alias courants comme hire_date, original, start, check_date, reference_date et on sont acceptés par le même noyau afin que scripts RH et formulaires SEO utilisent des noms familiers sans changer le calcul. Champs manquants, valeurs non chaîne, chaînes qui ne correspondent pas au motif quatre-deux-deux chiffres, dates au bon motif mais non civiles, et un jour as_of antérieur à l'événement échouent avec invalid_input et ne sont pas facturés. En cas de succès, la réponse répète les chaînes ISO normalisées event_date et as_of ; anniversary_number comme années pleines accomplies non négatives ; anniversary_ordinal comme étiquette anglaise (par exemple tenth ou first) ; is_anniversary_day vrai lorsque le jour as_of coïncide avec le mois et le jour d'anniversaire observés cette année-là ; last_anniversary_date et next_anniversary_date comme chaînes ISO du plus récent anniversaire en ou avant as_of et du prochain en ou après as_of ; first_anniversary_date lorsque l'année du premier anniversaire reste dans la plage prise en charge ; et une courte chaîne de formule documentant la règle de type âge et l'observation du vingt-neuf février. Contrôles classiques : embauche le quinze mars deux mille quatorze et as_of le quinze mars deux mille vingt-quatre donnent le numéro dix avec is_anniversary_day vrai ; la veille de ce dixième anniversaire donne neuf avec is_anniversary_day faux ; le jour de l'événement lui-même donne zéro ; et un événement de jour bissextile observé le vingt-huit février une année commune. Le tarif des appels API réussis est la base publiée de $0.002 par élément ; les échecs de validation ne consomment pas le solde prépayé.

Où les calculateurs de numéro d'anniversaire interviennent au travail

Journalistes et lettres d'information internes écrivent « marque dix ans depuis le lancement » et ont besoin du décompte accompli pour un jour as_of précis, pas d'un simple delta de jours. Comme cette capacité est un moteur parse pur, le tarif API est la base publiée de $0.002 par élément réussi et une validation échouée ne consomme pas le solde.

Questions techniques

Comment savoir quel numéro d'anniversaire une date représente ?

Envoyez event_date et as_of comme chaînes ISO YYYY-MM-DD. L'API renvoie anniversary_number comme années pleines accomplies depuis l'événement (style âge), plus anniversary_ordinal tel que 10th, et is_anniversary_day lorsque as_of coïncide avec le jour d'anniversaire observé.

Que se passe-t-il si as_of est antérieur à la date d'événement ?

La tâche échoue avec invalid_input. On ne peut pas calculer un numéro d'anniversaire avant l'événement d'origine, et une entrée invalide n'est pas facturée.

Combien coûte le calculateur de numéro d'anniversaire ?

L'outil navigateur est gratuit. Les requêtes API utilisent le solde prépayé KIT à $0.002 par appel réussi ; une entrée invalide n'est pas facturée.

Consulter la documentation complète du KIT →

Lancer gratuitement

Exemple résolu

Comment le numéro d'anniversaire est calculé à partir de deux dates ISO

Où les calculateurs de numéro d'anniversaire interviennent au travail

Cas d’usage

Listes de récompenses professionnelles et d'ancienneté

Jalons de mariage et personnels

Seuils annuels d'adhésion et de fidélité

Questions fréquentes

Outils associés

Pour les développeurs — accès API

Endpoint

Appeler depuis votre stack

Exemple de requête

Exemple de réponse

Tarifs

Erreurs

Notes techniques

Ce que vous envoyez et ce que vous recevez en retour

Où les calculateurs de numéro d'anniversaire interviennent au travail

Questions techniques

merci