Giorno feriale più vicino a una data
Inserisca una data e ottenga il giorno lavorativo più vicino, dal lunedì al venerdì: un sabato diventa il venerdì precedente, una domenica il lunedì successivo e i giorni feriali restano invariati. Utile per scadenze e chiusure delle paghe. Gratis nel suo browser.
- Gratis
- Funziona nel suo browser
- Senza registrazione
- I suoi dati restano sul dispositivo
Esegui gratis nel browser
Esempio risolto
- Data
- 2024-03-16
- Risultato
- 2024-03-15
- Giorni di scostamento
- -1
- Giorno della settimana di base
- Saturday
- Giorno della settimana base (ISO)
- 6
Questo calcolatore del giorno feriale più vicino a una data prende un singolo giorno del calendario gregoriano in formato rigoroso YYYY-MM-DD e restituisce il giorno dal lunedì al venerdì più vicino, calcolato come data civile pura in UTC. Quando l'ingresso cade già dal lunedì al venerdì, il risultato è quella stessa data con scostamento di zero giorni. Quando l'ingresso è un sabato, il motore indietreggia di un giorno fino al venerdì; quando è una domenica, avanza di un giorno fino al lunedì — il giorno feriale più vicino e non ambiguo in una settimana di sette giorni, senza festività. I controlli classici includono 2024-03-16 (sabato) mappato su 2024-03-15 (venerdì), 2024-03-17 (domenica) su 2024-03-18 (lunedì) e 2024-03-15 (venerdì) che resta invariato. Il percorso usa solo aritmetica gregoriana prolettica deterministica: valida che il giorno esista nel calendario, ottiene il giorno della settimana con l'aritmetica intera di Sakamoto, applica una tabella fissa di scostamento del fine settimana e converte tramite un conteggio di giorno seriale, senza chiamate di rete, campionamento casuale né l'oggetto Date dell'host.
Cosa significa il giorno feriale più vicino e cosa contiene la risposta
Trovare il giorno dal lunedì al venerdì più vicino risponde a una domanda diversa dalla prossima occorrenza di un giorno nominato, dal giorno della settimana precedente o dagli scostamenti multi-giorno per giorni lavorativi: chiede quale unico giorno civile sia più vicino all'ingresso restando nell'insieme dal lunedì al venerdì, trattando sabato e domenica come non feriali da riassegnare. La distanza si misura in mezzanotti di calendario intere sulla linea temporale gregoriana prolettica, interpretata come stringa di data UTC senza ora del giorno e senza conversione di fuso locale.
Per qualsiasi lunedì–venerdì lo scostamento è zero e result è uguale all'ingresso normalizzato. I casi respinti includono il campo date mancante, forme errate come 2024/03/16, mesi impossibili e giorni inesistenti come 2023-02-29. Se Le serve un giorno nominato a partire da una base, giorni lavorativi con festività o conteggi di fine settimana tra due marche temporali, usi quegli strumenti dedicati; questa pagina risponde solo all'aggancio lun–ven più vicino per una data ISO esplicita.
Dove l'aritmetica del giorno feriale più vicino si inserisce in operazioni, paghe e software
I team di operazioni e prodotto hanno bisogno di un giorno feriale più vicino quando una scadenza deve cadere in un giorno di calendario feriale anche se l'utente ha inserito un timbro di fine settimana, quando una data di regolamento o di avviso non deve restare di sabato o domenica, oppure quando un accordo sul livello di servizio definisce la consegna come il giorno feriale più vicino anziché una regola unilaterale di successivo o precedente.
I flussi di paghe e finanza agganciano date di eventi libere in bucket lun–ven così job batch, finestre ACH e scadenze fattura restano fuori dal fine settimana senza inventare un calendario festivo completo per ogni paese. Gli analisti che costruiscono etichette di coorte usano lo stesso movimento per allineare gli inizi di osservazione lontano dal rumore del fine settimana mantenendo esatti i giorni feriali, evitando errori di scarto di uno ai confini d'anno e nei giorni bisestili.
Gli sviluppatori chiamano il contratto da script per generare vettori di test deterministici per scheduler e validatori di form, per seminare calendari demo nei flussi di onboarding, o per soddisfare requisiti di prodotto che esigono un passo di calendario puro senza inizi di settimana del locale host.
Educatori e redattori di standard usano lo strumento per dimostrare che 2024-03-16 è un sabato il cui giorno feriale più vicino è il venerdì e che la domenica si mappa in avanti al lunedì, senza affidarsi a numeri seriali di fogli di calcolo che differiscono tra prodotti né a oggetti Date live che si spostano con i fusi.
Lo abbini ad aiuti per il prossimo giorno della settimana, addizione di giorni lavorativi o conteggio dei fine settimana quando Le servono passi di calendario correlati, e ad altri strumenti deterministici gratuiti quando assembla un piccolo laboratorio di utilità date.
Casi d'uso
Agganci di scadenze e regolamenti
Sposti scadenze, timbri di regolamento e date di avviso inseriti nel fine settimana al giorno dal lunedì al venerdì più vicino, senza inventare una politica unilaterale di giorno lavorativo successivo.
Allineamento di paghe e job batch
Normalizzi date di eventi libere in bucket lun–ven per finestre ACH, scadenze fattura e calendari notturni batch che rifiutano sabato e domenica.
Domande frequenti
Quanto costa il calcolatore del giorno feriale più vicino a una data?
È gratuito nel Suo browser in questa pagina.
Come vengono mappati sabato e domenica?
Sono i giorni lun–ven più vicini in una settimana semplice di sette giorni.
Questo strumento salta le festività ufficiali?
No. Distingue solo lunedì–venerdì da sabato–domenica. Usi uno strumento di giorni lavorativi con festività se Le servono calendari per paese.
Quali formati di data sono accettati?
Date di calendario ISO-8601 estese rigorose YYYY-MM-DD. Lunghezze di mese e giorni bisestili sono validati; sono supportati gli anni da 1 a 9999. Solo giorno civile UTC — senza marche temporali né fusi orari.
Perché il sabato passa al venerdì e non al lunedì?
Perché il venerdì è a un giorno di distanza e il lunedì a due. Lo strumento sceglie sempre il giorno feriale più vicino: il sabato torna indietro e la domenica va avanti.
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/nearest-weekday \
-H "Authorization: Bearer $KIT_KEY" \
-H "Content-Type: application/json" \
-d '{"date":"2024-03-16"}'const res = await fetch("https://api.kit.forhosting.com/date/nearest-weekday", {
method: "POST",
headers: {
"Authorization": `Bearer ${process.env.KIT_KEY}`,
"Content-Type": "application/json"
},
body: JSON.stringify({
"date": "2024-03-16"
})
});
const { task_id } = await res.json();import os, requests
res = requests.post(
"https://api.kit.forhosting.com/date/nearest-weekday",
headers={"Authorization": f"Bearer {os.environ['KIT_KEY']}"},
json={
"date": "2024-03-16"
},
)
task_id = res.json()["task_id"]<?php
$res = file_get_contents("https://api.kit.forhosting.com/date/nearest-weekday", false, stream_context_create([
"http" => [
"method" => "POST",
"header" => "Authorization: Bearer " . getenv("KIT_KEY") . "\r\nContent-Type: application/json",
"content" => '{"date":"2024-03-16"}',
],
]));
$task = json_decode($res, true);body := bytes.NewBufferString(`{"date":"2024-03-16"}`)
req, _ := http.NewRequest("POST", "https://api.kit.forhosting.com/date/nearest-weekday", 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": "2024-03-16"
}Esempio di risposta
{
"task_id": "tsk_a1b2c3d4e5f6a1b2c3d4e5f6",
"type": "date.nearest_weekday",
"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. |
Note tecniche
Lo usi gratis nel browser per pianificazione, scadenze di paghe e allineamento SLA, oppure chiami l'API a $0.002 per richiesta riuscita quando Le servono aggiustamenti riproducibili del giorno feriale in CI, pipeline di report o funzioni di prodotto.
Cosa significa il giorno feriale più vicino e cosa contiene la risposta
Per il sabato, il venerdì precedente è a un giorno e il lunedì successivo a due, quindi il giorno feriale più vicino è il venerdì con offset_days uguale a meno uno. Per la domenica, il lunedì successivo è a un giorno e il venerdì precedente a due, quindi il giorno feriale più vicino è il lunedì con offset_days uguale a più uno. Il calcolatore restituisce la data base normalizzata, la stringa result in ISO, offset_days, i flag booleani is_weekend e shifted, il nome del giorno della settimana base e il numero di giorno della settimana ISO (lunedì uguale a uno fino a domenica uguale a sette), la stessa coppia per il risultato, i campi year, month e day del risultato, i componenti base per l'incatenamento e un breve promemoria della formula. Non c'è approssimazione in virgola mobile della durata di un giorno né dipendenza dall'oggetto Date dell'host: o l'ingresso è un giorno reale del calendario e il giorno feriale più vicino è pienamente determinato, oppure la richiesta fallisce con invalid_input.
Come viene letta la data e come il risultato resta riproducibile
La stringa deve corrispondere a quattro cifre, un trattino, due cifre, un altro trattino e due cifre; gli spazi iniziali o finali vengono tagliati, ma date parziali, giorno dell'anno ordinale da solo, nomi di mese e marche temporali con componente oraria non vengono espansi qui. Dopo il parsing, l'anno deve essere tra 1 e 9999, il mese tra 1 e 12 e il giorno tra 1 e la vera lunghezza di quel mese in quell'anno, con gli anni bisestili secondo la regola gregoriana di divisibile per quattro tranne i secoli non divisibili per quattrocento. Il campo preferito è date, ma gli alias iso_date, d, value, base e from sono accettati così fogli di calcolo, query string e moduli tipizzati possono riutilizzare lo stesso contratto senza rinominare colonne. Internamente il motore ottiene il giorno della settimana base con l'aritmetica intera pura di Sakamoto su scala domenica-zero, mappa il sabato su uno scostamento di meno uno e la domenica su più uno lasciando lunedì–venerdì a zero, converte la terna civile in un conteggio di giorno seriale gregoriano prolettico con la mappatura nota days_from_civil, aggiunge lo scostamento intero e recupera anno, mese e giorno con civil_from_days. Abbini l'esecuzione gratuita nel browser di questa pagina all'API a pagamento quando Le serve lo stesso giorno feriale più vicino in una pipeline automatica che non deve derivare per impostazioni di locale dell'host o transizioni all'ora legale.
Dove l'aritmetica del giorno feriale più vicino si inserisce in operazioni, paghe e software
In questa pagina il lavoro gira interamente nel Suo browser; tramite l'API ogni consultazione riuscita costa $0.002, la validazione fallita non viene addebitata e nulla viene memorizzato dopo la risposta. Questa divisione — esplorazione interattiva gratuita e API a pagamento identica — corrisponde al resto del catalogo tier A del KIT e Le consente di passare da un controllo occasionale a una pipeline senza cambiare il risultato matematico.
Casi di integrazione
Fixture di test deterministiche
Generi stringhe ISO riproducibili del giorno feriale più vicino per test unitari, validatori di form e asserzioni CI, senza dipendere da Date né dall'orologio host.
Domande tecniche
Cosa succede se l'ingresso è già un giorno feriale?
La data base viene restituita invariata. offset_days è 0, shifted è false e result è uguale alla data di ingresso normalizzata.