ForHosting KIT · Dates et temps

Calculateur du jour de l'année

Le 1er mars 2024 est le 61e jour de l'année ; dans une année ordinaire, ce serait le 60e, car 2024 est bissextile. Saisissez une date pour obtenir son rang dans l'année, la durée de l'année et les jours restants jusqu'au 31 décembre. 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: 2024-03-01

Vous obtenez

Année: 2 024
Mois: 3
Jour: 1
Jour de l'année: 61

Le jour de l'année, parfois appelé date ordinale ou jour julien de l'année, est la position d'un jour civil dans son année en comptant à partir de un le premier janvier jusqu'à trois cent soixante-cinq ou trois cent soixante-six le trente et un décembre. Les ingénieurs, analystes et étudiants ont besoin de cet ordinal pour étiqueter des fichiers journaux, planifier un travail saisonnier, comparer des barres de progression d'objectifs annuels ou convertir entre dates civiles et schémas de numérotation de jours utilisés en science et en aviation. Ce calculateur accepte une seule date de calendrier ISO sous la forme stricte année-mois-jour avec quatre chiffres, deux chiffres et deux chiffres, vérifie que le jour existe vraiment dans le calendrier grégorien y compris les févriers bissextiles, et renvoie l'entier du jour de l'année avec un indicateur bissextile, la longueur de l'année et le nombre de jours restants jusqu'au trente et un décembre. Les dates impossibles telles que le vingt-neuf février d'une année commune ou le trente et un avril échouent avec une erreur de validation claire au lieu d'un ajustement silencieux.

Comment le jour de l'année est calculé à partir d'une date ISO

Partir d'une date de calendrier écrite comme année, mois et jour sous la forme ISO internationale avec tirets et largeurs fixes afin que chaque client s'accorde sur les trois mêmes entiers. Confirmez d'abord que l'année se trouve dans une plage grégorienne pratique et que le mois est entre un et douze.

Appliquez ensuite la règle des années bissextiles utilisée par les calendriers civils du monde entier : une année est bissextile lorsqu'elle est divisible par quatre, sauf que les années séculaires ne sont bissextiles que lorsqu'elles sont aussi divisibles par quatre cents. Cette règle rend légal le vingt-neuf février dans des années comme deux mille vingt-quatre et deux mille, et illégal en deux mille vingt-trois et mil neuf cents.

Avec le statut bissextile connu, consultez la longueur de chaque mois de cette année et rejetez tout jour qui dépasse la longueur du mois, par exemple le trente et un avril ou le trente février. Lorsque le triplet est valide, additionnez les longueurs de tous les mois complets avant le mois donné puis ajoutez le jour du mois.

La somme est l'ordinal du jour de l'année : le premier janvier est toujours un, le premier mars est soixante et un en année bissextile et soixante en année commune, et le trente et un décembre est trois cent soixante-six ou trois cent soixante-cinq.

Où les calculateurs de jour de l'année interviennent au travail

Les équipes d'exploitation tamponnent souvent les lots et les partitions d'entrepôt avec des numéros de jour de l'année afin que les dossiers annuels se trient chronologiquement sans clés de date multi-champs. Les carnets climat et agriculture tracent des séries contre le jour de l'année pour aligner les saisons multi-années même lorsque des jours bissextiles apparaissent. Les chefs de projet suivent les objectifs annuels comme fraction de l'année en divisant l'ordinal courant par trois cent soixante-cinq ou trois cent soixante-six.

Les logiciels qui doivent rester libres de bibliothèques de fuseaux horaires ont encore besoin d'un ordinal de calendrier pur pour les compteurs de progression, les fenêtres de maintenance et les calendriers de conformité définis par des dates civiles plutôt que des époques Unix.

Si vous avez ensuite besoin du décompte des jours ouvrables entre deux dates, de l'âge depuis une date de naissance, des numéros de jour julien complets ou de la numérotation de semaine de l'année selon ISO huit mille six cent un, traitez-les comme des intentions de recherche et des pages d'atterrissage distinctes plutôt que de surcharger cette page de calculateur du jour de l'année.

Cas d’usage

