ForHosting KIT · Strumenti per sviluppatori

Conti un giorno della settimana nell’anno di una data ISO

Calcoli con precisione quanti lunedì, venerdì, domeniche o altri giorni della settimana ricorrono nell’anno civile indicato da una data ISO esplicita.

● BetaGratis · nel tuo browser

Esegui gratis nel browser Vedi l'API

Usalo da WebAPIEmailTelegramApp presto

Il calcolatore convalida la data completa, ne estrae l’anno e applica le regole del calendario gregoriano tramite aritmetica intera deterministica. Non dipende dall’orologio del computer, dalle impostazioni locali, dai cambi dell’ora legale o da un parser di date dell’ambiente. Il risultato comprende il giorno normalizzato, il conteggio, lo stato di anno bisestile, la durata dell’anno e il giorno della settimana del 1° gennaio.

Indichi una data esplicita e un giorno della settimana

Invii una data scritta esattamente nel formato YYYY-MM-DD e il nome di un giorno, per esempio Monday, Tuesday o Friday. La data esplicita stabilisce l’anno civile da esaminare; il mese e il giorno non limitano l’intervallo del conteggio. Per esempio, sia 2024-01-01 sia 2024-11-30 selezionano l’intero 2024. La data completa deve comunque rappresentare un giorno gregoriano reale: valori impossibili come 2023-02-29 o un tredicesimo mese vengono respinti anziché corretti senza avviso. I nomi dei giorni non distinguono maiuscole e minuscole e sono accettate anche le comuni abbreviazioni inglesi di tre lettere, come Mon, Wed e Sat. La risposta ripete la data originale, identifica l’anno scelto, normalizza il giorno nel nome inglese completo e restituisce un indice con origine nella domenica. Questi due input chiari eliminano ogni dipendenza dalla data corrente e rendono riproducibili nel tempo le richieste archiviate. Il contratto è adatto anche a moduli, attività pianificate, fogli elettronici e registri di audit.

Comprenda come viene calcolato il conteggio deterministico

Ogni anno gregoriano ordinario contiene 365 giorni, cioè esattamente 52 settimane complete e un giorno aggiuntivo. Un anno bisestile contiene 366 giorni, ovvero 52 settimane complete e due giorni aggiuntivi. Ogni giorno della settimana ricorre quindi almeno 52 volte. In un anno ordinario, il giorno in cui cade il 1° gennaio compare una cinquantatreesima volta. In un anno bisestile, i giorni del 1° e del 2 gennaio ricorrono entrambi 53 volte. Il calcolatore applica prima la regola gregoriana: gli anni divisibili per quattro sono bisestili, tranne gli anni secolari non divisibili anche per 400. Calcola poi il giorno del 1° gennaio con aritmetica intera limitata e verifica se quello selezionato rientra tra i giorni eccedenti. Non viene creato alcun oggetto JavaScript Date. Questa scelta evita parsing dipendente dall’ambiente, fusi orari del sistema, ora legale e comportamento locale. Durata dell’anno, indicatore bisestile e giorno del 1° gennaio espongono i dati essenziali per verificare una risposta pari a 52 o 53.

Usi il risultato per pianificazione e verifica

Il conteggio è utile quando una stima annuale dipende da un evento settimanale ricorrente. Il personale addetto alle paghe può determinare il numero di venerdì di pagamento prima di considerare le festività. Le attività operative possono stimare i lunedì di apertura, gli istituti scolastici le possibili giornate di lezione e gli analisti possono convalidare dimensioni calendario generate da altri sistemi. Interpreti il risultato come un puro conteggio di calendario, non come un totale di giorni lavorativi. Festività, chiusure aziendali, congedi, ricorrenze regionali e orari eccezionali sono esclusi intenzionalmente, perché richiederebbero una giurisdizione e una politica non indicate negli input. Se queste esclusioni sono necessarie, utilizzi il dato come base trasparente e sottragga le date secondo il Suo calendario. La data ISO esplicita agevola inoltre i flussi che possiedono già una data di rendicontazione. Browser e API eseguono lo stesso risolutore puro; le richieste automatizzate costano $0.002.

Casi d'uso

Stimare giornate lavorative ricorrenti

Conti tutte le occorrenze di un giorno programmato nell’anno di rendicontazione prima di sottrarre festività o chiusure.

Verificare i calendari delle paghe

Controlli se un giorno di paga settimanale compare 52 o 53 volte nell’anno associato alla data di pagamento.

Convalidare dati di calendario

Confronti i totali settimanali di un calendario annuale generato con una base gregoriana deterministica.

Domande frequenti

Quanto costa una richiesta API?

Ogni richiesta API costa $0.002.

Perché devo indicare una data completa anziché solo l’anno?

La data ISO esplicita e convalidata fornisce l’anno e si adatta ai flussi che usano già date di riferimento o rendicontazione.

Un giorno può ricorrere più di 53 volte nello stesso anno?

No. Un anno gregoriano comprende 52 settimane complete e soltanto uno o due giorni aggiuntivi.

Le festività vengono escluse?

No. Il risultato conta esclusivamente i giorni di calendario e non applica regole festive regionali o aziendali.

Il fuso orario influenza il risultato?

No. Il calcolo usa soltanto la data ISO scritta e aritmetica gregoriana intera, senza orologio locale né parsing Date.

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/count-weekday-in-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/count-weekday-in-year \
  -H "Authorization: Bearer $KIT_KEY" \
  -H "Content-Type: application/json" \
  -d '{"date":"2024-06-15","weekday":"Monday"}'

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

import os, requests

res = requests.post(
    "https://api.kit.forhosting.com/date/count-weekday-in-year",
    headers={"Authorization": f"Bearer {os.environ['KIT_KEY']}"},
    json={
    "date": "2024-06-15",
    "weekday": "Monday"
},
)
task_id = res.json()["task_id"]

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

body := bytes.NewBufferString(`{"date":"2024-06-15","weekday":"Monday"}`)
req, _ := http.NewRequest("POST", "https://api.kit.forhosting.com/date/count-weekday-in-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": "2024-06-15",
  "weekday": "Monday"
}

Esempio di risposta

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