Contare i giorni lavorativi tra due date e le festività

È adatto a scadenze, termini di pagamento, pianificazione del personale e procedure in cui i giorni di calendario forniscono una risposta errata. Vengono considerate entrambe le date limite, le festività duplicate sono ignorate e una festività di sabato o domenica non riduce due volte il totale. Il calcolo usa l’aritmetica del calendario invece dell’ora locale, quindi lo stesso input restituisce ovunque lo stesso risultato.

Scelga l’intervallo e ne comprenda gli estremi

Inserisca la data iniziale e quella finale esattamente nel formato YYYY-MM-DD. Il conteggio è inclusivo: ciascun estremo può aggiungere un giorno lavorativo. Se le due date indicano lo stesso mercoledì, il risultato è uno, a meno che quel giorno compaia tra le festività. Se l’intervallo di un solo giorno cade di domenica, il risultato è zero. Questa regola esplicita è importante quando si confrontano strumenti diversi, perché alcuni escludono senza avviso il primo giorno o trattano la fine soltanto come una scadenza esterna. Qui viene esaminata ogni data di calendario dall’inizio alla fine. La data finale non può precedere quella iniziale: un intervallo invertito produce un errore di input anziché un numero negativo fuorviante. Sono accettate solo date gregoriane reali, perciò valori impossibili come il 30 febbraio vengono rifiutati senza essere spostati nel mese successivo.

Escluda le festività senza alterare i fine settimana

Aggiunga le festività come elenco facoltativo di date YYYY-MM-DD. Una data riduce il risultato soltanto se si trova nell’intervallo e cade tra lunedì e venerdì. Una festività di sabato o domenica non comporta un’ulteriore sottrazione, perché il fine settimana è già escluso. Le date esterne all’intervallo sono accettate ma non modificano il totale, così Lei può riutilizzare lo stesso calendario aziendale per molti calcoli. Le voci duplicate contano una sola volta, anche se fonti diverse riportano la medesima chiusura. Lo strumento non sceglie automaticamente le festività nazionali: è Lei a fornire quelle pertinenti al contratto, ufficio, istituto, mercato o ordinamento. In tal modo non vengono fatte ipotesi su giorni sostitutivi, chiusure regionali o regole interne. Ogni data è convalidata e una festività malformata o impossibile genera un errore chiaro invece di essere ignorata.

Utilizzi il risultato nella pianificazione e nelle automazioni

La risposta distingue il totale finale da due valori di controllo: il numero dei giorni feriali prima delle festività e quello delle festività lavorative effettivamente escluse. Il risultato è quindi semplice da spiegare e verificare. Un responsabile può mostrare, per esempio, che l’intervallo comprendeva otto giorni feriali e una festività applicabile, ottenendo sette giorni lavorativi. Sistemi per paghe, fatturazione, assistenza, logistica e conformità possono usare la stessa struttura per controllare le finestre di servizio senza dipendere dal fuso orario del dispositivo. L’algoritmo impiega aritmetica intera deterministica e non consulta la rete, la data corrente o valori casuali. Input identici producono output identici nel browser e tramite API. L’uso interattivo è gratuito, mentre ogni richiesta API costa $0.002. Per calcoli ricorrenti, conservi giurisdizione e regola insieme all’elenco, perché lo strumento valuta le date fornite ma non decide quali festività osservi ufficialmente l’organizzazione.