ForHosting KIT · Strumenti per sviluppatori

Giorni lavorativi

I giorni lavorativi tra due date non sono la semplice differenza di calendario: vanno tolti sabati, domeniche e i festivi che indichi tu. Questo strumento del KIT conta i giorni lavorativi tra una data di inizio e una di fine, escludendo i fine settimana e le date festive che aggiungi.

● StabileGratis · nel tuo browser

Esegui gratis nel browser Vedi l'API

Usalo da WebAPIEmailTelegramApp presto

Perché contare 'a occhio' sbaglia quasi sempre

Tra il 20 dicembre e il 7 gennaio ci sono più festivi di quanti se ne ricordino a mente — Natale, Santo Stefano, Capodanno, l'Epifania — e ogni festivo tolto cambia la scadenza reale di un giorno. Sbagliare questo conteggio per una consegna con SLA di 5 giorni lavorativi significa promettere una data che il calendario non permette, o al contrario perdere tempo credendo di avere meno margine di quanto ce n'è davvero. Contare tra due date con la regola giusta evita entrambi gli errori.

Le festività le aggiungi tu

Il calcolo esclude in automatico sabato e domenica, ma non i giorni festivi: quelli li indichi tu come date da togliere. Così puoi aggiungere le festività nazionali italiane — Capodanno, Epifania, Pasquetta, 25 aprile, 1º maggio, 2 giugno, Ferragosto, Ognissanti, Immacolata, Natale, Santo Stefano — insieme al santo patrono della tua città o a una chiusura aziendale programmata. Invece di dare per scontato un calendario che potrebbe non essere il tuo, il conteggio riflette il calendario reale del tuo ufficio, non solo quello nazionale.

Contare i giorni lavorativi tra due date

Indichi una data di inizio e una data di fine e ottieni quanti giorni lavorativi le separano, weekend e festivi indicati esclusi — utile quando devi verificare una scadenza già fissata, per esempio 'quanti giorni lavorativi ci sono tra il 14 luglio e il 5 agosto'. Accanto trovi anche il conteggio dei giorni di calendario dello stesso intervallo, così confronti a colpo d'occhio la durata piena e quella davvero lavorata, senza sorprese dell'ultimo minuto.

Via API, per calcolare scadenze in automatico

Un sistema che gestisce ordini, ticket o scadenze contrattuali può chiamare l'API — $0.002 a richiesta — ogni volta che deve verificare una data, invece di reimplementare da zero la logica del conteggio: passi le due date e l'elenco dei festivi, e ricevi i giorni lavorativi pronti. Per un calcolo singolo mentre scrivi un'email o un preventivo, la pagina nel browser è gratis e non richiede alcuna integrazione.

Casi d'uso

Verificare una scadenza di consegna con SLA

Tecnoedil Verona S.n.c. promette la consegna di un preventivo entro 5 giorni lavorativi da una richiesta ricevuta di venerdì: conta i giorni lavorativi tra le due date, weekend escluso, e verifica che il margine ci sia davvero.

Controllare se è passato il termine di un rimborso

Marco Rossi aspetta un rimborso 'entro 10 giorni lavorativi': conta i giorni lavorativi trascorsi dalla data dell'operazione e capisce subito se ha già senso scrivere all'assistenza.

Sapere quanto manca a una scadenza fiscale

Uno studio commercialista conta, per ogni cliente, i giorni lavorativi che restano fino alla scadenza di un F24, così sa con quanto anticipo far partire il promemoria.

Domande frequenti

Include le festività italiane nel calcolo?

Non in automatico: escluso in automatico è solo il weekend. Le festività le aggiungi tu come date da togliere — puoi inserire tutte le date fisse del calendario italiano, Capodanno, Epifania, Pasquetta e le altre.

E le festività patronali locali, tipo il santo patrono della città?

Le aggiungi allo stesso modo delle altre: indichi le date festive da escludere per il tuo caso specifico, nazionali e locali insieme.

Il sabato conta come giorno lavorativo?

No, sabato e domenica sono sempre esclusi dal conteggio, indipendentemente dal settore.

Che differenza c'è tra giorni lavorativi e giorni di calendario?

I giorni di calendario contano tutti i giorni senza eccezioni; i giorni lavorativi escludono weekend e festivi indicati, quindi una scadenza a '10 giorni lavorativi' cade sempre più avanti di una a '10 giorni'.

È gratis?

Sì, nel browser senza limiti. Via API, per calcolare scadenze in automatico dentro un sistema, costa $0.002 a richiesta.

Lo strumento aggiunge N giorni lavorativi a una data?

No: conta i giorni lavorativi tra due date che indichi tu, weekend e festivi esclusi, e restituisce anche i giorni di calendario dello stesso intervallo.

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/dev/business-days

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/dev/business-days \
  -H "Authorization: Bearer $KIT_KEY" \
  -H "Content-Type: application/json" \
  -d '{"start":"2026-07-01","end":"2026-07-31"}'

const res = await fetch("https://api.kit.forhosting.com/dev/business-days", {
  method: "POST",
  headers: {
    "Authorization": `Bearer ${process.env.KIT_KEY}`,
    "Content-Type": "application/json"
  },
  body: JSON.stringify({
    "start": "2026-07-01",
    "end": "2026-07-31"
  })
});
const { task_id } = await res.json();

import os, requests

res = requests.post(
    "https://api.kit.forhosting.com/dev/business-days",
    headers={"Authorization": f"Bearer {os.environ['KIT_KEY']}"},
    json={
    "start": "2026-07-01",
    "end": "2026-07-31"
},
)
task_id = res.json()["task_id"]

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

body := bytes.NewBufferString(`{"start":"2026-07-01","end":"2026-07-31"}`)
req, _ := http.NewRequest("POST", "https://api.kit.forhosting.com/dev/business-days", 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

{
  "start": "2026-07-01",
  "end": "2026-07-31"
}

Esempio di risposta

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

Esegui gratis nel browser