ForHosting KIT · Dates et temps

Jours écoulés dans l'année

Au 15 mars 2024, 74 jours entiers de l'année se sont écoulés, ce qui en fait le 75e jour d'une année bissextile. Saisissez une date pour voir combien de jours ont passé depuis le 1er janvier, qui compte pour zéro. 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-15

Vous obtenez

Année: 2 024
Mois: 3
Jour: 15
Jour de l'année: 75

Ce calculateur de jours écoulés dans l'année prend une date calendaire grégorienne au format strict AAAA-MM-JJ et renvoie le nombre de jours entiers déjà passés depuis le 1er janvier de cette même année. Parmi les vérifications classiques : 2024-01-01 donne zéro jour écoulé, 2024-03-15 donne soixante-quatorze jours lors d'une année bissextile, et 2023-12-31 donne trois cent soixante-quatre jours lors d'une année commune. Le moteur utilise uniquement une arithmétique grégorienne proleptique déterministe : il vérifie que le jour existe réellement sur le calendrier, additionne les longueurs des mois précédant le mois donné, ajoute le jour du mois, puis soustrait un afin que le 1er janvier soit zéro plutôt que un. Il n'y a aucun appel réseau, aucun échantillonnage aléatoire, et aucune dépendance à l'horloge hôte ou à l'objet Date.

Ce que signifient les jours écoulés et ce que contient la réponse

Les jours écoulés depuis le 1er janvier répondent à une question différente du jour ordinal de l'année que l'on imprime parfois de un à trois cent soixante-six, de la distance en jours entiers entre deux dates arbitraires, et des calculateurs de jours ouvrés ou d'âge. Ici, l'horloge de l'année démarre à zéro le 1er janvier : au 15 mars d'une année bissextile, soixante-quatorze jours entiers se sont déjà écoulés, et le jour calendaire lui-même est le jour numéro soixante-quinze de l'année.

Si vous avez besoin de la distance entre deux dates, des numéros de semaine ISO, de la navigation par soustraction de jours, ou de l'analyse multi-format, utilisez ces outils dédiés ; cette page ne répond qu'au nombre de jours entiers passés depuis le 1er janvier de l'année contenant la date donnée.

Où l'arithmétique de progression annuelle s'inscrit dans la planification, le reporting et le logiciel

Les équipes d'exploitation et de produit mesurent les jours écoulés dans l'année lorsqu'un tableau de bord affiche la progression cumulée depuis le début de l'année, lorsqu'une politique fait référence au Nième jour calendaire après le Nouvel An, ou lorsqu'une fenêtre de conservation ou de reporting est définie par rapport au 1er janvier plutôt qu'à une horloge en direct.

Les analystes construisant des cohortes annuelles utilisent le même nombre pour étiqueter des positions d'observation à l'intérieur d'une année sans erreurs de décalage d'un jour en fin de mois et lors des jours bissextiles qui apparaissent lorsqu'on soustrait à la main des numéros de série de tableur.

Les développeurs appellent le contrat depuis des scripts pour générer des vecteurs de test déterministes pour des barres de progression, pour vérifier des champs de jour-de-l'année dans des charges utiles analytiques, ou pour satisfaire des exigences produit demandant un décalage calendaire pur sans dérive de fuseau horaire provenant de l'objet Date de l'hôte.

Enseignants et rédacteurs de normes utilisent l'outil pour démontrer que 2024-02-29 est le jour soixante d'une année bissextile alors que cette même longueur de février n'existe pas en 2023, sans dépendre d'applications de calcul opaques qui incluent silencieusement des heures de la journée. Associez-le aux jours entre deux dates, aux auxiliaires de semaine ISO, ou à la conversion d'époque lorsque vous avez besoin de pas calendaires apparentés, et aux autres outils déterministes gratuits pour bâtir un petit laboratoire d'utilitaires de date.

Cas d’usage

Affichages de progression cumulée annuelle

Montrez combien de jours calendaires entiers se sont écoulés depuis le 1er janvier pour des tableaux de bord, des chronologies d'OKR et des barres de progression annuelle sans dérive de fuseau horaire.

Vérifications du jour-de-l'année bissextile

Vérifiez les positions ordinales et écoulées qui traversent le 29 février uniquement les années bissextiles, y compris le 31 décembre à 364 ou 365 jours écoulés.

Questions fréquentes

Combien coûte le calculateur de jours écoulés dans l'année ?

Il est gratuit dans votre navigateur sur cette page.

Que se passe-t-il avec les années bissextiles et les dates invalides ?

Les longueurs de mois et les jours bissextiles sont vérifiés.

Est-ce la même chose que les jours entre deux dates ?

Non. Cet outil ne mesure que la distance depuis le 1er janvier de la même année. Pour une paire de dates arbitraire, utilisez le calculateur de jours entre deux dates.

Les heures de la journée ou les fuseaux horaires sont-ils inclus ?

