ForHosting KIT · Dates et temps

Numéro de semaine ISO 8601

Saisissez une date pour obtenir son numéro de semaine ISO 8601 et son année-semaine : le 25 juillet 2026 tombe en semaine 30, notée 2026-W30. Les semaines vont du lundi au dimanche et la semaine 1 contient le premier jeudi de l'année. Gratuit dans votre navigateur.

Gratuit
Fonctionne dans votre navigateur
Sans inscription
Vos données restent sur votre appareil

Lancer gratuitement Voir l’API

Utilisez-le depuis WebAPIE-mailTelegramApp bientôt

Exemple résolu

Si vous saisissez

Date: 2026-07-25

Vous obtenez

Semaine: 30
Année de la semaine: 2 026
Semaine ISO: 2026-W30
Jour de la semaine: 6

Contrairement aux semaines de style américain, qui commencent souvent le dimanche et ne débordent pas sur une autre année, une semaine ISO commence toujours le lundi, et la semaine 1 est celle qui contient le premier jeudi de l’année grégorienne. Cette règle implique que fin décembre et début janvier peuvent appartenir à une année-semaine ISO différente de l’année civile imprimée sur la date. Cette capacité prend une chaîne de date ISO, l’interprète comme jour civil UTC et renvoie le numéro de semaine (1–53), l’année-semaine ISO, une étiquette compacte YYYY-Www et le jour de la semaine — de façon déterministe, sans deviner le fuseau horaire.

Ce qu’un numéro de semaine ISO signifie réellement

On dit souvent « numéro de semaine » pour trois choses distinctes : la semaine ordinale de l’année civile à partir du 1er janvier, la semaine du mois (première à cinquième dans un mois), ou la semaine ISO 8601 définie par la norme internationale. Seule la dernière est stable dans les pays qui suivent les calendriers ISO. Selon ISO 8601, chaque semaine compte sept jours du lundi au dimanche.

La semaine 1 de l’année Y est celle qui inclut le premier jeudi de Y — équivalent à la semaine qui contient le 4 janvier. Une année peut donc avoir 52 ou 53 semaines ISO. Lorsqu’il y en a 53, les 29, 30 ou 31 décembre peuvent encore être en semaine 53 de cette année ISO, et les 1–3 janvier de l’année civile suivante peuvent encore appartenir à la semaine 52 ou 53 de l’année-semaine ISO précédente.

Confondre l’année civile et l’année-semaine est le bug le plus fréquent dans les aides de date artisanales, les tableaux de bord et les rapports SQL. Ce point de terminaison isole cette règle pour que les appelants obtiennent une seule réponse auditée au lieu de résultats divergents issus de bibliothèques dépendantes de la locale.

Contrat d’entrée et évaluation uniquement en UTC

Envoyez un champ obligatoire, date, sous forme de chaîne ISO-8601. La forme préférée est YYYY-MM-DD (par exemple 2026-07-25). Un datetime complet avec heure et suffixe de zone optionnel est accepté, mais seul le jour civil est utilisé après analyse de la chaîne ; le calcul s’exécute toujours sur ce jour civil à minuit UTC.

Les valeurs manquantes ou non chaînes échouent aussi à la validation et ne sont pas facturées.

Cas d’usage

Analytique hebdomadaire et agrégats de KPI

Regroupez les événements par semaine ISO et année-semaine pour que le trafic de décembre et janvier tombe dans la bonne semaine de reporting, pas dans la mauvaise année civile.

Calendriers de paie et de fabrication

Étiquetez feuilles de temps, équipes et lots de production avec des numéros de semaine ISO alignés sur les systèmes européens et de planification ISO.

Questions fréquentes

Qu’est-ce que le numéro de semaine ISO 8601 ?

C’est l’index de semaine de 1 à 53 défini par ISO 8601 : les semaines commencent le lundi et la semaine 1 est celle qui contient le premier jeudi de l’année (ou, de façon équivalente, le 4 janvier).

Le calcul est-il en heure locale ou en UTC ?

UTC uniquement. La date est traitée comme jour civil UTC (YYYY-MM-DD). Les suffixes d’heure optionnels sont ignorés pour le calcul de semaine afin que les résultats restent déterministes entre fuseaux.

Pourquoi les premiers jours de janvier peuvent-ils appartenir à la semaine de l'année précédente ?