Alignement scientifique et saisonnier

Projetez des séries climatiques ou agricoles multi-années sur un axe partagé 1–366, en décalant correctement mars et la suite après les jours bissextiles.

Questions fréquentes

Qu'est-ce que le jour de l'année ?

C'est la position ordinale d'un jour de calendrier dans son année : 1 pour le 1er janvier, jusqu'à 365 en année commune ou 366 en année bissextile pour le 31 décembre.

Gère-t-il les années bissextiles ?

Oui. Les règles bissextiles grégoriennes s'appliquent : divisible par 4, sauf que les siècles doivent être divisibles par 400. Le 29 février n'est accepté qu'en années bissextiles et décale les mois suivants d'un jour.

Quel format de date est exigé ?

ISO strict YYYY-MM-DD avec année à quatre chiffres et mois et jour à deux chiffres. Des valeurs comme 2024-3-1 ou 2024/03/01 sont rejetées pour que chaque client s'accorde sur la même chaîne.

Que se passe-t-il avec une date invalide comme 2023-02-29 ?

Le message d'erreur explique que le jour n'est pas valide pour cette année et ce mois.

Combien cela coûte-t-il ?

L'outil du navigateur est gratuit et s'exécute en local.

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

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

import os, requests

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

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

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

Exemple de réponse

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

Notes techniques

Comment le jour de l'année est calculé à partir d'une date ISO

Tout le pipeline est de l'arithmétique entière déterministe sans graines aléatoires, sans horodatages d'horloge, sans objet Date JavaScript et sans appels réseau, de sorte que des entrées identiques produisent toujours le même JSON.

Ce que vous envoyez et ce que vous recevez en retour

Envoyez un champ chaîne obligatoire nommé date contenant un jour de calendrier ISO strict tel que deux mille vingt-quatre tiret zéro trois tiret zéro un. Les jours qui correspondent au motif mais ne sont pas de vraies dates de calendrier, y compris le vingt-neuf février non bissextile et les valeurs de mois hors de un à douze, échouent aussi avec un message qui nomme le problème afin que les clients puissent corriger l'entrée sans deviner. Les contrôles classiques incluent le premier janvier mappé à un, le trente et un décembre mappé à la longueur complète de l'année, et le premier mars décalé d'un jour entre années bissextiles et communes. Les champs manquants, les valeurs non chaînes et les chaînes qui ne correspondent pas au motif de chiffres quatre-deux-deux échouent avec invalid_input et ne sont pas facturés. En cas de succès la réponse renvoie la chaîne de date normalisée, les composants numériques année, mois et jour, l'entier day_of_year de un à trois cent soixante-cinq ou trois cent soixante-six, un booléen is_leap_year, days_in_year comme trois cent soixante-cinq ou trois cent soixante-six, remaining_days jusqu'au dernier jour de cette année, et une courte chaîne formula qui documente la règle bissextile. 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 jour de l'année interviennent au travail

Comme cette capacité est un moteur de parse pur, le tarif API est la base publiée de $0.002 par élément réussi et l'échec de validation ne consomme pas le solde.

Cas d'intégration

Suivi de progression et d'objectifs annuels

Convertissez la date ISO du jour en day_of_year et remaining_days pour que les tableaux de bord affichent le pourcentage d'année écoulée sans dépendre des fuseaux horaires de l'hôte.

Étiquettes de lots et partitions de journaux

Tamponnez fichiers et partitions d'entrepôt avec un numéro ordinal stable dérivé d'entrées strictes YYYY-MM-DD et un invalid_input clair sur les mauvaises dates.

Consulter la documentation complète du KIT →

Lancer gratuitement

Exemple résolu

Comment le jour de l'année est calculé à partir d'une date ISO

Où les calculateurs de jour de l'année interviennent au travail

Cas d’usage

Alignement scientifique et saisonnier

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

Comment le jour de l'année est calculé à partir d'une date ISO

Ce que vous envoyez et ce que vous recevez en retour

Où les calculateurs de jour de l'année interviennent au travail

Cas d'intégration

Suivi de progression et d'objectifs annuels

Étiquettes de lots et partitions de journaux

merci