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 le festività italiane. Questo strumento del KIT conta i giorni lavorativi tra due date, oppure calcola la data risultante aggiungendo un certo numero di giorni lavorativi a una data di partenza.

● StabileGratis · nel tuo browser

Esegui gratis nel browser Vedi l'API

Usalo da WebAPIEmailApp prestoTelegram 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 calcolo 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.

Le festività italiane, già incluse

Il calcolo esclude sabato e domenica e le festività nazionali italiane — Capodanno, Epifania, Pasquetta, Festa della Liberazione, Festa dei Lavoratori, Festa della Repubblica, Ferragosto, Ognissanti, Immacolata, Natale, Santo Stefano — senza doverle inserire a mano ogni volta. Restano fuori le festività patronali locali, diverse da città a città: se ti servono, puoi comunque escludere date aggiuntive, per esempio la festa patronale della tua città o una chiusura aziendale programmata, così il conteggio riflette il calendario reale del tuo ufficio, non solo quello nazionale.

Contare tra due date o proiettare in avanti

Due modalità utili in momenti diversi: 'quanti giorni lavorativi ci sono tra il 14 luglio e il 5 agosto' quando devi verificare una scadenza già fissata, oppure 'che data cade tra 10 giorni lavorativi da oggi' quando devi proporne una nuova, per esempio la consegna di un lavoro o il termine per rispondere a una PEC. Entrambe le direzioni tornano utili nello stesso progetto: prima verifichi quanto margine hai davvero, poi proponi al cliente una data che il calendario, festivi compresi, può rispettare 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 proporre o verificare una data, invece di reimplementare da zero, e mantenere aggiornato ogni anno, il calendario dei festivi italiani. 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ì: il calcolo tiene conto del weekend e restituisce la data reale da comunicare al cliente.

Calcolare quando arriva un rimborso

Marco Rossi aspetta un rimborso PayPal 'entro 10 giorni lavorativi': inserisce la data dell'operazione e ottiene subito la data limite oltre la quale ha senso scrivere all'assistenza.

Pianificare il promemoria prima di una scadenza fiscale

Uno studio commercialista calcola, per ogni cliente, la data in cui inviare il promemoria per un F24 in scadenza tra 3 giorni lavorativi, così l'avviso parte sempre con anticipo utile.

Domande frequenti

Include le festività italiane nel calcolo?

Sì, le festività nazionali sono già considerate: Capodanno, Epifania, Pasquetta e tutte le altre date fisse del calendario italiano.

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

Non sono incluse di default, perché cambiano da città a città: puoi comunque indicare date aggiuntive da escludere per il tuo caso specifico.

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, 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.

Posso partire da una data e sapere quale sarà tra N giorni lavorativi?

Sì, funziona anche così: scegli la data di partenza e il numero di giorni lavorativi da aggiungere, e ottieni la data risultante.

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 &#39;{"items":["valor-1","valor-2"]}'

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({
    "items": [
      "valor-1",
      "valor-2"
    ]
  })
});
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[&#39;KIT_KEY']}"},
    json={
    "items": [
        "valor-1",
        "valor-2"
    ]
},
)
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" => &#39;{"items":["valor-1","valor-2"]}',
  ],
]));
$task = json_decode($res, true);

body := bytes.NewBufferString(`{"items":["valor-1","valor-2"]}`)
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

{
  "items": [
    "valor-1",
    "valor-2"
  ]
}

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