Parce que la semaine ISO appartient à une année-semaine qui peut différer de l'année civile. Du 1er au 3 janvier, les jours peuvent encore tomber en semaine 52 ou 53 de l'année ISO précédente.

Combien de semaines ISO compte une année ?

Elle en compte 52 ou 53. La semaine 1 est celle qui contient le 4 janvier : les années de 53 semaines, le 29, le 30 ou le 31 décembre peuvent encore se trouver en semaine 53.

Puis-je saisir une date avec une heure ?

Oui. Une date avec heure, même avec un fuseau, est acceptée, mais seul le jour du calendrier est utilisé. La semaine est toujours calculée sur ce jour à minuit UTC.

Outils associés

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/week-number

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/week-number \
  -H "Authorization: Bearer $KIT_KEY" \
  -H "Content-Type: application/json" \
  -d '{"date":"2026-07-25"}'

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

import os, requests

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

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

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

Exemple de réponse

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

Notes techniques

La numérotation des semaines ISO 8601 est la norme utilisée dans les rapports européens, les calendriers de paie, la planification industrielle et de nombreuses API.

Contrat d’entrée et évaluation uniquement en UTC

Les dates impossibles telles que 2026-02-30 sont rejetées avec invalid_input plutôt que d’être avancées par l’implémentation hôte de Date. La réponse inclut la date normalisée, week (1–53), week_year (l’année-semaine ISO, qui peut différer de l’année grégorienne près des frontières), iso_week sous la forme compacte 2026-W30, plus weekday (lundi=1 … dimanche=7) et weekday_name pour la lisibilité.

Où les pipelines utilisent le numéro de semaine et comment appeler

Les KPI hebdomadaires, tableaux de sprint, rapports fiscaux suivant les semaines ISO, créneaux logistiques étiquetés par semaine et jobs d’enrichissement CSV ont tous besoin d’un index de semaine fiable. Respectez le contrat UTC : si vous avez besoin de minuuits locaux dans une autre zone, convertissez d’abord en date civile locale, puis passez ce YYYY-MM-DD ici pour que le calcul de semaine reste pur et reproductible. Utilisez l’outil gratuit du navigateur pour des contrôles ponctuels, ou l’API prépayée lorsque vous normalisez des milliers de lignes : chaque élément réussi est facturé au tarif de base publié de $0.002, et l’entrée invalide est gratuite. Associez cette capacité à la normalisation de dates lorsque vos données sources sont désordonnées, puis mappez chaque jour ISO nettoyé vers week et week_year avant le regroupement.

Cas d'intégration

Enrichissement CSV et entrepôt de données

Ajoutez les colonnes week et iso_week aux exportations pour que les outils BI regroupent les lignes sans réimplémenter les règles ISO en dialectes SQL.

Questions techniques

Pourquoi week_year peut-il différer de l’année civile ?

Près du Nouvel An, des jours de fin décembre ou début janvier peuvent appartenir à l’année-semaine ISO précédente ou suivante. Le jeudi de cette semaine décide de l’année-semaine, non l’année grégorienne du jour lui-même.

Quels formats de date sont acceptés ?

YYYY-MM-DD est préféré. Les datetimes ISO complets sont acceptés s’ils commencent par une date de calendrier valide ; les dates impossibles et les valeurs manquantes renvoient invalid_input.

Combien coûte l’API de numéro de semaine ISO ?

L’outil navigateur est gratuit. Les appels API réussis utilisent le solde prépayé au prix de base publié de $0.002 par élément ; l’entrée invalide n’est pas facturée.

Consulter la documentation complète du KIT →

Lancer gratuitement

Exemple résolu

Ce qu’un numéro de semaine ISO signifie réellement

Contrat d’entrée et évaluation uniquement en UTC

Cas d’usage

Analytique hebdomadaire et agrégats de KPI

Calendriers de paie et de fabrication

Questions fréquentes

Outils associés

Pour les développeurs — accès API

Endpoint

Appeler depuis votre stack

Exemple de requête

Exemple de réponse

Tarifs

Erreurs

Notes techniques

Contrat d’entrée et évaluation uniquement en UTC

Où les pipelines utilisent le numéro de semaine et comment appeler

Cas d'intégration

Enrichissement CSV et entrepôt de données

Questions techniques

merci