ForHosting KIT · Outils pour développeurs

Calculateur de week-ends jusqu’à une date

Le calculateur de week-ends jusqu’à une date dénombre les paires samedi–dimanche entièrement comprises dans l’intervalle inclusif entre une date de référence et une date cible.

● BetaGratuit · dans votre navigateur
Utilisez-le depuis WebAPIE-mailTelegramApp bientôt

Tout se passe dans votre navigateur : gratuit, sans envoi de vos données.

Vous obtenez ainsi une réponse pratique qui écarte les week-ends partiels. Saisissez deux dates grégoriennes au format YYYY-MM-DD : l’outil accepte une cible passée ou future, précise la direction, indique la durée calendaire inclusive et fournit un résultat reproductible.

Définition d’un week-end complet

Ce calculateur définit un week-end comme le samedi et le dimanche consécutifs qui suivent la semaine de travail habituelle du lundi au vendredi. Il ne le comptabilise que si ces deux dates appartiennent à l’intervalle inclusif formé par la référence et la cible. Ainsi, une période qui s’achève un samedi n’inclut pas ce week-end, puisque son dimanche se trouve hors de la période. De même, une période qui commence un dimanche exclut la paire précédente. En revanche, un intervalle allant du samedi au dimanche contient exactement un week-end complet. Cette règle de frontière évite de présenter une période de repos partielle comme deux journées entièrement disponibles. Les vendredis, jours fériés, célébrations locales et autres conventions régionales ne sont pas pris en compte. Les deux dates limites sont incluses lors du contrôle. Le résultat répond donc précisément à la question suivante : combien de paires samedi–dimanche complètes se trouvent entièrement entre ces deux dates calendaires ?

Saisie des dates et lecture du résultat

Indiquez la date de référence et la date cible au format strict YYYY-MM-DD, avec quatre chiffres pour l’année et deux pour le mois et le jour. Le calculateur valide les dates réelles du calendrier grégorien : une valeur impossible comme le 30 février est rejetée au lieu d’être discrètement reportée au mois suivant. La cible peut être postérieure, antérieure ou identique à la référence. Le décompte est symétrique : inverser les mêmes bornes ne modifie pas le nombre de week-ends complets. Le champ de direction précise si la cible se situe dans le futur, dans le passé ou le même jour par rapport à la référence fournie. Le nombre inclusif de jours calendaires est également renvoyé pour faciliter toute vérification. Aucune date actuelle n’est supposée. Pour un compte à rebours depuis aujourd’hui, saisissez explicitement la date du jour comme référence afin qu’une requête enregistrée reste compréhensible et reproductible ultérieurement.

Exploiter le décompte dans un planning concret

Le nombre de week-ends complets constitue un indicateur de planification concis, à associer toutefois aux contraintes propres à l’activité. Pour un voyage, chaque paire comptée représente un samedi et un dimanche entièrement compris dans la fenêtre ; les déplacements du vendredi soir ou du lundi matin n’entrent pas dans cette mesure. Pour un projet, ce nombre peut estimer les sessions de travail ininterrompues ou les périodes de récupération disponibles avant une échéance, mais il ne les convertit pas en heures ouvrées. Pour un événement, il facilite la comparaison cohérente de plusieurs périodes lorsqu’une option commence ou s’achève au milieu d’un week-end. L’algorithme n’utilise que des valeurs calendaires, sans fuseau horaire, heure, changement saisonnier, réseau ni date actuelle de l’appareil. Une même saisie produit donc le même résultat dans le navigateur et par API. Une requête API coûte $0.002, tandis que le calculateur du navigateur exécute gratuitement la même logique déterministe.

Planifier la période d’un voyage

Déterminez combien de paires samedi–dimanche complètes tiennent entre les dates de réservation, de départ ou de retour.

Estimer les week-ends d’un projet

Comptez les week-ends complets disponibles avant un lancement, une remise, des travaux ou un examen.

Comparer des périodes d’événement

Évaluez plusieurs créneaux sans confondre un samedi ou un dimanche en limite de période avec un week-end complet.

Les dates de référence et cible sont-elles incluses ?

Oui. Les deux bornes appartiennent à l’intervalle, mais le week-end ne compte que si le samedi et le dimanche y figurent.

Que se passe-t-il si la date cible est antérieure ?

Le calculateur examine le même intervalle et indique une direction passée. Inverser les bornes ne change pas le total.

Une période terminant un samedi compte-t-elle ce week-end ?

Non. Le dimanche suivant est hors de l’intervalle ; cette paire ne constitue donc pas un week-end complet.

Les jours fériés ou habitudes régionales sont-ils inclus ?

Non. Un week-end désigne strictement le samedi et le dimanche ; les jours fériés et autres jours chômés régionaux sont exclus.

Le fuseau horaire ou l’heure d’été modifie-t-il le résultat ?

Non. Le calcul repose uniquement sur des dates calendaires, sans heure, fuseau horaire ni changement d’heure saisonnier.

Combien coûte une requête API ?

Chaque requête API coûte $0.002. La version dans le navigateur exécute gratuitement le même calcul déterministe.

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.

POSThttps://api.kit.forhosting.com/date/weekends-until

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é.

curl -X POST https://api.kit.forhosting.com/date/weekends-until \
  -H "Authorization: Bearer $KIT_KEY" \
  -H "Content-Type: application/json" \
  -d '{"reference_date":"2026-08-12","target_date":"2026-09-07"}'
{
  "reference_date": "2026-08-12",
  "target_date": "2026-09-07"
}
{
  "task_id": "tsk_a1b2c3d4e5f6a1b2c3d4e5f6",
  "type": "date.weekends_until",
  "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.

par requête$0.002

Le prix est publié, sans tokens ni crédits. Une tâche qui échoue n’est pas facturée.

HTTPCodeSignification
401unauthorizedClé API absente ou invalide : vérifiez l’en-tête Authorization.
402insufficient_balanceSolde insuffisant : rechargez votre compte pour lancer cette tâche.
404unknown_typeType de tâche inconnu : vérifiez le champ type de votre requête.
429rate_limitedTrop de requêtes : ralentissez la cadence, puis réessayez.

Consulter la documentation complète du KIT →