N° de semaine É.-U.
Calculez le numéro de semaine américain de n'importe quelle date, avec des semaines du dimanche au samedi et une semaine 1 qui contient le 1er janvier : le 15 mars 2024 tombe en semaine 11. Vous voyez aussi le nombre de semaines de l'année. Gratuit dans votre navigateur.
- Gratuit
- Fonctionne dans votre navigateur
- Sans inscription
- Vos données restent sur votre appareil
Lancer gratuitement
Exemple résolu
- Date
- 2024-03-15
- Année
- 2 024
- Mois
- 3
- Jour
- 15
- Jour de l'année
- 75
Aux États-Unis, de nombreux calendriers, systèmes de paie, planificateurs scolaires et modèles de tableur numérotent les semaines de sorte que chacune commence le dimanche et que la semaine un soit simplement celle qui contient le premier janvier. Cette règle diffère du système de date de semaine ISO 8601, qui démarre les semaines le lundi et définit la semaine un comme celle qui contient le premier jeudi de l'année. Lorsqu'un planning, un rapport ou une piste d'audit doit correspondre aux numéros de semaine américains plutôt qu'ISO, un petit convertisseur déterministe évite les bizarreries du Date de l'hôte et la dérive de locale.
Règles de semaine É.-U. face aux semaines ISO, et comment envoyer une date
Selon la convention américaine utilisée ici, une semaine commence toujours le dimanche et se termine le samedi. La semaine un d'une année est celle qui inclut le premier janvier, même si cette semaine a commencé en décembre de l'année précédente sur le calendrier mural. Les semaines suivantes se comptent comme des blocs complets de dimanche à samedi jusqu'au trente et un décembre, qui peut tomber en semaine cinquante-deux ou cinquante-trois selon où est tombé le premier janvier et si l'année est bissextile.
Les semaines ISO 8601 sont différentes : elles commencent le lundi, et la semaine un est celle du premier jeudi de l'année, de sorte que le même jour civil peut correspondre à un indice de semaine distinct.
Comment le numéro est calculé et à quoi ressemblent les dates invalides
Le moteur valide d'abord le jour du calendrier grégorien, en appliquant les règles d'année bissextile de sorte que février ait vingt-neuf jours seulement lorsque l'année est divisible par quatre, sauf que les années séculaires doivent aussi être divisibles par quatre cents. Il calcule ensuite le jour de l'année à partir des longueurs cumulées des mois et le jour de la semaine de la date avec une arithmétique entière, sans utiliser d'objet Date de l'hôte.
Le numéro de semaine É.-U. égale le plancher de jour-de-l'année moins un plus le jour de la semaine du premier janvier, le tout divisé par sept, plus un, où le dimanche est le jour de la semaine zéro. Cette formule place le premier janvier en semaine un et avance d'un à chaque dimanche suivant. Les chaînes mal formées qui ne sont pas une année à quatre chiffres, un mois à deux chiffres et un jour à deux chiffres séparés par des tirets sont également rejetées.
Cas d’usage
Paie et rapports de semaine de travail É.-U.
Les pipelines RH et paie qui regroupent les heures par semaines commençant le dimanche étiquettent chaque période de paie avec le numéro de semaine É.-U. contenant la date de travail, aligné sur les attentes courantes de WEEKNUM en tableur.
Calendriers scolaires et planification commerce
Les calendriers de districts et plans de merchandising numérotent souvent les semaines avec le 1er janvier en semaine 1 ; convertissez les dates ISO vers cet index pour diapositives, digests e-mail et fenêtres de stock.
Questions fréquentes
Est-ce le même que le numéro de semaine ISO ?
Non. Les semaines ISO commencent le lundi et définissent la semaine 1 par la règle du premier jeudi. La même date civile peut donner un index différent sous les règles ISO.
Que se passe-t-il si la date est invalide ?
Exemples : format YYYY-MM-DD incorrect, 30 février, ou 29 février en année non bissextile. L'échec de validation n'est pas facturé.
Une année peut-elle compter 53 semaines ?
Oui. Le 31 décembre tombe en semaine cinquante-deux ou 53, selon le jour de la semaine du 1er janvier et selon que l'année est bissextile. En 2024, par exemple, la dernière semaine est la 53.
La semaine 1 peut-elle commencer en décembre ?
Oui. La semaine 1 est celle du dimanche au samedi qui contient le 1er janvier : si ce jour tombe en milieu de semaine, elle a commencé dans les derniers jours de décembre de l'année précédente.
Les semaines commencent-elles le dimanche ou le lundi ?
Le dimanche. Chaque semaine américaine va du dimanche au samedi, contrairement aux semaines ISO, qui commencent le lundi et dont la semaine 1 contient le premier jeudi de l'année.
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
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/us-week-number \
-H "Authorization: Bearer $KIT_KEY" \
-H "Content-Type: application/json" \
-d '{"date":"2024-03-15","calendar":"valor-ejemplo"}'const res = await fetch("https://api.kit.forhosting.com/date/us-week-number", {
method: "POST",
headers: {
"Authorization": `Bearer ${process.env.KIT_KEY}`,
"Content-Type": "application/json"
},
body: JSON.stringify({
"date": "2024-03-15",
"calendar": "valor-ejemplo"
})
});
const { task_id } = await res.json();import os, requests
res = requests.post(
"https://api.kit.forhosting.com/date/us-week-number",
headers={"Authorization": f"Bearer {os.environ['KIT_KEY']}"},
json={
"date": "2024-03-15",
"calendar": "valor-ejemplo"
},
)
task_id = res.json()["task_id"]<?php
$res = file_get_contents("https://api.kit.forhosting.com/date/us-week-number", false, stream_context_create([
"http" => [
"method" => "POST",
"header" => "Authorization: Bearer " . getenv("KIT_KEY") . "\r\nContent-Type: application/json",
"content" => '{"date":"2024-03-15","calendar":"valor-ejemplo"}',
],
]));
$task = json_decode($res, true);body := bytes.NewBufferString(`{"date":"2024-03-15","calendar":"valor-ejemplo"}`)
req, _ := http.NewRequest("POST", "https://api.kit.forhosting.com/date/us-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": "2024-03-15",
"calendar": "valor-ejemplo"
}Exemple de réponse
{
"task_id": "tsk_a1b2c3d4e5f6a1b2c3d4e5f6",
"type": "date.us_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
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
Ce calculateur de numéro de semaine É.-U. accepte une date de calendrier ISO, applique l'arithmétique bissextile grégorienne et une formule pure de jour de la semaine, et renvoie l'indice de semaine avec les faits de jour de la semaine et d'année en JSON stable.
Règles de semaine É.-U. face aux semaines ISO, et comment envoyer une date
Envoyez une chaîne de date au format YYYY-MM-DD, ou les champs structurés year, month et day ensemble. Des alias tels que calendar, calendar_date et iso_date sont acceptés pour le chemin chaîne. Une entrée structurée partielle sans les trois parties est rejetée avec invalid_input afin que l'appelant corrige le corps au lieu de deviner les valeurs manquantes. Des entrées identiques produisent toujours un JSON identique car le chemin ne lit jamais l'horloge murale, la locale ni le réseau.
Comment le numéro est calculé et à quoi ressemblent les dates invalides
Les dates impossibles comme le trente et un avril, le trente février ou le vingt-neuf février en année non bissextile échouent avec invalid_input et un message indiquant la vraie longueur du mois. La réponse renvoie week_starts égal à Sunday, week_1_rule égal à contains_january_1, et weeks_in_year égal à la semaine É.-U. du trente et un décembre afin que les tableaux de bord montrent la plage annuelle sans second appel.
Utilisation de l'API, tarifs, flux de travail et limites pratiques
Appelez le calculateur gratuit de numéro de semaine É.-U. dans le navigateur pour les devoirs, démos de planification et vérifications rapides sans installer de bibliothèques de calendrier. Associez ce point de terminaison aux outils d'ordinal ISO ou de jours dans le mois lorsque vous avez besoin d'index de jour ou de la longueur de février, mais n'attendez pas que l'indice de semaine coïncide avec les étiquettes de semaine-date ISO. Les bornes d'année suivent la plage de paramètres publiée pour la sécurité d'isolement. Envoyez un corps JSON avec date en YYYY-MM-DD, ou avec year, month et day comme entiers dans les plages publiées. En cas de succès, la charge utile inclut la date normalisée, les composants structurés, day_of_year, day_of_week de zéro pour dimanche à six pour samedi avec un nom en anglais, week_number, weeks_in_year, is_leap_year, calendar égal à gregorian, et method égal à us_week_number pour les routeurs et tests qui branchent sur les étiquettes. Utilisez l'API prépayée lorsqu'un export de paie, un calendrier scolaire, un outil de planification commerce ou un SDK a besoin d'un contrat stable sous solde KIT à $0.002 par élément réussi ; les échecs de validation ne consomment jamais le solde après rejet par le moteur.
Cas d'intégration
Parité tableur dans les APIs
Les services qui doivent correspondre aux numéros de semaine basés sur le dimanche d'Excel ou Google Sheets exposent un champ JSON stable au lieu de réimplémenter le calcul du jour de la semaine dans chaque langage client.
Questions techniques
Comment obtenir le numéro de semaine É.-U. d'une date ?
Envoyez un JSON avec date égal à une chaîne ISO telle que 2024-03-15, ou year, month et day. La réponse inclut week_number et day_of_week_name.
Les semaines commencent-elles le dimanche ou le lundi ?
Le dimanche. Ce calculateur suit la convention É.-U. : week_starts est toujours Sunday, et la semaine 1 est celle qui contient le 1er janvier.
Le calculateur de numéro de semaine É.-U. est-il gratuit ?
L'outil navigateur s'exécute gratuitement sur votre appareil. Les appels API utilisent le solde KIT prépayé à $0.002 par élément réussi ; les échecs de validation ne sont pas facturés.