N° de semaine avec 1er jour au choix

Utilisez-le gratuitement dans le navigateur pour des tableaux de planification et des calendriers par région, ou appelez l’API à $0.002 par requête réussie lorsque vos pipelines exigent toujours le même libellé de semaine.

Qu’est-ce qu’un numéro de semaine à début personnalisé et que contient la réponse

Vous passez date comme chaîne stricte YYYY-MM-DD et first_weekday optionnel comme nom anglais (sunday à saturday) ou un entier de zéro pour dimanche à six pour samedi ; si first_weekday est omis, le lundi est supposé. Après validation, la réponse renvoie la date normalisée, l’année civile, le mois et le jour, l’ordinal day_of_year, le jour de la semaine de l’entrée en minuscules et en Title Case plus un index basé sur zéro, first_weekday et first_weekday_index résolus, le nombre de jours qui séparent la date du début de sa semaine, week_number à partir de un, weeks_in_year comme numéro de semaine du 31 décembre sous le même jour de début, week_1_rule égal à contains_january_1, des indicateurs d’année bissextile et de calendrier, une balise method et une courte chaîne de formule pour la documentation. Il n’y a ni conversion de fuseau horaire ni dépendance à « aujourd’hui » : soit les entrées forment un jour de calendrier réel et un premier jour légal, soit la requête échoue avec invalid_input. Les cas rejetés incluent une date manquante, des formes comme 2024/03/15, des mois impossibles, le 29 février hors année bissextile et des jetons de jour inconnus.

Comment la date et le premier jour sont lus pour des résultats reproductibles

La chaîne doit correspondre à quatre chiffres, un tiret, deux chiffres, un autre tiret et deux chiffres ; les espaces en tête et en queue sont tronqués, mais les dates partielles, les noms de mois et le seul ordinal du jour de l’année ne sont pas développés ici. 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 siècles non divisibles par quatre cents). Le champ de date préféré est date, mais les alias iso_date, d, value et calendar sont acceptés afin que tableurs, chaînes de requête et formulaires réutilisent le contrat sans renommer les colonnes. Le champ first_weekday accepte des noms ou des indices numériques et a les alias week_start, start_day et first_day ; les valeurs vides ou omises valent lundi par défaut pour qu’un début de style ISO reste à un geste sans imposer la règle d’année-semaine ISO. À partir du triplet validé, le moteur calcule day_of_year en sommant les longueurs de mois avec ajustement de février bissextile, puis les jours de la semaine de la date d’entrée et du 1er janvier via la méthode entière de Sakamoto (dimanche zéro, samedi six). Le décalage du 1er janvier dans la semaine personnalisée est (jour du 1er janvier moins first_weekday plus sept) modulo sept ; le numéro de semaine est le plancher de day_of_year moins un plus ce décalage, le tout divisé par sept, puis plus un. Le numéro de semaine du 31 décembre sous le même début est renvoyé comme weeks_in_year afin que les tableaux de bord sachent si l’année va jusqu’à 52, 53 ou 54 libellés pour cette configuration. Associez l’exécution gratuite du navigateur sur cette page à l’API tarifée lorsque vous avez besoin du même libellé de semaine dans un pipeline automatisé.

Où les numéros de semaine à début personnalisé s’intègrent planification et logiciels

Les analystes qui construisent des tableaux année sur année peuvent stocker week_number avec first_weekday_index pour que les filtres restent non ambigus lorsque deux régions divergent sur le début de semaine. Sur cette page le travail s’exécute entièrement dans votre navigateur ; via l’API chaque recherche réussie coûte $0.002, une validation échouée n’est pas facturée et rien n’est stocké après la réponse. Ce partage—exploration interactive gratuite et API identique tarifée—correspond au reste du catalogue KIT de niveau A et vous permet de passer d’un contrôle ponctuel à un pipeline sans changer le résultat mathématique.