ForHosting KIT · Outils pour développeurs

Calcul des jours ouvrés

Cet outil compte les jours ouvrés entre deux dates, ou ajoute un délai en jours ouvrés à une date de départ, en excluant les week-ends et les jours fériés français. Utile pour calculer une échéance de paiement, un préavis ou un délai de rétractation. Le calcul se fait dans votre navigateur.

● StableGratuit · dans votre navigateur

Lancer gratuitement Voir l’API

Utilisez-le depuis WebAPIE-mailApp bientôtTelegram bientôt

Jours ouvrés, jours ouvrables : ne pas confondre

Le français distingue deux notions. Les jours ouvrables couvrent en principe toute la semaine sauf le dimanche et les jours fériés — souvent six jours. Les jours ouvrés sont ceux réellement travaillés, généralement du lundi au vendredi, soit cinq jours. Un délai « en jours ouvrés » et « en jours ouvrables » ne tombe pas à la même date. L’outil raisonne en jours ouvrés, la base la plus courante des échéances commerciales.

Les jours fériés français intégrés

Un calcul de délai qui oublierait le 14 juillet ou le lundi de Pâques serait faux. L’outil connaît les jours fériés français et les retire du décompte. Attention toutefois : certains, comme le lundi de Pentecôte, ont un statut particulier selon les entreprises. Pour un engagement contractuel, il reste prudent de vérifier le calendrier précis retenu par les deux parties avant de s’engager.

Compter, ou ajouter un délai

Deux besoins reviennent. Compter combien de jours ouvrés séparent deux dates — pour mesurer un délai de traitement, par exemple. Ou ajouter un nombre de jours ouvrés à une date de départ pour trouver l’échéance : « à trente jours ouvrés », une facture arrive à un jour précis, week-ends et fériés déduits. L’outil fait les deux, dans un sens comme dans l’autre, sans calcul manuel.

Des usages très concrets

Échéance d’une facture, préavis de départ d’un logement, délai de rétractation, date limite d’une démarche administrative : tous se comptent souvent en jours ouvrés. Se tromper d’un ou deux jours peut coûter des pénalités ou faire manquer une date limite. Un calcul fiable, jours fériés compris, sécurise ces échéances du quotidien professionnel comme personnel. D’où l’intérêt d’un calcul posé une fois pour toutes, plutôt que compté à la main sur un calendrier mural.

Calcul local, sans envoi

Vos dates ne quittent pas votre navigateur : le calcul s’exécute sur cette page, sans transmission ni conservation. Pour intégrer le calcul des jours ouvrés à une application de gestion ou de facturation via l’API, chaque requête coûte $0.002, en dollars US ; l’usage manuel reste gratuit et illimité. Le web mène le calcul ; l’API n’est qu’une option pour l’automatiser, sans que vos dates ne quittent votre poste.

Cas d’usage

Fixer l’échéance d’une facture

L’Atelier Garnier SARL facture « à 30 jours ouvrés » : l’outil donne la date exacte, week-ends et jours fériés déduits, à inscrire sur la facture.

Calculer un préavis de logement

Élodie Garnier compte les jours ouvrés jusqu’à la fin de son préavis pour savoir quand remettre les clés à son propriétaire.

Vérifier un délai de rétractation

Camille Moreau contrôle qu’un délai légal exprimé en jours ouvrés se termine bien à la date qu’elle pensait, sans se tromper d’un jour férié.

Questions fréquentes

Quelle différence entre jours ouvrés et ouvrables ?

Les jours ouvrés sont les jours travaillés, en général du lundi au vendredi, soit cinq par semaine. Les jours ouvrables incluent le samedi, soit six, sauf dimanche et fériés. Un même délai ne tombe pas à la même date selon la notion retenue.

Les jours fériés français sont-ils pris en compte ?

Oui, ils sont retirés du décompte. Notez que certains, comme le lundi de Pentecôte, varient selon les entreprises ; pour un engagement contractuel, confirmez le calendrier convenu entre les parties.

Puis-je ajouter un délai à une date ?

Oui. Indiquez une date de départ et un nombre de jours ouvrés, l’outil renvoie l’échéance, week-ends et fériés déduits. Il compte aussi, dans l’autre sens, les jours ouvrés entre deux dates.

Le samedi est-il compté ?

Non, pas dans un calcul en jours ouvrés, qui s’arrête au vendredi. Si votre besoin porte sur les jours ouvrables, le samedi entre en compte : distinguez bien les deux avant de calculer une échéance.

Mes dates sont-elles envoyées quelque part ?

Non. Le calcul se fait dans votre navigateur, sans transmission ni enregistrement de vos dates.

Est-ce gratuit ?

Oui, sans limite dans le navigateur. Pour intégrer le calcul à une application via l’API, le tarif est de $0.002 par requête, en dollars US.

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/dev/business-days

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/dev/business-days \
  -H "Authorization: Bearer $KIT_KEY" \
  -H "Content-Type: application/json" \
  -d &#39;{"items":["valor-1","valor-2"]}'

const res = await fetch("https://api.kit.forhosting.com/dev/business-days", {
  method: "POST",
  headers: {
    "Authorization": `Bearer ${process.env.KIT_KEY}`,
    "Content-Type": "application/json"
  },
  body: JSON.stringify({
    "items": [
      "valor-1",
      "valor-2"
    ]
  })
});
const { task_id } = await res.json();

import os, requests

res = requests.post(
    "https://api.kit.forhosting.com/dev/business-days",
    headers={"Authorization": f"Bearer {os.environ[&#39;KIT_KEY']}"},
    json={
    "items": [
        "valor-1",
        "valor-2"
    ]
},
)
task_id = res.json()["task_id"]

<?php
$res = file_get_contents("https://api.kit.forhosting.com/dev/business-days", false, stream_context_create([
  "http" => [
    "method"  => "POST",
    "header"  => "Authorization: Bearer " . getenv("KIT_KEY") . "\r\nContent-Type: application/json",
    "content" => &#39;{"items":["valor-1","valor-2"]}',
  ],
]));
$task = json_decode($res, true);

body := bytes.NewBufferString(`{"items":["valor-1","valor-2"]}`)
req, _ := http.NewRequest("POST", "https://api.kit.forhosting.com/dev/business-days", 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

{
  "items": [
    "valor-1",
    "valor-2"
  ]
}

Exemple de réponse

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

Lancer gratuitement