ForHosting KIT · Strumenti per sviluppatori

Data e giorno della settimana del Giorno della marmotta

Il Giorno della marmotta cade sempre il 2 febbraio, ma il giorno della settimana cambia ogni anno.

● BetaGratis · nel tuo browser

Usalo da WebAPIEmailTelegramApp presto

Questa calcolatrice riceve un anno del calendario gregoriano e restituisce la data ISO completa, il nome inglese del giorno e valori numerici utili. Il risultato deriva da un’aritmetica di calendario fissa, non dall’orologio del computer, da un fuso orario o da un servizio online. Lei può quindi usarlo sia per una verifica rapida sia in software, pubblicazioni, pianificazione di eventi e procedure storiche ripetibili.

Inserisca l’anno che desidera controllare

Fornisca un anno intero del calendario gregoriano compreso tra 1 e 9999. La calcolatrice fissa mese e giorno al 2 febbraio, perché il Giorno della marmotta mantiene la stessa data ogni anno, quindi determina il giorno settimanale corrispondente. È sufficiente inserire l’anno: Lei non deve indicare luogo, ora o fuso orario. Il risultato comprende una data ISO con anno di quattro cifre, il giorno scritto in inglese, un numero ISO in cui lunedì vale 1 e domenica 7, nonché un numero con origine domenicale, dove domenica vale 0. Questi campi espliciti rendono semplice visualizzare la risposta o passarla a un altro programma. Il motore accetta testo composto solo da cifre per la compatibilità con i moduli, mentre rifiuta valori mancanti, frazioni, segni, parole e anni fuori intervallo. Il calcolo risponde soltanto alla domanda di calendario: non predice che cosa vedrà la marmotta, non fornisce previsioni meteo e non stabilisce se l’inverno continuerà.

Come viene calcolato il giorno in modo deterministico

Il giorno della settimana viene calcolato con aritmetica intera gregoriana equivalente all’algoritmo di Sakamoto. Febbraio usa uno scarto mensile fisso e l’anno scelto viene regolato perché gennaio e febbraio sono considerati parte dell’anno aritmetico precedente. Il calcolo tiene poi conto dei normali cicli bisestili quadriennali, elimina gli anni secolari non bisestili e ripristina i secoli divisibili per 400. Un resto finale produce un numero da 0 a 6, associato da domenica a sabato. Il valore ISO deriva dallo stesso resto, quindi lunedì diventa 1 e domenica 7. Non viene creato alcun oggetto Date di JavaScript. Ciò evita di ereditare accidentalmente il fuso locale, interpretare in modo incoerente gli anni antichi o superare il confine del giorno quando un valore UTC viene formattato localmente. L’implementazione non usa orologio, rete, casualità, parser dipendente dalla lingua o stato mutabile. Lo stesso input convalidato produce pertanto lo stesso JSON nel processo API e nell’esecutore gratuito del browser.

Usi il risultato in calendari, contenuti e automazioni

La risposta è pensata per persone e software. Un redattore può verificare il giorno prima di pubblicare un articolo annuale sul Giorno della marmotta. Una scuola o un museo può etichettare un programma senza sfogliare manualmente un calendario. Un’applicazione per eventi può usare la data ISO come chiave stabile e il nome del giorno come testo visibile, mentre il codice analitico può raggruppare i risultati con entrambe le convenzioni numeriche. Poiché la ricorrenza cade sempre il 2 febbraio, il calcolo è volutamente circoscritto e trasparente: non aggiunge regole di osservanza, non sostituisce il giorno e non sposta la data quando cade nel fine settimana. Inoltre non calcola festività regionali con nomi simili. Per l’automazione, ogni richiesta rappresenta un anno e costa $0.002; la versione nel browser può essere usata interattivamente senza chiamare l’API. Convalidi e conservi la data ISO restituita anziché ricostruirla dal testo, e scelga il campo ISO del giorno quando comunica con sistemi che seguono la numerazione internazionale da lunedì a domenica.

Casi d'uso

Pianificare un evento annuale

Controlli in quale giorno cade il 2 febbraio prima di decidere personale, orari o attività del fine settimana vicino.

Preparare contenuti stagionali

Inserisca data e giorno corretti in un articolo, una newsletter, una scheda didattica o un calendario social.

Compilare software di calendario

Usi la data ISO stabile e i campi numerici nei flussi di pianificazione, reportistica o archiviazione.

Domande frequenti

Qual è la data del Giorno della marmotta?

Cade sempre il 2 febbraio. L’anno determina il giorno settimanale restituito dalla calcolatrice.

La data cambia quando cade nel fine settimana?

No. Questa capacità restituisce sempre il 2 febbraio e non applica regole sostitutive o di festività osservata.

Come viene determinato il giorno della settimana?

Viene usata aritmetica intera gregoriana prolettica e deterministica, comprese le regole bisestili e secolari.

Il calcolo usa il fuso orario di Lei?

No. Elabora campi di calendario in termini UTC e non consulta mai un orologio locale, un fuso o un oggetto Date.

Quanto costa una richiesta API?

Un anno equivale a un elemento e costa $0.002 per richiesta API. La calcolatrice nel browser consente l’uso interattivo.

Per sviluppatori — accesso via API

Tutto quello che vedi in questa pagina è disponibile anche via API. Questa sezione è per i team che vogliono integrarlo nei propri sistemi; chi non ne ha bisogno può semplicemente usare lo strumento qui sopra.

Endpoint

POSThttps://api.kit.forhosting.com/date/groundhog-day

Autenticazione con Bearer token: un POST mette in coda l'attività e il risultato arriva via webhook o link firmato.

Chiamala dal tuo stack

curl -X POST https://api.kit.forhosting.com/date/groundhog-day \
  -H "Authorization: Bearer $KIT_KEY" \
  -H "Content-Type: application/json" \
  -d '{"year":2026}'

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

import os, requests

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

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

body := bytes.NewBufferString(`{"year":2026}`)
req, _ := http.NewRequest("POST", "https://api.kit.forhosting.com/date/groundhog-day", body)
req.Header.Set("Authorization", "Bearer "+os.Getenv("KIT_KEY"))
req.Header.Set("Content-Type", "application/json")
res, _ := http.DefaultClient.Do(req)

Esempio di richiesta

{
  "year": 2026
}

Esempio di risposta

{
  "task_id": "tsk_a1b2c3d4e5f6a1b2c3d4e5f6",
  "type": "date.groundhog_day",
  "status": "queued",
  "_links": {
    "result": "/tasks/tsk_…/result"
  }
}

L'API è asincrona: ricevi subito un task_id e puoi fare polling fino a 1 richiesta al secondo.

Prezzi

per richiesta$0.002

Prezzo pubblicato, senza token né crediti. Se l'attività fallisce, non paghi.

Limiti

`year_min`	1
`year_max`	9999

Errori

HTTP	Codice	Significato
`401`	`unauthorized`	Chiave API mancante o non valida: controlla l'header Authorization.
`402`	`insufficient_balance`	Credito esaurito: ricarica per continuare a eseguire attività.
`404`	`unknown_type`	Tipo di attività sconosciuto: controlla il campo type della richiesta.
`429`	`rate_limited`	Troppe richieste in poco tempo: rallenta e riprova tra qualche secondo.

Leggi la documentazione completa del KIT →