Calculateur de Jours Ouvrables

Un calculateur de jours ouvrés compte le nombre de jours réellement utilisables dans une période après retrait des week-ends et d’un nombre de jours fériés indiqué. Il sert à estimer une livraison, vérifier des congés, préparer une paie, organiser une facturation, suivre un recrutement ou planifier un projet lorsque le nombre de jours calendaires est trop approximatif. Un jour ouvré n’est pas toujours un jour du calendrier : week-end samedi-dimanche ou vendredi-samedi, jours fériés régionaux, fermeture d’entreprise et jours travaillés de compensation peuvent modifier le résultat. L’outil fournit une estimation rapide selon vos paramètres. Pour les RH, le juridique ou les contrats, vérifiez avec le calendrier officiel.

Le comptage des jours ouvrables correspond au nombre de jours calendaires dans la plage inclusive `[début, fin]` qui ne sont ni des jours de week-end ni des jours fériés. La formule standard à borne inclusive est `total_days = (end - start) / 86_400_000 + 1` lorsque les deux bornes sont normalisées à minuit UTC, puis les jours de week-end et fériés sont soustraits. Le jour de la semaine provient de `Date.prototype.getDay()` qui renvoie `0` pour dimanche jusqu'à `6` pour samedi — attention au piège que `getDay()` n'est pas `getDate()` et que le résultat est dans le fuseau horaire local du navigateur, donc une chaîne de date UTC traversant minuit peut atterrir sur un jour de semaine différent de celui attendu. Le modèle de week-end varie selon la région : la valeur par défaut mondiale est samedi-dimanche (Occident, Inde, majeure partie de l'Asie), mais le Moyen-Orient utilisait historiquement jeudi-vendredi et depuis 2024 la plupart des pays du Golfe (EAU, Bahreïn, Koweït, Qatar) se sont alignés sur vendredi-samedi ou même samedi-dimanche avec un demi-vendredi. L'Iran, l'Afghanistan et certaines parties de l'Asie du Sud observent encore uniquement le vendredi ; Israël observe vendredi-samedi. L'outil expose Sam-Dim, Ven-Sam et « aucun » comme les trois préréglages courants, et laisse le comptage de jours fériés couvrir tout le reste par soustraction. L'algorithme de comptage lui-même a deux implémentations pratiques. L'itération naïve parcourt un jour à la fois : `for (let d = start; d <= end; d.setDate(d.getDate()+1)) if (![0,6].includes(d.getDay())) count++`. C'est O(n) en jours calendaires et trivial à lire. L'alternative en forme fermée calcule `full_weeks * 5 + partial_week_workdays` et s'exécute en O(1), ce qui est important pour les plages couvrant plusieurs années. Les jours fériés tombant un week-end ne doivent pas être soustraits deux fois, donc le modèle canonique est de filtrer l'ensemble des fériés avec `holidays.filter(h => !isWeekend(h)).length`. La politique chinoise de 调休 (jours travaillés de compensation) ajoute une complexité que la logique pure basée sur le week-end ne peut pas représenter : le Conseil d'État publie chaque année une liste convertissant certains samedis ou dimaines en jours ouvrables pour compenser les congés prolongés du Nouvel An ou de la Fête nationale, donc pour les calendriers chinois la liste des fériés doit être associée à une liste explicite de « jours travaillés de compensation » plutôt que de se fier uniquement à la règle du jour de la semaine.

• Formule de plage inclusive : `total_days = (end - start) / 86_400_000 + 1` avec les deux dates normalisées à minuit UTC pour éviter la dérive d'heure d'été.
• `Date.prototype.getDay()` renvoie 0 (dim) à 6 (sam) dans le fuseau horaire local du navigateur — pas UTC, donc le code sensible au fuseau doit utiliser `getUTCDay()`.
• Préréglages de week-end : Sam-Dim (Occident, Inde, majeure partie de l'Asie), Ven-Sam (la plupart des états du Golfe depuis 2006-2013), Ven uniquement (Iran), aucun (opérations 24h/24).
• Forme fermée O(1) : `full_weeks * 5 + extra_workdays_in_partial_week` ; préférée à l'itération jour par jour pour les plages pluriannuelles.
• Les jours fériés tombant un week-end ne doivent pas être comptés deux fois : soustraire `holidays.filter(h => !isWeekend(h)).length`, pas le nombre brut de jours fériés.
• Conseil d'État chinois 调休 : certains samedis/dimaines deviennent des jours ouvrables légaux pour compenser les congés prolongés ; nécessite une liste explicite de jours de compensation.
• Les jours fériés fédéraux US (selon 5 U.S.C. § 6103) représentent 11 jours ouvrables par an : Nouvel An, MLK, Presidents, Memorial, Juneteenth, Independence, Labor, Columbus, Veterans, Thanksgiving, Christmas.