ForHosting KIT · Dates et temps

Avancement de l'année en %

Le 1er juillet 2024 marque exactement 50 % de l'année : c'est le jour 183 sur 366, et il en reste 183. Saisissez une date pour alimenter une barre de progression, un suivi d'objectifs annuels ou un plan saisonnier. 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-07-01

Vous obtenez

Année: 2 024
Mois: 7
Jour: 1
Jour de l'année: 183

L'avancement de l'année est la part d'une année civile déjà écoulée à une date civile donnée, exprimée en pourcentage depuis juste au-dessus de zéro le premier janvier jusqu'à cent le trente et un décembre. Tableaux de bord produit, suiveurs d'objectifs annuels, calendriers marketing saisonniers et outils de productivité personnelle ont besoin de ce nombre sans combattre les fuseaux de l'hôte ni les tables d'heure d'été. Ce calculateur accepte une seule date calendaire ISO au format strict année-mois-jour avec quatre, deux et deux chiffres, vérifie que le jour existe vraiment sur le calendrier grégorien — y compris les févriers bissextiles —, calcule l'ordinal du jour de l'année et renvoie le pourcentage égal à cent fois cet ordinal divisé par trois cent soixante-cinq ou trois cent soixante-six. La réponse inclut aussi les jours restants, le pourcentage restant, un indicateur bissextile et la longueur de l'année pour que barres de progression et comptes à rebours restent cohérents. Des dates impossibles comme le 29 février d'une année commune ou le 31 avril échouent avec une erreur de validation claire au lieu d'un ajustement silencieux.

Comment le pourcentage d'avancement de l'année est calculé depuis une date ISO

Partez d'une date calendaire écrite en année, mois et jour au format ISO international avec tirets et largeurs fixes pour que tout client s'accorde sur les trois mêmes entiers. Confirmez d'abord que l'année se situe dans une plage grégorienne pratique et que le mois est entre un et douze. Appliquez ensuite la règle bissextile des calendriers civils mondiaux : une année est bissextile si 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 légal le 29 février en 2024 et 2000, et illégal en 2023 et 1900. 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 31 avril ou le 30 février. Lorsque le triple est valide, additionnez les longueurs de chaque mois complet avant le mois donné puis ajoutez le jour du mois pour obtenir 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. Le pourcentage d'avancement de l'année est défini comme cent multiplié par le jour de l'année divisé par la longueur de l'année, de sorte que le dernier jour de l'année est exactement cent pour cent et les jours antérieurs s'échelonnent linéairement.

Les jours restants valent la longueur de l'année moins le jour de l'année, et le pourcentage restant est la fraction complémentaire multipliée par cent.

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

Les équipes produit et croissance tracent des barres de progression annuelles pour OKR, objectifs de revenus et calendriers de contenu et ont besoin d'un pourcentage de confiance qui suit les dates civiles plutôt que des fractions d'epoch Unix qui ignorent les jours bissextiles. RH et finance suivent politiques de congés, fenêtres de reporting fiscal et échéances de formation comme part de l'année pour que les tableaux de bord restent lisibles aux non-ingénieurs.

Le marketing planifie des campagnes saisonnières en demandant quel pourcentage de l'année est déjà passé quand une date de lancement est fixée. Un logiciel qui doit rester libre de bibliothèques de fuseaux a encore besoin d'un pourcentage calendaire pur pour fenêtres de maintenance, calendriers de conformité et widgets de productivité personnelle définis par dates civiles.

Si vous avez ensuite besoin seulement de l'ordinal du jour de l'année sans pourcentage, de jours ouvrables entre deux dates, d'âge depuis une date de naissance, de numéros de jour julien complets ou de numérotation de semaine de l'année sous ISO 8601, traitez-les comme des intentions de recherche et des pages distinctes plutôt que de surcharger cette page de pourcentage d'avancement de l'année.

Cas d’usage

Tableaux de bord OKR et objectifs annuels

Convertissez toute date ISO en pourcentage d'année écoulée pour que barres de progression et libellés de pourcentage restant restent sensibles aux bissextiles sans fuseaux de l'hôte.

Calendriers marketing saisonniers

Associez les dates de lancement de campagnes aux pourcentages d'avancement de l'année pour supports de planification et déclencheurs saisonniers automatisés.

Questions fréquentes

Une année bissextile change-t-elle le pourcentage ?

Oui. Les années bissextiles ont 366 jours, donc le même mois-jour après février se mappe à un pourcentage différent qu'en année commune. Le 29 février n'est accepté qu'en années bissextiles.

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

Forme incorrecte, mois hors plage ou jours impossibles comme 2023-02-29 sont rejetés et non facturés.

Est-ce la même chose que le jour de l'année ?

Non. Le jour de l'année renvoie l'ordinal 1–366. Cette capacité renvoie le pourcentage écoulé de l'année (et le restant), une intention de recherche différente bien que les deux utilisent le calcul calendaire.

Quel est le coût ?

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

Comment le pourcentage d'avancement de l'année est-il calculé ?

Le rang du jour dans l'année est divisé par le nombre de jours de cette année, 365 ou 366, puis multiplié par 100. C'est pourquoi le 31 décembre donne toujours exactement 100 %.

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/year-progress

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

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

import os, requests

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

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

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

Exemple de réponse

{
  "task_id": "tsk_a1b2c3d4e5f6a1b2c3d4e5f6",
  "type": "date.year_progress",
  "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 pourcentage d'avancement de l'année est calculé depuis une date ISO

Tout le pipeline est une arithmétique entière et flottante déterministe sans graines aléatoires, sans horodatages d'horloge murale, 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

Envoyez un champ chaîne obligatoire nommé date contenant un jour calendaire ISO strict tel que 2024-07-01. Les jours qui correspondent au motif mais ne sont pas de vraies dates calendaires — y compris le 29 février non bissextile et les mois hors de un à douze — échouent aussi avec un message qui nomme le problème pour que les clients corrigent l'entrée sans deviner. Les contrôles classiques incluent le premier janvier près de zéro virgule vingt-sept pour cent en année commune, le premier juillet près de la mi-année avec un décalage d'un jour entre années bissextiles et communes, et le trente et un décembre exactement cent pour cent. Champs manquants, valeurs non chaîne et chaînes qui ne correspondent pas au motif quatre-deux-deux chiffres é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, percent comme la fraction d'année écoulée multipliée par cent, remaining_percent comme la fraction complémentaire multipliée par cent, et une courte chaîne formula documentant la règle bissextile et la définition du pourcentage. Le prix 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 d'avancement de l'année interviennent au travail

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

Cas d'intégration

Conformité et suivi des congés

Tamponnez les politiques annuelles avec un pourcentage stable et remaining_days depuis des entrées YYYY-MM-DD strictes, avec invalid_input clair sur les mauvaises dates.

Questions techniques

Comment le pourcentage d'avancement de l'année est-il calculé ?

percent = 100 × day_of_year / days_in_year, où day_of_year est l'ordinal base 1 de la date ISO et days_in_year vaut 365 ou 366 sous les règles bissextiles grégoriennes. Le 31 décembre est toujours exactement 100%.

Consulter la documentation complète du KIT →

Lancer gratuitement

Exemple résolu

Comment le pourcentage d'avancement de l'année est calculé depuis une date ISO

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

Cas d’usage

Tableaux de bord OKR et objectifs annuels

Calendriers marketing saisonniers

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 pourcentage d'avancement de l'année est calculé depuis une date ISO

Ce que vous envoyez et ce que vous recevez

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

Cas d'intégration

Conformité et suivi des congés

Questions techniques

merci