ForHosting KIT · Strumenti per sviluppatori

Giorno di Capodanno

Questa calcolatrice del giorno di Capodanno riceve una data ISO esplicita, ne usa l’anno a quattro cifre e indica in quale giorno della settimana cade il 1° gennaio corrispondente.

● BetaGratis · nel tuo browser

Esegui gratis nel browser Vedi l'API

Usalo da WebAPIEmailTelegramApp presto

Il risultato deriva soltanto dalla data fornita e dalle regole del calendario gregoriano: non dipende dalla data odierna, dall’orologio del server, dal fuso del browser né da servizi esterni. La risposta comprende il nome del giorno, il relativo numero ISO e la data esatta del 1° gennaio adottata nel calcolo.

Usi una data qualsiasi per individuare l’anno

Inserisca una data di calendario esplicita nel formato ISO YYYY-MM-DD. La calcolatrice convalida la data completa, compresi il numero di giorni del mese e la regola speciale di febbraio negli anni bisestili, quindi estrae l’anno da valutare. Per esempio, una data di agosto 2026 non richiede il giorno della settimana di quella data: il risultato riguarda deliberatamente il 1° gennaio 2026. Lo strumento è quindi pratico quando un record, una scadenza, una fattura o un evento contiene già una data e Lei desidera conoscere l’inizio dello stesso anno. Richiedere una data completa e valida evita inoltre valori ambigui come 03/04/26, nei quali mese e giorno cambiano secondo la convenzione locale. Sono ammessi gli anni da 0001 a 9999, applicando in modo uniforme il calendario gregoriano prolettico. L’output ripete l’input accettato, identifica l’anno estratto e mostra la data normalizzata di Capodanno, così il fondamento della risposta resta esplicito.

Comprenda il calcolo deterministico del giorno

Il calcolo conta i giorni di tutti gli anni completi precedenti a quello indicato. Gli anni ordinari contribuiscono con 365 giorni; quelli bisestili ne aggiungono uno secondo la regola gregoriana: un anno divisibile per quattro è bisestile, salvo se è divisibile per cento, mentre gli anni divisibili per quattrocento restano bisestili. Il totale viene ridotto modulo sette, considerando lunedì come giorno ISO 1 e domenica come giorno ISO 7. Questa aritmetica individua direttamente il giorno in cui cade il 1° gennaio. Non intervengono l’orologio di sistema, le impostazioni locali, un database dei fusi orari, valori casuali, richieste di rete o l’oggetto Date di JavaScript. Di conseguenza, lo stesso input valido produce la medesima risposta JSON in un’API, in un browser situato in un altro Paese o in un test configurato con un fuso diverso. La risposta include sia un nome leggibile sia il numero ISO, utile per visualizzazione, ordinamento, condizioni e integrazioni.

Applichi il risultato alla pianificazione e all’automazione

Conoscere il giorno del 1° gennaio aiuta a capire come un anno si allinea con i programmi settimanali ricorrenti. Il dato può servire per generare agende annuali, impostare periodi di rendicontazione, controllare archivi, preparare modelli di turnazione o rispondere a quesiti di calendario. In un flusso automatizzato, invii la data già associata al record e utilizzi il numero ISO restituito per scegliere un layout o un ramo del processo. Un risultato pari a 6 o 7 colloca Capodanno nel fine settimana secondo il normale schema dal lunedì al venerdì; i valori da 1 a 5 lo collocano in settimana. La capacità descrive fatti di calendario e non presume quali giorni la Sua organizzazione consideri lavorativi o festivi. Per gli anni storici applica retroattivamente le regole gregoriane, mantenendo una convenzione coerente. L’esecuzione nel browser è gratuita, mentre una richiesta API costa $0.002. Poiché l’output dipende solo dall’input, è adatto anche a build riproducibili, report memorizzati, test di regressione e trasformazioni verificabili.

Casi d'uso

Creare un’agenda annuale

Scelga la colonna corretta per il 1° gennaio prima di generare le settimane rimanenti del calendario annuale.

Classificare l’inizio dell’anno

Usi il numero ISO per stabilire se Capodanno inizia in un normale giorno lavorativo o nel fine settimana.

Verificare calendari archiviati

Confronti il giorno calcolato per il 1° gennaio con un rapporto storico o un calendario importato secondo regole gregoriane uniformi.

Domande frequenti

Quale formato di data deve inviare?

Invii una data ISO completa nel formato YYYY-MM-DD, per esempio 2026-08-07.

Il mese o il giorno influisce sulla risposta?

Devono formare una data valida, ma il calcolo usa l’anno della data per valutare il 1° gennaio corrispondente.

Il fuso orario modifica il risultato?

No. Il calcolo usa aritmetica intera del calendario gregoriano e non converte mai l’input in un orario locale.

Come vengono gestiti gli anni bisestili?

Gli anni divisibili per quattro sono bisestili, quelli secolari non lo sono, salvo quando sono divisibili anche per quattrocento.

Quanto costa?

L’esecuzione nel browser è gratuita. Ogni richiesta API costa $0.002.

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/weekday-of-new-year

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/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)

Esempio di richiesta

{
  "date": "2026-08-07"
}

Esempio di risposta

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

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 →