Convertisseur de date ordinale ISO
Le 15 mars 2024 est le 75e jour de l'année, noté 2024-075 en date ordinale ISO. Convertissez n'importe quelle date en numéro de jour de l'année et inversement, années bissextiles comprises. Gratuit dans votre navigateur.
- Gratuit
- Fonctionne dans votre navigateur
- Sans inscription
- Vos données restent sur votre appareil
Lancer gratuitement
Exemple résolu
- Date
- 2024-03-15
- Année
- 2 024
- Mois
- 3
- Jour
- 15
- Jour de l'année
- 75
La norme ISO 8601 définit deux formes de date civile qui partagent la même année mais expriment le jour différemment : le triplet calendaire classique année-mois-jour, et la forme ordinale, année suivie du numéro du jour dans l'année, de 1 à 365 ou 366. Les pipelines qui stockent des numéros de jour séquentiels, les jeux de données scientifiques, les manifestes logistiques et les journaux de conformité ont souvent besoin d'un pont sans perte entre ces deux représentations, sans dépendre des objets Date du langage hôte ni des caprices des fuseaux horaires.
Forme calendaire, forme ordinale et cas d'usage de chaque sens
Une date calendaire ISO s'écrit avec l'année sur quatre chiffres, le mois et le jour sur deux chiffres, séparés par des tirets, par exemple 2024-03-15 pour le 15 mars. Une date ordinale ISO reprend la même année, un tiret, puis un numéro de jour sur trois chiffres allant de 001 le 1er janvier à 365 pour une année commune ou 366 pour une année bissextile grégorienne.
Convertissez du calendaire vers l'ordinal lorsque vous avez besoin d'un indice de jour compact pour une année, de noms de fichiers séquentiels ou d'analyses qui traitent chaque jour comme un axe entier. Convertissez de l'ordinal vers le calendaire lorsqu'un flux ne fournit que le jour de l'année alors que votre interface, votre facture ou votre validateur attend le mois et le jour.
Années bissextiles, durée de l'année et erreurs de jour ordinal
Selon les règles grégoriennes, une année est bissextile lorsqu'elle est divisible par quatre, sauf que les années séculaires doivent aussi être divisibles par quatre cents. Les années bissextiles comptent 366 jours et un février de 29 jours ; les années communes comptent 365 jours et un février de 28 jours. C'est pourquoi l'an 2000 est bissextile, 1900 ne l'est pas, et 2024 est bissextile alors que 2023 ne l'est pas.
Les dates calendaires avec un jour impossible pour le mois, comme le 31 avril ou le 29 février d'une année non bissextile, sont rejetées de la même façon.
Cas d’usage
Indices de jour pour la science et les capteurs
Les pipelines de recherche stockent les échantillons sous la forme année plus jour de l'année ; convertissez-les en dates calendaires pour les rapports et revenez à la forme ordinale pour des archives compactes, sans dérive liée à l'objet Date de l'hôte.
Logistique et nommage des fichiers par lots
Entrepôts et traitements par lots nomment les fichiers avec des séquences YYYY-DDD et ont besoin d'un pont fiable vers des étiquettes YYYY-MM-DD lisibles dans les interfaces et les factures.
Validation des flux ordinaux
Les intégrations qui reçoivent un jour de l'année de leurs partenaires rejettent les valeurs débordantes, comme le jour 366 d'une année non bissextile, avant qu'elles n'entrent dans les systèmes de facturation ou de planification.
Questions fréquentes
Que se passe-t-il si le jour ordinal dépasse la durée de l'année ?
Par exemple, le jour 366 d'une année non bissextile, ou tout jour supérieur à 366, est rejeté et n'est pas facturé.
Le convertisseur de date ordinale ISO est-il gratuit ?
L'outil du navigateur fonctionne gratuitement sur votre appareil.
Quelle est la date ordinale du 15 mars 2024 ?
C'est 2024-075, car le 15 mars est le 75e jour de 2024. L'année vient d'abord, puis un compte sur trois chiffres qui commence à 001 le 1er janvier.
Pourquoi une année bissextile change-t-elle le numéro des jours après février ?
Une année bissextile ajoute le 29 février, si bien que chaque date à partir du 1er mars reçoit un numéro supérieur d'une unité à celui d'une année ordinaire. C'est aussi pourquoi le compte s'arrête à 366 et non à 365.
Peut-on retrouver une date normale à partir d'un numéro de jour ?
Oui. Saisissez l'année et le numéro du jour, par exemple 2024-075, et vous obtenez le mois et le jour, ici le 15 mars 2024. Un numéro supérieur à la durée de l'année est refusé.
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
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/ordinal-date \
-H "Authorization: Bearer $KIT_KEY" \
-H "Content-Type: application/json" \
-d '{"date":"2024-03-15","calendar":"valor-ejemplo"}'const res = await fetch("https://api.kit.forhosting.com/date/ordinal-date", {
method: "POST",
headers: {
"Authorization": `Bearer ${process.env.KIT_KEY}`,
"Content-Type": "application/json"
},
body: JSON.stringify({
"date": "2024-03-15",
"calendar": "valor-ejemplo"
})
});
const { task_id } = await res.json();import os, requests
res = requests.post(
"https://api.kit.forhosting.com/date/ordinal-date",
headers={"Authorization": f"Bearer {os.environ['KIT_KEY']}"},
json={
"date": "2024-03-15",
"calendar": "valor-ejemplo"
},
)
task_id = res.json()["task_id"]<?php
$res = file_get_contents("https://api.kit.forhosting.com/date/ordinal-date", false, stream_context_create([
"http" => [
"method" => "POST",
"header" => "Authorization: Bearer " . getenv("KIT_KEY") . "\r\nContent-Type: application/json",
"content" => '{"date":"2024-03-15","calendar":"valor-ejemplo"}',
],
]));
$task = json_decode($res, true);body := bytes.NewBufferString(`{"date":"2024-03-15","calendar":"valor-ejemplo"}`)
req, _ := http.NewRequest("POST", "https://api.kit.forhosting.com/date/ordinal-date", 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-03-15",
"calendar": "valor-ejemplo"
}Exemple de réponse
{
"task_id": "tsk_a1b2c3d4e5f6a1b2c3d4e5f6",
"type": "date.ordinal_date",
"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
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
Ce convertisseur de date ordinale ISO fait correspondre YYYY-MM-DD à YYYY-DDD, et inversement, grâce à une arithmétique grégorienne déterministe des années bissextiles ; il rejette les numéros de jour qui dépassent la durée réelle de l'année et renvoie les deux représentations plus des champs structurés dans une seule charge JSON.
Forme calendaire, forme ordinale et cas d'usage de chaque sens
Envoyez indifféremment une chaîne de date, une chaîne ordinale, année plus mois plus jour, ou année plus day_of_year ; les alias tels que calendar_date, ordinal_date, doy et ddd sont acceptés lorsqu'ils sont documentés. Ne mélangez pas des modes opposés dans une même requête : le moteur rejette les charges ambiguës avec invalid_input, afin que l'appelant corrige le corps au lieu de deviner quel champ l'emporte. Des entrées identiques produisent toujours un JSON identique, car le traitement ne lit jamais l'horloge, la locale ni le réseau.
Années bissextiles, durée de l'année et erreurs de jour ordinal
Lors de la conversion de l'ordinal vers le calendaire, tout jour de l'année inférieur à 1 ou supérieur à la durée de l'année échoue avec invalid_input et un message précisant le nombre réel de jours de cette année — par exemple, le jour 366 de 2023 dépasse la durée de l'année. La réponse renvoie is_leap_year et days_in_year afin que vos tableaux de bord affichent les faits de l'année sans second appel.
Utilisation de l'API, tarification, flux de travail et limites pratiques
Appelez le convertisseur gratuit dans le navigateur pour vérifier des devoirs, faire des démonstrations de saisie et contrôler rapidement des dates sans installer de bibliothèque de calendrier. Associez ce point d'accès aux outils de durée des mois lorsque vous n'avez besoin que de la longueur de février, ou aux formateurs lorsque l'étape suivante est l'affichage localisé d'une date calendaire déjà normalisée. Les bornes d'année suivent la plage de paramètres publiée, pour la sécurité de l'isolate et la compatibilité avec l'outillage civil ISO courant. Envoyez un corps JSON avec un mode clair : date au format YYYY-MM-DD, ordinal au format YYYY-DDD, année mois jour structurés, ou année et day_of_year structurés. En cas de succès, la charge inclut calendar_date, ordinal_date, les composants numériques, direction égal à to_ordinal ou to_calendar, calendar égal à gregorian et method égal à iso_ordinal_date, pour les routeurs et les tests qui branchent sur ces étiquettes. Utilisez l'API prépayée lorsqu'une plateforme logistique, un pipeline scientifique, une archive de conformité ou un SDK exige un contrat stable sous solde KIT à $0.002 par élément réussi ; les échecs de validation ne consomment jamais de solde, car le moteur rejette la requête avant facturation.
Questions techniques
Comment convertir YYYY-MM-DD en date ordinale ISO ?
Envoyez un JSON avec date renseigné par une chaîne calendaire comme 2024-03-15, ou envoyez year, month et day. La réponse inclut ordinal_date au format YYYY-DDD et day_of_year sous forme d'entier.
Comment reconvertir YYYY-DDD en date calendaire ?
Envoyez ordinal sous la forme 2024-075, ou year plus day_of_year. La réponse renvoie calendar_date au format YYYY-MM-DD avec le mois et le jour renseignés.
L'outil utilise-t-il l'objet Date de JavaScript ou les fuseaux horaires ?
Non. La conversion repose sur une arithmétique grégorienne pure des années bissextiles et des longueurs de mois cumulées ; les résultats sont donc identiques dans tous les environnements et sûrs pour les tests golden.