ForHosting KIT · Dates et temps

Jour de la semaine du premier du mois depuis une date ISO

Saisissez n'importe quel jour et découvrez le jour de la semaine où son mois a commencé : le 13 août 2026 renvoie au 1er août 2026, un samedi. Vous obtenez aussi le numéro ISO du jour et un indice depuis le dimanche pour vos calendriers. 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-08-13

Vous obtenez

Date saisie: 2026-08-13
Première date: 2026-08-01
Année: 2 026
Mois: 8

Ce calculateur détermine le jour de la semaine où commence le mois d’une date ISO explicite. Le jour saisi peut se situer n’importe où dans le mois : le résultat concerne toujours le premier. La réponse fournit la première date canonique, le nom du jour, le numéro ISO et un indice commençant le dimanche. Une validation grégorienne stricte rejette les dates impossibles.

Saisissez une date ISO complète et sans ambiguïté

Renseignez le champ date avec une date calendaire ISO complète au format YYYY-MM-DD. Quatre chiffres désignent l’année, deux le mois et deux le jour. Ainsi, 2026-08-13 sélectionne août 2026, tandis que le dernier élément confirme que vous avez fourni une date réelle et explicite plutôt qu’un mois incomplet.

L’outil valide la valeur entière avant tout calcul. Le mois doit être compris entre 01 et 12, le jour doit exister dans le mois indiqué et février respecte la règle grégorienne des années bissextiles. Une année divisible par quatre est généralement bissextile, sauf les années séculaires non divisibles par quatre cents.

La plage admise va de 0001 à 9999. Les horodatages, suffixes de fuseau, dates de semaine, dates ordinales, séparateurs approximatifs et formats régionaux sont refusés. Cette rigueur empêche la normalisation silencieuse de valeurs impossibles comme 2023-02-29 ou 2026-13-01.

Comprenez le calcul déterministe du jour

Après validation, le moteur conserve l’année et le mois, puis remplace volontairement le jour par un pour le calcul. Il applique une formule grégorienne entière fondée sur une petite table de décalages mensuels, des ajustements pour les années divisibles par quatre, des corrections séculaires et une restauration pour les années divisibles par quatre cents. Janvier et février sont rattachés à l’année arithmétique précédente.

Le reste modulo sept donne un indice partant du dimanche : zéro signifie dimanche, un lundi et six samedi. La réponse convertit aussi cet indice en numérotation ISO, où lundi vaut un et dimanche sept, puis choisit le nom dans une table constante. Aucune date système n’est construite.

Exploitez le résultat dans vos calendriers et tests

Une interface calendaire peut calculer le nombre de cases vides précédant le premier jour. Les rapports peuvent indiquer le jour d’ouverture de chaque période comptable, tandis que les tests créent des scénarios stables sans simuler d’horloge ni modifier le fuseau. L’outil ne calcule pas le premier jour ouvré, n’exclut pas les jours fériés, ne localise pas les noms et ne recherche pas la première occurrence d’un jour demandé.

Il répond uniquement au jour où tombe le premier du mois contenant la date ISO.

Cas d’usage

Construire une grille mensuelle

Utilisez l’indice hebdomadaire pour placer le premier dans la bonne colonne et calculer les cases vides initiales.

Identifier les périodes comptables

Ajoutez le jour d’ouverture aux rapports mensuels lorsqu’une date d’opération désigne la période à décrire.

Créer des scénarios de test stables

Produisez des résultats déterministes de début de mois sans lire l’horloge, créer de dates locales ni régler un fuseau.

Questions fréquentes

Le jour saisi doit-il être le premier du mois ?

Non. Toute date réelle du mois choisi est acceptée. Le moteur la valide puis calcule le jour de la semaine correspondant au premier.

Le fuseau horaire peut-il modifier la réponse ?

Non. Le calcul repose sur des entiers grégoriens et ne construit jamais de Date ni ne consulte les réglages locaux.

Comment le résultat aide-t-il à construire un calendrier mensuel ?

