ForHosting KIT · Dates et temps

Début et fin de semaine ISO

Saisissez un jour et obtenez le lundi qui ouvre sa semaine ISO et le dimanche qui la ferme : le 3 janvier 2024 se trouve dans la semaine du 1er au 7 janvier 2024. Les deux dates comptent. Gratuit dans votre navigateur.

  • Gratuit
  • Fonctionne dans votre navigateur
  • Sans inscription
  • Vos données restent sur votre appareil
Utilisez-le depuis WebAPIE-mailTelegramApp bientôt
Si vous saisissez
Date
2024-01-03
Vous obtenez
Année
2 024
Mois
1
Jour
3
Jour de la semaine ISO
3

Ce calculateur de début et de fin de semaine ISO prend une seule date du calendrier grégorien au format YYYY-MM-DD et renvoie le lundi qui ouvre la semaine ISO-8601 contenant ce jour ainsi que le dimanche qui la clôt. Les semaines ISO vont toujours du lundi au dimanche et ne dépendent jamais du premier jour de semaine de la locale, ce qui explique pourquoi la paie, les lots de fabrication, les libellés de sprint agile et les reportings transfrontaliers les préfèrent aux semaines de style américain qui commencent le dimanche. Parmi les contrôles classiques : 2024-01-03 correspond à la semaine du 2024-01-01 au 2024-01-07, et 2021-01-01 à la semaine du 2020-12-28 au 2021-01-03 car ce vendredi appartient encore à la semaine 53 de l'année-semaine 2020. Le moteur n'utilise qu'une arithmétique calendaire entière et déterministe : années bissextiles, longueurs de mois, jour de semaine ISO, décalages de numéro de jour julien et règles de frontière du numéro de semaine sont calculés sans appels réseau, sans tirage aléatoire et sans l'horloge hôte.

Ce que signifient le début et la fin d'une semaine ISO et ce que contient la réponse

Les dates de semaine ISO-8601 situent un jour civil dans une fenêtre de sept jours basée sur le lundi, numérotée de 1 à 52 ou 53 dans une année de numérotation de semaine. La semaine 1 est définie comme la semaine contenant le premier jeudi de l'année, ce qui équivaut à la semaine qui contient le 4 janvier.

En raison de cette règle, fin décembre et début janvier peuvent appartenir à une année-semaine différente de l'année civile imprimée sur la facture, et le lundi de début ou le dimanche de fin peuvent se situer dans un mois ou une année calendaire différents du jour saisi.

Si vous avez besoin d'un premier jour de semaine personnalisé, du seul numéro de semaine, ou de la conversion année-semaine plus semaine en date, utilisez ces outils dédiés ; cette page répond uniquement aux bornes de la fenêtre de semaine ISO pour une date calendaire validée.

Comment la date est lue et comment la fenêtre lundi–dimanche reste reproductible

La chaîne doit correspondre à quatre chiffres, un tiret, deux chiffres, un autre tiret et deux chiffres ; les espaces en tête ou en queue sont retirés, mais les dates partielles, le seul jour ordinal de l'année et les noms de mois ne sont pas étendus ici.

Après analyse, l'année doit être entre 1 et 9999, le mois entre 1 et 12, et le jour entre 1 et la vraie longueur de ce mois cette année-là, les années bissextiles suivant la règle grégorienne divisible par quatre sauf les siècles non divisibles par quatre cents.

Le même chemin dérive aussi le numéro de semaine ISO comme le plancher de jour de l'année moins jour de semaine plus dix, le tout divisé par sept, avec ajustement d'année-semaine lorsque la semaine provisoire est inférieure à un ou dépasse le nombre de semaines de l'année civile. Une année a cinquante-trois semaines ISO lorsque son premier ou dernier jour est un jeudi.

Plages de dates pour rapports hebdomadaires

Transformez tout jour de facture ou de journal en bornes inclusives lundi–dimanche ISO pour tableaux de bord, packs retail et rapports d'exploitation.

Fenêtres de semaine aux limites d'année

Résolvez les dates de fin décembre et début janvier dont la semaine ISO commence ou se termine dans une autre année civile avant de clôturer les comptes.

Combien coûte le calculateur de début et fin de semaine ISO ?

Il est gratuit dans votre navigateur sur cette page.

Pourquoi le lundi ou le dimanche peuvent-ils tomber dans un autre mois ou une autre année ?

Les semaines ISO sont des blocs continus de sept jours. Un mercredi début janvier peut encore appartenir à une semaine commencée fin décembre de l'année civile précédente.

Convertit-il les fuseaux horaires ou utilise-t-il l'horloge actuelle ?

Non. Il mappe seulement une date calendaire validée vers des bornes lundi–dimanche de semaine ISO par arithmétique pure. Pas d'objet Date, de décalage de fuseau ni de dépendance à « aujourd'hui ».

Le lundi et le dimanche sont-ils inclus dans la plage ?

Oui. Les deux bornes sont comprises, la plage couvre donc toujours sept jours : pour le 3 janvier 2024, elle va du lundi 1er au dimanche 7 janvier, prête pour un rapport hebdomadaire.

Puis-je faire commencer la semaine le dimanche ?