Non. Cet outil ne compte que des jours calendaires grégoriens purs. Il n'analyse ni les heures, ni les décalages, ni l'horloge hôte.

Pourquoi le 1er janvier compte-t-il pour zéro ?

Parce que le décompte montre des jours achevés, et le 1er janvier aucun n'est encore terminé. Le numéro du jour de la date est toujours supérieur d'un : le 31 décembre 2023, 364 jours se sont écoulés.

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

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

import os, requests

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

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

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

Exemple de réponse

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

Limites

`year_min`	1
`year_max`	9999

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 que signifient les jours écoulés et ce que contient la réponse

Vous fournissez une seule date sous forme de chaîne stricte AAAA-MM-JJ ; le calculateur vérifie que le jour est un jour calendaire grégorien réel — le 29 février uniquement les années bissextiles, trente jours en avril, jamais le trente-deux — puis renvoie la chaîne date normalisée, les composantes year, month et day, day_of_year comme ordinal de base un, days_elapsed comme day_of_year moins un, is_leap sous forme booléenne, days_in_year comme trois cent soixante-cinq ou trois cent soixante-six, et un court rappel de formule. Il n'y a aucun début de semaine dépendant de la locale, aucune approximation flottante d'une longueur de jour, et aucune dépendance à l'objet Date de l'hôte : soit l'entrée est un jour calendaire réel à l'intérieur de la fenêtre d'année prise en charge et le compte écoulé est entièrement déterminé, soit la requête échoue avec invalid_input. Les cas rejetés incluent un champ date manquant, des formats erronés tels que 2024/03/15, des mois impossibles, des jours inexistants tels que 2023-02-29, et des années hors de un à 9999.

Comment la date est lue et comment le décompte reste reproductible

La chaîne doit correspondre à quatre chiffres, un trait d'union, deux chiffres, un autre trait d'union, et deux chiffres ; les espaces en début ou fin sont supprimés, mais les dates partielles, le jour de l'année ordinal seul, les noms de mois, et les heures intégrées ne sont pas développés ici. Après analyse, l'année doit être comprise entre 1 et 9999, le mois entre 1 et 12, et le jour entre 1 et la véritable longueur de ce mois cette année-là, les années bissextiles suivant la règle grégorienne : divisible par quatre sauf les années séculaires non divisibles par quatre cents. Le champ privilégié est date, mais les alias iso_date, d, value et day sont acceptés afin que tableurs, chaînes de requête et formulaires typés puissent réutiliser le même contrat sans renommer de colonnes. En interne, le moteur additionne les jours de chaque mois complet précédant le mois donné, ajoute le jour du mois pour obtenir day_of_year, puis fixe days_elapsed à day_of_year moins un — une arithmétique entière pure et stable au bit près d'un environnement d'exécution à l'autre. Le 1er janvier donne toujours zéro écoulé et day_of_year un ; le 31 décembre donne trois cent soixante-quatre écoulés lors d'une année commune et trois cent soixante-cinq lors d'une année bissextile. Associez l'exécution gratuite dans le navigateur de cette page à l'API payante lorsque vous avez besoin du même nombre de jours écoulés au sein d'un pipeline automatisé.

Où l'arithmétique de progression annuelle s'inscrit dans la planification, le reporting et le logiciel

Sur cette page, le travail s'exécute entièrement dans votre navigateur ; via l'API, chaque recherche réussie coûte $0.002, une validation échouée n'est pas facturée, et rien n'est conservé après le renvoi de la réponse. Cette séparation — exploration interactive gratuite et API payante identique — s'inscrit dans le reste du catalogue de niveau A du KIT et permet de passer d'une vérification ponctuelle à un pipeline sans changer le résultat mathématique.

Cas d'intégration

Fixtures de test déterministes

Générez des nombres days_elapsed et day_of_year reproductibles pour tests unitaires, vérifications de propriétés et assertions CI, sans dépendre de Date.

Questions techniques

Comment days_elapsed est-il défini ?

days_elapsed est day_of_year moins un. Le 1er janvier donne 0 ; le 2 janvier donne 1. day_of_year est l'ordinal de base un (1 le 1er janvier).

Consulter la documentation complète du KIT →

Lancer gratuitement

Exemple résolu

Ce que signifient les jours écoulés et ce que contient la réponse

Où l'arithmétique de progression annuelle s'inscrit dans la planification, le reporting et le logiciel

Cas d’usage

Affichages de progression cumulée annuelle

Vérifications du jour-de-l'année bissextile

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

Limites

Erreurs

Notes techniques

Ce que signifient les jours écoulés et ce que contient la réponse

Comment la date est lue et comment le décompte reste reproductible

Où l'arithmétique de progression annuelle s'inscrit dans la planification, le reporting et le logiciel

Cas d'intégration

Fixtures de test déterministes

Questions techniques

merci