ForHosting KIT · Strumenti per sviluppatori

Giorni lavorativi rimanenti nel mese, festività escluse

Il calcolatore dei giorni lavorativi restanti nel mese conta i giorni dal lunedì al venerdì a partire da una data ISO esplicita fino all’ultimo giorno di calendario dello stesso mese.

● BetaGratis · nel tuo browser
Usalo da WebAPIEmailTelegramApp presto

La data iniziale è inclusa se cade tra lunedì e venerdì, mentre sabati, domeniche e festività facoltative sono esclusi. Poiché il calcolo utilizza esclusivamente l’aritmetica del calendario gregoriano in UTC e non consulta mai l’orologio corrente, lo stesso input produce sempre lo stesso risultato. La risposta separa inoltre i giorni di calendario, i giorni del fine settimana e le festività escluse, così che Lei possa verificare facilmente il totale finale.

Scelga la data da cui inizia il conteggio

Indichi una data di calendario esplicita nel formato rigoroso YYYY-MM-DD, per esempio 2026-07-20. Tale data stabilisce sia il primo possibile giorno lavorativo sia il mese il cui ultimo giorno chiude l’intervallo. Il calcolo è inclusivo: una data iniziale di lunedì può contribuire subito con un giorno, mentre una data di sabato non può farlo. Non esiste alcun riferimento nascosto alla data odierna, al fuso orario del server o alle impostazioni locali del browser. Il risultato è quindi adatto a report ripetibili, flussi pianificati, test e registrazioni che potrebbero essere ricalcolate in seguito. La risposta comprende la data iniziale normalizzata, la data di fine mese e il numero di giorni di calendario esaminati. Specifica anche che l’intervallo è inclusivo. Se desidera un conteggio che inizi domani, invii la data ISO esplicita di domani anziché sottrarre o affidarsi a una convenzione non dichiarata. Le date non valide, compresi giorni bisestili impossibili o valori di mese e giorno privi di due cifre, vengono rifiutate invece di essere corrette silenziosamente. Gli anni da 0001 a 9999 sono gestiti secondo le regole gregoriane degli anni bisestili.

Escluda fine settimana e festività senza duplicazioni

Ogni data dal giorno indicato fino alla fine del mese viene classificata esattamente una volta. Sabato e domenica confluiscono nel totale del fine settimana. Una data dal lunedì al venerdì presente nell’elenco facoltativo delle festività confluisce nel totale delle festività. Tutti gli altri giorni infrasettimanali confluiscono nel totale dei giorni lavorativi. Le festività esterne all’intervallo selezionato sono valide ma non producono effetti; Lei può quindi inviare un elenco annuale o regionale riutilizzabile senza ritagliarlo per ogni richiesta. Una festività che cade nel fine settimana non riduce due volte il risultato e le date festive duplicate sono considerate una sola esclusione. Ogni festività deve comunque essere una data ISO reale e rigorosa, così da rilevare subito una configurazione errata. L’API non deduce le festività da un codice paese, poiché le regole cambiano in base alla giurisdizione, al datore di lavoro e all’anno. Fornire le date in modo esplicito mantiene il risultato trasparente e deterministico. Questo strumento rappresenta una settimana lavorativa convenzionale dal lunedì al venerdì; non ridefinisce venerdì o domenica come fine settimana per calendari regionali e non applica regole di mezza giornata.

Legga, verifichi e automatizzi il risultato

Utilizzi workdays_remaining come risposta principale. I campi di supporto permettono di verificare l’aritmetica: calendar_days equivale a weekend_days più holiday_days più workdays_remaining. Il campo month_end mostra il limite esatto, particolarmente utile a febbraio e negli anni bisestili, mentre holiday_days riporta soltanto le festività infrasettimanali che hanno realmente modificato il totale. Questa struttura è adatta a chiusure delle buste paga, pianificazione delle consegne, dashboard di capacità mensile, previsioni dei livelli di servizio e calcoli personali delle scadenze. In un’integrazione automatizzata, conservi la data di input e l’elenco delle festività insieme alla risposta, affinché i revisori futuri possano riprodurre lo stesso numero. L’endpoint costa $0.002 per richiesta tramite API e ogni richiesta rappresenta un calcolo indipendentemente dal numero di festività fornite. L’elaborazione consiste in aritmetica locale del calendario: non effettua richieste di rete e non consulta servizi di festività in tempo reale. Se il calendario aziendale prevede periodi di chiusura, aggiunga ogni giorno infrasettimanale interessato come festività esplicita. Se invece deve contare i giorni lavorativi tra date arbitrarie o aggiungere una durata a una data, utilizzi una capacità per il conteggio di intervalli o l’aggiunta di giorni lavorativi.

Capacità mensile del personale

Stimi la capacità infrasettimanale restante nel mese di pianificazione partendo da una data fissa di report e dall’elenco delle chiusure aziendali.

Chiusure di fatture e paghe

Conti i giorni di elaborazione disponibili prima della fine del mese, escludendo i fine settimana e le festività note dell’ufficio.

Report di scadenza riproducibili

Conservi una data esplicita e un elenco di festività per ricalcolare in seguito il conto alla rovescia di fine mese con lo stesso risultato.

La data iniziale è inclusa?

Sì. Viene conteggiata se cade tra lunedì e venerdì e non è indicata come festività.

Il calcolatore utilizza la data odierna?

No. Lei deve fornire esplicitamente la data e l’orologio di sistema non viene mai consultato.

Che cosa accade se una festività cade nel fine settimana?

Viene conteggiata soltanto come giorno del fine settimana, quindi non riduce due volte il totale dei giorni lavorativi.

Posso inviare festività di altri mesi?

Sì. Le date festive valide esterne all’intervallo inclusivo vengono ignorate e non modificano il risultato.

Quale settimana lavorativa viene utilizzata?

Lo strumento considera lavorativi i giorni dal lunedì al venerdì e tratta sabato e domenica come fine settimana.

Quanto costa un calcolo tramite API?

Ogni richiesta API costa $0.002. L’esecuzione nel browser è disponibile senza costi 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.

POSThttps://api.kit.forhosting.com/date/workdays-remaining-month

Autenticazione con Bearer token: un POST mette in coda l'attività e il risultato arriva via webhook o link firmato.

curl -X POST https://api.kit.forhosting.com/date/workdays-remaining-month \
  -H "Authorization: Bearer $KIT_KEY" \
  -H "Content-Type: application/json" \
  -d '{"date":"2026-07-20"}'
{
  "date": "2026-07-20"
}
{
  "task_id": "tsk_a1b2c3d4e5f6a1b2c3d4e5f6",
  "type": "date.workdays_remaining_month",
  "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.

per richiesta$0.002

Prezzo pubblicato, senza token né crediti. Se l'attività fallisce, non paghi.

HTTPCodiceSignificato
401unauthorizedChiave API mancante o non valida: controlla l'header Authorization.
402insufficient_balanceCredito esaurito: ricarica per continuare a eseguire attività.
404unknown_typeTipo di attività sconosciuto: controlla il campo type della richiesta.
429rate_limitedTroppe richieste in poco tempo: rallenta e riprova tra qualche secondo.

Leggi la documentazione completa del KIT →