ForHosting KIT · Outils pour développeurs

Jours ouvrés dans une année

Le calculateur de jours ouvrés reçoit une date ISO explicite, détermine son année civile et compte tous les jours du lundi au vendredi.

● BetaGratuit · dans votre navigateur

Lancer gratuitement Voir l’API

Utilisez-le depuis WebAPIE-mailTelegramApp bientôt

Vous pouvez fournir une liste facultative de jours fériés afin de retirer ceux qui tombent en semaine, sans déduire deux fois une date répétée ni un jour férié déjà situé le week-end. Des règles grégoriennes fixes et un calcul déterministe garantissent un résultat identique dans tous les fuseaux horaires.

Sélectionnez l’année avec une date explicite

Saisissez une date au format ISO exact YYYY-MM-DD. La date complète est obligatoire même si seule son année sert au calcul : les requêtes API restent ainsi sans ambiguïté et ne dépendent ni de l’année courante, ni des paramètres régionaux du compte, ni de l’horloge du serveur. Par exemple, 2024-07-25 sélectionne toute l’année civile 2024, du 1er janvier au 31 décembre ; le décompte ne commence pas le 25 juillet. Le résultat indique la date transmise, l’année, le nombre de jours calendaires, les jours de week-end, les jours fériés en semaine et le total final de jours ouvrés. Les années 0001 à 9999 suivent le calendrier grégorien proleptique et sa règle des années bissextiles. Une date inexistante telle que 2025-02-29 est refusée au lieu d’être corrigée silencieusement. Vous disposez ainsi d’un calcul reproductible pour la planification, les audits, les tests et les règles métier archivées.

Excluez correctement week-ends et jours fériés

Tous les samedis et dimanches de l’année choisie sont d’abord exclus. Vous pouvez ensuite transmettre les jours fériés sous forme de liste de dates ISO. Un jour férié ne réduit le total que s’il appartient à l’année sélectionnée et tombe du lundi au vendredi. S’il se situe le week-end, il est déjà exclu et n’est pas soustrait une seconde fois. Les doublons sont également éliminés. Les dates valides d’autres années sont acceptées mais ignorées, ce qui permet d’utiliser une liste couvrant plusieurs années sans filtrage préalable. L’outil n’invente aucun jour férié national, n’applique aucun report automatique et ne déduit pas votre pays. Ces règles dépendent des juridictions, employeurs, conventions et années. Indiquez précisément les dates de fermeture qui concernent votre organisation. Le résultat sépare les week-ends des jours fériés effectifs afin de rendre le total parfaitement explicable.

Intégrez un décompte déterministe à vos prévisions

Le moteur repose exclusivement sur une arithmétique calendaire entière. Il ne consulte aucun service réseau, ne lit pas l’heure actuelle, n’utilise pas l’objet Date de JavaScript et n’applique ni heure d’été ni paramètre régional. UTC fournit donc une interprétation stable : 2026-01-01 conserve le même sens à Tokyo, Londres ou en Californie. Cette propriété convient aux plans annuels de capacité, aux modèles d’effectifs, aux objectifs d’utilisation, aux prévisions de niveau de service et aux estimations de paie. Conservez la date et la liste des jours fériés avec le détail obtenu pour créer un instantané vérifiable et recalculable. Le résultat mesure des journées potentielles du lundi au vendredi, et non les heures réellement effectuées par une personne. Il exclut les congés individuels, temps partiels, fermetures non indiquées, week-ends organisés autrement et demi-journées. Utilisez gratuitement le navigateur ou l’API pour $0.002 dans un processus automatisé.

Cas d’usage

Établir un plan annuel de capacité

Partez des jours disponibles, retirez les fermetures réelles et multipliez le résultat détaillé par la capacité quotidienne de l’équipe.

Contrôler les hypothèses de paie

Comparez le total prévu avec une ventilation déterministe des week-ends et des jours fériés effectivement déduits.

Rendre les prévisions reproductibles

Archivez la date et les jours fériés afin que les calculs futurs appliquent les mêmes règles plutôt que l’horloge courante.

Questions fréquentes

La date marque-t-elle le début du décompte ?

Non. Elle sélectionne toute son année civile, du 1er janvier au 31 décembre inclus.

Quels jours constituent le week-end ?

Le samedi et le dimanche. Aucun autre rythme hebdomadaire de repos n’est déduit.

Que devient un jour férié situé le week-end ?

Il n’est pas soustrait de nouveau, car cette date figure déjà parmi les jours de week-end.

Le calculateur connaît-il les jours fériés nationaux ?

Non. Fournissez les dates exactes qui s’appliquent à votre organisation et à votre juridiction.

Quel est le prix d’une requête API ?

Une requête API coûte $0.002. Le même calcul déterministe est également gratuit 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/date/workdays-in-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/workdays-in-year \
  -H "Authorization: Bearer $KIT_KEY" \
  -H "Content-Type: application/json" \
  -d '{"date":"2024-07-25"}'

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

import os, requests

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

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

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

Exemple de réponse

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