Non. La semaine ISO va toujours du lundi au dimanche et ce début ne se règle pas, ce qui aligne les rapports de pays différents. Pour des semaines commençant le dimanche, utilisez un outil prévu pour cette convention.

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/iso-week-start-end

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/iso-week-start-end \
  -H "Authorization: Bearer $KIT_KEY" \
  -H "Content-Type: application/json" \
  -d '{"date":"2024-01-03"}'
{
  "date": "2024-01-03"
}
{
  "task_id": "tsk_a1b2c3d4e5f6a1b2c3d4e5f6",
  "type": "date.iso_week_start_end",
  "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.

Utilisez-le gratuitement dans le navigateur pour des feuilles de planification et des contrôles de conformité, ou appelez l'API à $0.002 par requête réussie lorsque vous avez besoin de bornes de fenêtre hebdomadaire reproductibles en CI, pipelines de reporting ou fonctionnalités produit.

Ce que signifient le début et la fin d'une semaine ISO et ce que contient la réponse

Ce calculateur accepte un champ obligatoire, date, sous forme de chaîne stricte YYYY-MM-DD, vérifie que le jour existe réellement dans le calendrier grégorien — y compris le 29 février uniquement les années bissextiles et la longueur correcte de chaque mois — puis renvoie la date normalisée, l'année, le mois et le jour civils, le jour de semaine ISO de 1 pour lundi à 7 pour dimanche avec un nom lisible, le nombre de jours après le lundi pour l'entrée, week_start et week_end comme dates ISO inclusives, le numéro de semaine ISO et l'année-semaine avec une chaîne compacte iso_week_string telle que 2020-W53, le nombre de semaines de cette année-semaine, l'ordinal du jour de l'année, les ancrages de numéro de jour julien pour l'entrée et les extrémités de semaine, length_days égal à sept, et un court rappel de formule. Il n'y a ni conversion de fuseau horaire, ni premier jour de semaine configurable, ni approximation flottante : soit l'entrée est un jour calendaire réel et la paire lundi–dimanche est entièrement déterminée, soit la requête échoue avec invalid_input. Les cas rejetés incluent date manquant, forme incorrecte comme 2024/01/03, mois impossibles, et jours inexistants comme 2023-02-29.

Comment la date est lue et comment la fenêtre lundi–dimanche reste reproductible

Le champ préféré est date, mais les alias iso_date, d et value sont acceptés afin que tableurs, chaînes de requête et formulaires typés réutilisent le même contrat sans renommer les colonnes. À partir du triplet validé, le moteur calcule le jour de semaine ISO via la méthode purement entière de Sakamoto mappée de sorte que lundi vaut un et dimanche sept, convertit le jour civil en numéro de jour julien astronomique avec l'algorithme de Fliegel–Van Flandern, soustrait days_from_monday égal à iso_weekday moins un pour atterrir sur le lundi, et ajoute six jours pour atterrir sur le dimanche. Associez l'exécution gratuite dans le navigateur de cette page à l'API payante lorsque vous avez besoin de la même fenêtre hebdomadaire dans un pipeline automatisé.

Où le début et la fin de semaine ISO s'insèrent dans la planification, le reporting et le logiciel

Les équipes opérations et finance ont besoin du lundi et du dimanche d'une semaine ISO lorsqu'une cadence hebdomadaire doit s'aligner entre des pays qui ne commencent pas tous la semaine le dimanche : plannings de fabrication, packs de vente au détail, libellés de sprint agile et reporting réglementaire citant la semaine de l'année bénéficient d'une fenêtre inclusive sans ambiguïté. Les développeurs appellent le même contrat depuis des scripts pour étiqueter des buckets de journaux, générer des plages par défaut de feuilles de temps, ou produire des vecteurs de test déterministes pour des systèmes de paie qui clôturent le dimanche soir. Les formateurs et rédacteurs de normes utilisent l'outil pour démontrer des dates limites telles que 2005-01-01 dans une semaine commencée en décembre 2004, sans s'appuyer sur des numéros de série de tableur qui diffèrent entre Excel et ISO. Les analystes qui construisent des tableaux de bord d'une année sur l'autre évitent les filtres décalés d'un jour lorsqu'ils stockent à la fois week_start et week_end plutôt qu'un seul numéro de semaine encore à développer en prédicats de date. Sur cette page le travail s'exécute entièrement dans votre navigateur ; via l'API chaque consultation réussie coûte $0.002, une validation en échec n'est pas facturée, et rien n'est stocké après le retour de la réponse. Cette division — exploration interactive gratuite et API payante identique — correspond au reste du catalogue tier A du KIT et vous permet de passer d'un contrôle ponctuel à un pipeline sans changer le résultat mathématique. Associez-le à la consultation du numéro de semaine ISO lorsque vous n'avez besoin que de l'identifiant de semaine, à week_start_end configurable lorsque le premier jour de semaine de la locale importe, et à d'autres aides déterministes gratuites lorsque vous assemblez un petit laboratoire d'utilitaires de date.

Fixtures de test déterministes

Générez des valeurs week_start et week_end reproductibles pour tests unitaires, contrôles de propriétés et assertions de CI sans biais de Date.

Quels jours sont week_start et week_end ?

Selon l'ISO-8601, week_start est toujours le lundi et week_end toujours le dimanche. Il n'y a pas d'option pour commencer la semaine le dimanche ou un autre jour.

Quels formats de date sont acceptés ?

Uniquement des dates calendaires strictes YYYY-MM-DD. Des valeurs comme 2024/01/03, 01-03-2024 ou 2023-02-29 (non bissextile) sont rejetées avec invalid_input.

Consulter la documentation complète du KIT →