Aggiungere giorni lavorativi a una data
Aggiunga o sottragga giorni lavorativi saltando ogni sabato e domenica: 5 giorni lavorativi dopo lunedì 20 luglio 2026 si arriva a lunedì 27 luglio 2026. Il risultato indica anche il giorno della settimana. Gratis nel suo browser.
- Gratis
- Funziona nel suo browser
- Senza registrazione
- I suoi dati restano sul dispositivo
Esegui gratis nel browser
Esempio risolto
- Data
- 2026-07-20
- Giorni lavorativi da aggiungere
- 5
- Data
- 2026-07-27
- Base
- 2026-07-20
- Giorni lavorativi
- 5
- Giorno della settimana
- Monday
Le scadenze aziendali non intendono quasi mai giorni di calendario. Quando un contratto dice cinque giorni lavorativi da lunedì, la data di scadenza è il lunedì successivo, non il sabato. Questa capacità prende una singola data di calendario ISO e un conteggio intero di giorni lavorativi, poi avanza (o retrocede) saltando ogni sabato e domenica. Il risultato è una data ISO precisa più il nome del giorno della settimana, così pianificatori, motori di SLA e strumenti di fatturazione possono fidarsi della risposta senza aprire un foglio di calcolo o tirare a indovinare stranezze di fuso orario locale.
Cosa significano qui i giorni lavorativi
Un giorno lavorativo è qualsiasi giorno da lunedì a venerdì sul calendario gregoriano civile. I sabati e le domeniche vengono sempre saltati, sia che aggiunga giorni in avanti sia che li sottragga all'indietro. I giorni festivi sono deliberatamente fuori ambito: variano per paese, regione e settore, e incorporare una tabella di festività in uno strumento generico penalizzerebbe in silenzio i team che usano un calendario diverso.
Se ha bisogno di intervalli che considerino le festività, abbini questo risultato al suo elenco di festività o usi un conteggio di giorni lavorativi specifico per paese. La data di base è il punto di partenza e non viene conteggiata come uno dei giorni aggiunti: da un lunedì, aggiungere un giorno lavorativo cade su martedì; da un venerdì, aggiungerne uno cade sul lunedì successivo. Lo zero lascia la data di base invariata anche quando quella base cade nel fine settimana, il che mantiene oneste le retro-elaborazioni.
I conteggi negativi camminano all'indietro con la stessa regola del weekend, quindi un giorno lavorativo prima di un lunedì è il venerdì precedente.
Come chiamarla e leggere il risultato
Invii due campi: date come stringa rigorosa YYYY-MM-DD, e days come intero (positivo, negativo o zero). Il valore assoluto di days è limitato affinché un ciclo fuori controllo non esaurisca l'isolate. Usi i campi del giorno della settimana nei testi rivolti all'utente; usi la data ISO come sistema di riferimento.
Poiché l'algoritmo non consulta mai il fuso orario locale, una data che è già mezzanotte UTC nella sua pipeline resta un valore di calendario puro e non slitta di un giorno quando un server gira in un altro fuso.
Dove si inserisce nei flussi di lavoro reali
I team operativi usano gli scostamenti in giorni lavorativi per promesse di consegna, SLA di supporto e periodi di preavviso contrattuali. I team finanziari calcolano finestre di pagamento che escludono i weekend. I team di prodotto e marketing programmano gate di lancio, revoche di embargo e calendari editoriali senza cadere di sabato.
Il percorso nel browser è gratuito per i controlli interattivi: incolli una data di inizio, inserisca cinque e confermi il giorno di arrivo prima di codificarlo. Combini l'output con le sue tabelle di festività quando una regione osserva festività infrasettimanali; questo strumento resta il filtro affidabile dei weekend al di sotto.
Casi d'uso
SLA e scadenze di supporto
Trasformi un ticket creato di giovedì in una data di scadenza cinque giorni lavorativi dopo senza cadere nel fine settimana.
Periodi di contratto e preavviso
Calcoli l'ultimo giorno lavorativo per preavvisi, rinnovi e finestre di consegna a partire da una data di inizio ISO firmata.
Finestre di pagamento e fatturazione
Aggiunga i giorni lavorativi netti a una data di fattura affinché i sistemi finanziari saldino solo nei giorni feriali.
Domande frequenti
Quanto costa?
Lo stesso calcolo funziona gratis nel suo browser in questa pagina.
I giorni festivi vengono saltati?
No. Vengono saltati solo i sabati e le domeniche. Applichi il suo elenco di festività se una regione ne ha bisogno.
Cosa succede se la data di base è un weekend?
Con days zero la data del weekend viene restituita invariata. Con un conteggio positivo o negativo il cammino parte da quel weekend e si ferma solo su un giorno feriale dopo il numero richiesto di giorni lavorativi.
Posso sottrarre giorni lavorativi?
Sì. Passi un intero negativo in days per spostarsi all'indietro continuando a saltare i weekend.
Perché la mia data è stata rifiutata?
La data deve essere un giorno di calendario gregoriano reale in forma rigorosa YYYY-MM-DD.
Strumenti correlati
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/add-workdays \
-H "Authorization: Bearer $KIT_KEY" \
-H "Content-Type: application/json" \
-d '{"date":"2026-07-20","days":5}'const res = await fetch("https://api.kit.forhosting.com/date/add-workdays", {
method: "POST",
headers: {
"Authorization": `Bearer ${process.env.KIT_KEY}`,
"Content-Type": "application/json"
},
body: JSON.stringify({
"date": "2026-07-20",
"days": 5
})
});
const { task_id } = await res.json();import os, requests
res = requests.post(
"https://api.kit.forhosting.com/date/add-workdays",
headers={"Authorization": f"Bearer {os.environ['KIT_KEY']}"},
json={
"date": "2026-07-20",
"days": 5
},
)
task_id = res.json()["task_id"]<?php
$res = file_get_contents("https://api.kit.forhosting.com/date/add-workdays", false, stream_context_create([
"http" => [
"method" => "POST",
"header" => "Authorization: Bearer " . getenv("KIT_KEY") . "\r\nContent-Type: application/json",
"content" => '{"date":"2026-07-20","days":5}',
],
]));
$task = json_decode($res, true);body := bytes.NewBufferString(`{"date":"2026-07-20","days":5}`)
req, _ := http.NewRequest("POST", "https://api.kit.forhosting.com/date/add-workdays", 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",
"days": 5
}Esempio di risposta
{
"task_id": "tsk_a1b2c3d4e5f6a1b2c3d4e5f6",
"type": "date.add_workdays",
"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.
Limiti
max_workdays | 10000 |
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. |
Note tecniche
Come chiamarla e leggere il risultato
Sono accettati alias come base/start per la data e workdays/n/count per l'intero, così i moduli esistenti si mappano in modo pulito. Le date di calendario non valide falliscono immediatamente con invalid_input: 2026-02-30, 2026-13-01 e le stringhe libere vengono rifiutate anziché forzate. Una risposta riuscita restituisce la data risultante, la base originale, i giorni lavorativi con segno applicati, il nome inglese del giorno della settimana, il numero ISO del giorno della settimana (lunedì uguale a uno fino a domenica uguale a sette) e un flag booleano is_weekend che dovrebbe sempre essere falso dopo uno spostamento non nullo che si ferma solo nei giorni feriali.
Dove si inserisce nei flussi di lavoro reali
Gli sviluppatori incorporano la stessa chiamata in webhook e job CRON affinché ogni servizio condivida un'unica definizione di prossimo giorno lavorativo invece di reimplementare cicli improvvisati che discordano sui casi limite. Il percorso API costa $0.002 per richiesta riuscita ed è fatturato per elemento, il che mantiene economici gli script di pianificazione in blocco pur coprendo l'esecuzione sull'edge.