ForHosting KIT · Outils pour développeurs

Calculateur du jour de l’année à partir d’une date

Ce calculateur convertit une date civile en sa position ordinale dans l’année. Saisissez une date au format YYYY-MM-DD pour obtenir un entier de 1 à 365, ou jusqu’à 366 lors d’une année bissextile.

● BetaGratuit · dans votre navigateur

Lancer gratuitement Voir l’API

Utilisez-le depuis WebAPIE-mailTelegramApp bientôt

Le calcul applique les règles grégoriennes, vérifie le nombre réel de jours de chaque mois et refuse les dates impossibles au lieu de les rectifier silencieusement. Il convient lorsqu’une date lisible doit devenir un indice annuel compact.

Convertissez une date en nombre ordinal

Le jour de l’année indique combien de jours civils se sont écoulés du 1er janvier à la date demandée, en comptant le 1er janvier comme jour 1. Saisissez quatre chiffres pour l’année, deux pour le mois et deux pour le jour, séparés par des tirets. Une date de début janvier produit un petit nombre, tandis qu’une date de fin décembre donne une valeur proche de 365 ou 366. Le résultat contient un seul entier day_of_year, simple à conserver, comparer ou transmettre. Le format est volontairement strict : années abrégées, éléments réordonnés, horodatages et formes régionales sont refusés, car leur interprétation varie selon les systèmes. Le calendrier grégorien est utilisé pour les années 0001 à 9999. Ni l’horloge du serveur, ni le fuseau horaire, ni l’heure d’été, ni la date actuelle n’interviennent ; une même entrée produit donc toujours la même sortie.

Prise en compte des années bissextiles et des mois

Le nombre ordinal résulte de l’addition des durées complètes des mois précédents et du jour demandé. Seule la durée de février varie. Selon les règles grégoriennes, une année divisible par quatre est généralement bissextile, mais une année séculaire ne l’est que si elle est aussi divisible par quatre cents. Ainsi, 2024 et 2000 possèdent un 29 février, contrairement à 1900 et 2100. Cette différence affecte toutes les dates ultérieures : le 1er mars correspond au jour 61 d’une année bissextile et au jour 60 d’une année commune. La validation applique ces règles avant le calcul. Le 31 avril, le 30 février, le jour zéro, le treizième mois ou le 29 février d’une année commune déclenchent une erreur. Une date invalide n’est jamais reportée sur le mois suivant, ce qui empêche un ordinal apparemment crédible de masquer une donnée source incorrecte.

Exploitez le résultat dans les données et la planification

Les jours ordinaux sont pratiques lorsque la position dans l’année compte davantage que les limites des mois. Ils permettent de regrouper des observations environnementales par saison, d’identifier une journée de production ou de créer une séquence annuelle cohérente pour des graphiques. La valeur facilite aussi les comparaisons au sein d’une même année, mais elle ne doit pas remplacer la date d’origine si plusieurs années sont concernées : le jour 32 revient chaque année. Conservez donc l’année avec l’ordinal dès qu’une identification ou un classement traverse le changement d’année. Pour les événements récurrents, les années bissextiles décalent les ordinaux après le 28 février ; un anniversaire fixe peut ainsi changer de numéro. Inversement, un ordinal fixe peut désigner une autre date près de février. L’API coûte $0.002 par requête ; la version navigateur exécute localement le même calcul déterministe, sans réseau, localisation ni réglage horaire.

Cas d’usage

Indexer des observations annuelles

Convertissez des relevés météorologiques, agricoles ou de laboratoire en position annuelle cohérente pour l’analyse saisonnière.

Valider les étiquettes de production

Comparez l’ordinal employé en fabrication, logistique ou suivi de lots avec la date civile d’origine.

Préparer les dates pour les rapports

Ajoutez le jour de l’année aux jeux de données et graphiques sans dépendre des paramètres régionaux ou horaires d’un tableur.

Questions fréquentes

Quelle plage le résultat peut-il couvrir ?

Le résultat va de 1 à 365 lors d’une année commune et de 1 à 366 lors d’une année bissextile.

Quel format de date est accepté ?

Utilisez exactement YYYY-MM-DD, avec un zéro initial pour les mois et jours à un chiffre.

Comment les années bissextiles sont-elles déterminées ?

Les années divisibles par quatre sont bissextiles, sauf les années séculaires qui doivent aussi être divisibles par quatre cents.

Que se passe-t-il si la date est invalide ?

La requête renvoie une erreur de saisie invalide pour les formats incorrects et les dates impossibles.

Le calcul dépend-il d’un fuseau horaire ?

Non. Il effectue directement l’arithmétique calendaire sans convertir la date en horodatage.

Quel est le coût d’une requête API ?

Chaque requête API coûte $0.002. Le même calcul peut aussi être exécuté localement dans le navigateur.

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/astro/day-of-year

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/astro/day-of-year \
  -H "Authorization: Bearer $KIT_KEY" \
  -H "Content-Type: application/json" \
  -d '{"date":"2024-12-31"}'

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

import os, requests

res = requests.post(
    "https://api.kit.forhosting.com/astro/day-of-year",
    headers={"Authorization": f"Bearer {os.environ['KIT_KEY']}"},
    json={
    "date": "2024-12-31"
},
)
task_id = res.json()["task_id"]

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

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

{
  "date": "2024-12-31"
}

Exemple de réponse

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