Utilisez l'indice qui part du dimanche pour compter les cases vides avant le 1er. Août 2026 commence un samedi, indice 6 : une grille qui débute le dimanche demande donc six cases vides.

Quelle différence entre les deux numéros du jour ?

Le numéro ISO va du lundi, 1, au dimanche, 7. L'indice depuis le dimanche va du dimanche, 0, au samedi, 6. Pour un samedi, les deux valent donc 6.

L'outil donne-t-il le premier jour ouvré du mois ?

Non. Il indique seulement le jour de la semaine du 1er. Il ne saute ni les week-ends ni les jours fériés et ne cherche pas la première occurrence d'un jour de la semaine choisi.

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/weekday-of-first-of-month

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/weekday-of-first-of-month \
  -H "Authorization: Bearer $KIT_KEY" \
  -H "Content-Type: application/json" \
  -d '{"date":"2026-08-13"}'

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

import os, requests

res = requests.post(
    "https://api.kit.forhosting.com/date/weekday-of-first-of-month",
    headers={"Authorization": f"Bearer {os.environ['KIT_KEY']}"},
    json={
    "date": "2026-08-13"
},
)
task_id = res.json()["task_id"]

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

body := bytes.NewBufferString(`{"date":"2026-08-13"}`)
req, _ := http.NewRequest("POST", "https://api.kit.forhosting.com/date/weekday-of-first-of-month", 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-08-13"
}

Exemple de réponse

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

Le calcul emploie une arithmétique entière fixe, sans réseau, hasard, horloge système, conversion de fuseau horaire ni objet Date, afin que le navigateur et l’API restent déterministes.

Saisissez une date ISO complète et sans ambiguïté

Une fois la validation réussie, le jour saisi n’influence plus la réponse : toutes les dates valides du même mois produisent les mêmes champs first_date et weekday.

Comprenez le calcul déterministe du jour

Cette propriété évite qu’une API de dates interprète une chaîne sans heure selon des règles locales et déplace minuit vers un autre jour. Une même entrée dépend uniquement du calendrier grégorien proleptique et produit donc un résultat identique en UTC, dans un navigateur réglé sur un autre fuseau et lors de futurs appels à l’API.

Exploitez le résultat dans vos calendriers et tests

La réponse convient aussi bien à l’affichage qu’à l’intégration logicielle. first_date contient la valeur canonique YYYY-MM-01 du mois choisi. weekday donne le nom du jour, iso_weekday fournit le numéro ISO de un à sept entre lundi et dimanche, et weekday_sunday_zero sert aux systèmes dont les semaines commencent le dimanche à l’indice zéro. input_date, year et month rendent également un résultat archivé autonome. Le navigateur est gratuit et les requêtes automatisées coûtent $0.002. Une valeur erronée renvoie invalid_input afin de la distinguer d’une panne interne.

Questions techniques

Que signifie iso_weekday ?

Il suit la numérotation ISO : lundi vaut 1, mardi 2 et dimanche 7. weekday_sunday_zero est aussi fourni pour les listes commençant le dimanche.

Que se passe-t-il si je fournis une date impossible ?

La requête renvoie invalid_input, notamment pour un mois invalide, un jour inexistant, l’année 0000 ou un 29 février non bissextile.

Combien coûte une requête API ?

Une requête réussie coûte $0.002. Le même calcul déterministe est également disponible gratuitement dans le navigateur.

Consulter la documentation complète du KIT →

Lancer gratuitement

Exemple résolu

Saisissez une date ISO complète et sans ambiguïté

Comprenez le calcul déterministe du jour

Exploitez le résultat dans vos calendriers et tests

Cas d’usage

Construire une grille mensuelle

Identifier les périodes comptables

Créer des scénarios de test stables

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

Saisissez une date ISO complète et sans ambiguïté

Comprenez le calcul déterministe du jour

Exploitez le résultat dans vos calendriers et tests

Questions techniques

merci