ForHosting KIT · Outils pour développeurs

Jour du Nouvel An

Ce calculateur du jour du Nouvel An reçoit une date ISO explicite, en extrait l’année à quatre chiffres et indique le jour de la semaine du 1er janvier correspondant.

● BetaGratuit · dans votre navigateur

Lancer gratuitement Voir l’API

Utilisez-le depuis WebAPIE-mailTelegramApp bientôt

Le résultat découle uniquement de la date fournie et des règles du calendrier grégorien : ni la date actuelle, ni l’horloge du serveur, ni le fuseau horaire du navigateur, ni un service externe n’interviennent. La réponse fournit le nom du jour, son numéro ISO et la date exacte retenue pour le calcul.

Utilisez une date quelconque pour déterminer l’année

Saisissez une date civile explicite au format ISO YYYY-MM-DD. Le calculateur valide la date entière, notamment le nombre de jours du mois et la règle particulière de février lors des années bissextiles, puis retient l’année à évaluer. Ainsi, une date d’août 2026 ne demande pas le jour de cette date d’août : le résultat porte expressément sur le 1er janvier 2026. Cette méthode est pratique lorsqu’un dossier, une échéance, une facture ou un événement contient déjà une date et que vous souhaitez connaître le début de la même année. L’obligation de fournir une date complète et valide écarte aussi les écritures ambiguës telles que 03/04/26, dont l’ordre du mois et du jour varie selon les pays. Les années de 0001 à 9999 sont admises selon le calendrier grégorien proleptique. La sortie reprend l’entrée acceptée, indique l’année extraite et affiche la date normalisée du Nouvel An, afin que le fondement de la réponse reste toujours visible.

Comprenez le calcul déterministe du jour

Le calcul additionne les jours de toutes les années complètes qui précèdent l’année fournie. Une année ordinaire compte 365 jours ; une année bissextile en ajoute un selon la règle grégorienne : une année divisible par quatre est bissextile, sauf si elle est divisible par cent, tandis qu’une année divisible par quatre cents le reste. Le total est réduit modulo sept, avec le lundi comme jour ISO 1 et le dimanche comme jour ISO 7. Cette arithmétique détermine directement le jour du 1er janvier. Elle n’utilise ni horloge système, ni réglage régional, ni base de fuseaux horaires, ni valeur aléatoire, ni réseau, ni objet Date de JavaScript. Une même entrée valide produit donc la même réponse JSON dans une API, dans un navigateur situé dans un autre pays ou dans un test exécuté sous un autre fuseau. La réponse associe un nom lisible au numéro ISO, utile pour l’affichage, le tri, les conditions et l’intégration à des systèmes existants.

Exploitez le résultat pour planifier et automatiser

Connaître le jour du 1er janvier aide à comprendre l’alignement d’une année avec les rythmes hebdomadaires récurrents. Cette information sert à produire des agendas annuels, configurer des périodes de rapport, contrôler des archives, préparer des modèles de roulement ou répondre à une question de calendrier. Dans un processus automatisé, envoyez la date déjà liée au dossier et utilisez le numéro ISO renvoyé pour sélectionner une mise en page ou une branche. Un résultat de 6 ou 7 place le Nouvel An pendant le week-end selon la semaine habituelle du lundi au vendredi ; les valeurs de 1 à 5 le placent en semaine. La capacité décrit un fait calendaire sans présumer des jours ouvrés ou fériés de votre organisation. Pour les années historiques, elle applique rétroactivement les règles grégoriennes afin de garantir une convention stable. L’exécution dans le navigateur est gratuite et une requête API coûte $0.002. Le résultat dépendant uniquement de l’entrée, il convient également aux builds reproductibles, aux rapports mis en cache, aux tests de régression et aux transformations auditables.

Cas d’usage

Créer un agenda annuel

Choisissez la bonne colonne pour le 1er janvier avant de générer les autres semaines du calendrier annuel.

Classer le début d’une année

Utilisez le numéro ISO pour savoir si le Nouvel An commence un jour ouvré habituel ou pendant le week-end.

Contrôler des calendriers archivés

Comparez le jour calculé pour le 1er janvier à un rapport historique ou à un calendrier importé selon des règles grégoriennes constantes.

Questions fréquentes

Quel format de date faut-il envoyer ?

Envoyez une date ISO complète au format YYYY-MM-DD, par exemple 2026-08-07.

Le mois ou le jour modifie-t-il la réponse ?

Ils doivent former une date valide, mais le calcul utilise l’année de cette date pour évaluer le 1er janvier correspondant.

Le fuseau horaire influence-t-il le résultat ?

Non. Le calcul emploie l’arithmétique entière du calendrier grégorien et ne convertit jamais l’entrée en heure locale.

Comment les années bissextiles sont-elles traitées ?

Les années divisibles par quatre sont bissextiles, sauf les années séculaires, à moins qu’elles ne soient aussi divisibles par quatre cents.

Quel est le tarif ?

L’exécution est gratuite dans votre navigateur. Chaque requête API coûte $0.002.

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-new-year

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

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

import os, requests

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

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

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

Exemple de réponse

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

Consulter la documentation complète du KIT →