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.
Esegui gratis nel browser
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.
Casi d'uso
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.
Domande frequenti
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.
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
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-remaining-month \
-H "Authorization: Bearer $KIT_KEY" \
-H "Content-Type: application/json" \
-d '{"date":"2026-07-20"}'const res = await fetch("https://api.kit.forhosting.com/date/workdays-remaining-month", {
method: "POST",
headers: {
"Authorization": `Bearer ${process.env.KIT_KEY}`,
"Content-Type": "application/json"
},
body: JSON.stringify({
"date": "2026-07-20"
})
});
const { task_id } = await res.json();import os, requests
res = requests.post(
"https://api.kit.forhosting.com/date/workdays-remaining-month",
headers={"Authorization": f"Bearer {os.environ['KIT_KEY']}"},
json={
"date": "2026-07-20"
},
)
task_id = res.json()["task_id"]<?php
$res = file_get_contents("https://api.kit.forhosting.com/date/workdays-remaining-month", false, stream_context_create([
"http" => [
"method" => "POST",
"header" => "Authorization: Bearer " . getenv("KIT_KEY") . "\r\nContent-Type: application/json",
"content" => '{"date":"2026-07-20"}',
],
]));
$task = json_decode($res, true);body := bytes.NewBufferString(`{"date":"2026-07-20"}`)
req, _ := http.NewRequest("POST", "https://api.kit.forhosting.com/date/workdays-remaining-month", 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": "2026-07-20"
}Esempio di risposta
{
"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.
Prezzi
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. |