ForHosting KIT · Strumenti per sviluppatori

Giorni lavorativi in un anno

Il calcolatore riceve una data ISO esplicita, individua il relativo anno solare e conta tutti i giorni dal lunedì al venerdì.

● BetaGratis · nel tuo browser

Esegui gratis nel browser Vedi l'API

Usalo da WebAPIEmailTelegramApp presto

Lei può aggiungere un elenco facoltativo di festività per sottrarre quelle infrasettimanali, senza contare due volte una data duplicata o una festività che cade già nel weekend. Regole gregoriane fisse e aritmetica deterministica assicurano lo stesso risultato con lo stesso input in ogni fuso orario.

Selezioni l’anno con una data esplicita

Inserisca una data nel formato ISO esatto YYYY-MM-DD. La data completa è obbligatoria anche se il calcolo usa soltanto l’anno, perché rende inequivocabili le richieste API ed evita ipotesi sull’anno corrente, sulle impostazioni locali dell’account o sull’orologio del server. Per esempio, 2024-07-25 seleziona l’intero anno solare 2024, dal 1º gennaio al 31 dicembre; il conteggio non parte dal 25 luglio. Il risultato riporta la data inviata, l’anno scelto, i giorni di calendario, i giorni del weekend, le festività infrasettimanali e il totale finale. Gli anni da 0001 a 9999 seguono il calendario gregoriano prolettico e la sua regola per gli anni bisestili. Date inesistenti come 2025-02-29 vengono rifiutate anziché corrette silenziosamente. Il conteggio resta quindi riproducibile e adatto a pianificazione, verifiche, test e regole aziendali conservate nel tempo.

Escluda correttamente weekend e festività

Il calcolo esclude prima tutti i sabati e le domeniche dell’anno selezionato. Lei può poi fornire le festività come elenco di date ISO. Una festività riduce il totale solo se appartiene all’anno scelto e cade dal lunedì al venerdì. Se cade di sabato o domenica, è già esclusa come weekend e non viene sottratta di nuovo. Anche le date duplicate vengono eliminate. Le festività valide di altri anni sono accettate ma ignorate, così può inviare un unico elenco pluriennale senza filtrarlo prima di ogni richiesta. Lo strumento non inventa festività nazionali, non applica giorni sostitutivi e non deduce un Paese dalla posizione. Tali regole cambiano in base a giurisdizione, datore di lavoro, contratto e anno. Indichi le esatte date di chiusura della Sua organizzazione. La separazione tra weekend e festività effettive rende il risultato finale trasparente e verificabile.

Utilizzi un conteggio deterministico nella pianificazione

Il motore usa esclusivamente aritmetica intera di calendario. Non contatta servizi di rete, non legge l’ora corrente, non usa l’oggetto Date di JavaScript e non applica ora legale o impostazioni locali. UTC offre quindi un significato stabile: 2026-01-01 resta la stessa data a Tokyo, Londra o in California. Questa proprietà è utile per piani annuali di capacità, modelli dell’organico, obiettivi di utilizzo, previsioni sui livelli di servizio e stime delle retribuzioni. Conservi la data e l’elenco delle festività insieme al dettaglio restituito per ottenere un’istantanea verificabile e ricalcolabile. Il totale rappresenta potenziali giorni lavorativi dal lunedì al venerdì, non le ore svolte da un dipendente. Non comprende ferie, part-time, chiusure omesse, weekend diversi da sabato e domenica o mezze giornate. Può eseguire il calcolo gratis nel browser oppure usare l’API per $0.002 in un flusso automatizzato.

Casi d'uso

Crei un piano annuale di capacità

Parta dai giorni disponibili, sottragga le chiusure effettive e moltiplichi il risultato trasparente per la capacità giornaliera del team.

Verifichi le ipotesi su retribuzioni e utilizzo

Confronti il totale previsto con una suddivisione deterministica di weekend e festività infrasettimanali effettive.

Renda riproducibili le previsioni

Conservi data e festività affinché le esecuzioni future applichino le stesse regole e non l’orologio corrente.

Domande frequenti

La data indica l’inizio del conteggio?

No. Seleziona l’intero anno solare; vengono considerati tutti i giorni dal 1º gennaio al 31 dicembre.

Quali giorni sono considerati weekend?

Sabato e domenica. Lo strumento non deduce altri schemi settimanali di riposo.

Che cosa accade se una festività cade nel weekend?

Non viene sottratta di nuovo, perché la data è già compresa nel conteggio dei weekend.

Il calcolatore conosce le festività nazionali?

No. Fornisca le date esatte di festività o chiusura applicabili alla Sua organizzazione e giurisdizione.

Quanto costa una richiesta API?

Una richiesta API costa $0.002. Lo stesso calcolo deterministico è disponibile gratuitamente nel browser.

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

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

import os, requests

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

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

body := bytes.NewBufferString(`{"date":"2024-07-25"}`)
req, _ := http.NewRequest("POST", "https://api.kit.forhosting.com/date/workdays-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-07-25"
}

Esempio di risposta

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