ForHosting KIT · Strumenti per sviluppatori

Calcolatore dei weekend fino a una data

Il calcolatore dei weekend fino a una data conta le coppie complete di sabato e domenica comprese nell’intervallo inclusivo tra una data di riferimento e una data obiettivo.

● BetaGratis · nel tuo browser

Esegui gratis nel browser Vedi l'API

Usalo da WebAPIEmailTelegramApp presto

In questo modo Lei ottiene una risposta pratica senza includere weekend parziali. Inserisca due date gregoriane nel formato YYYY-MM-DD: lo strumento accetta obiettivi passati o futuri, indica la direzione, riporta l’ampiezza inclusiva del periodo e restituisce un risultato riproducibile.

Che cosa si intende per weekend completo

Questo calcolatore considera weekend la sequenza di sabato e domenica associata alla comune settimana lavorativa da lunedì a venerdì. La coppia viene conteggiata soltanto quando entrambe le date rientrano nell’intervallo inclusivo formato dalla data di riferimento e da quella obiettivo. Per esempio, un periodo che termina di sabato non include quel weekend, perché la domenica cade fuori dall’intervallo. Analogamente, un periodo che inizia di domenica esclude la coppia precedente. Un intervallo che va da sabato a domenica contiene invece esattamente un weekend completo. Questa regola sui confini impedisce di presentare un riposo parziale come due giornate interamente disponibili. Venerdì, festività, ricorrenze locali e convenzioni regionali diverse non vengono conteggiati. Durante la verifica sono inclusi entrambi gli estremi. Il risultato risponde quindi a una domanda precisa: quante coppie complete di sabato e domenica sono interamente comprese tra le due date indicate?

Come inserire le date e leggere il risultato

Inserisca la data di riferimento e quella obiettivo nel formato rigoroso YYYY-MM-DD, usando quattro cifre per l’anno e due per il mese e il giorno. Il calcolatore convalida date reali del calendario gregoriano; valori impossibili come il 30 febbraio vengono rifiutati anziché essere spostati automaticamente a un altro mese. L’obiettivo può essere successivo, precedente o uguale alla data di riferimento. Il conteggio è simmetrico: invertire gli stessi estremi non cambia il numero di weekend completi. Il campo relativo alla direzione specifica se l’obiettivo si trova nel futuro, nel passato o nello stesso giorno rispetto al riferimento fornito. Viene restituito anche il totale inclusivo dei giorni di calendario, così che Lei possa verificare facilmente il periodo. Non viene presunta la data odierna. Per un conto alla rovescia da oggi, inserisca esplicitamente oggi come riferimento: una richiesta salvata resterà così chiara e riproducibile anche in seguito.

Come usare il conteggio nella pianificazione

Il numero di weekend completi è una misura sintetica per pianificare, ma va abbinato ai vincoli dell’attività. Per un viaggio, ogni coppia conteggiata rappresenta un sabato e una domenica interamente compresi nella finestra; gli spostamenti del venerdì sera o del lunedì mattina restano fuori da questa misura. Per un progetto, il numero può stimare quante sessioni di lavoro senza interruzioni o quanti periodi di recupero precedono una scadenza, ma non li converte in ore lavorative. Per gli eventi, aiuta a confrontare con coerenza più intervalli quando un’opzione inizia o termina nel mezzo di un weekend. L’algoritmo usa soltanto valori di calendario, senza fusi orari, orari, passaggi all’ora legale, rete o data corrente del dispositivo. Perciò lo stesso input produce il medesimo risultato nel browser e tramite API. Ogni richiesta API costa $0.002; il calcolatore nel browser esegue gratuitamente la stessa logica deterministica.

Casi d'uso

Pianificare il periodo di un viaggio

Verifichi quante coppie complete di sabato e domenica rientrano tra le date di prenotazione, partenza o rientro.

Stimare i weekend di un progetto

Conti i weekend completi disponibili prima di un lancio, una consegna, una ristrutturazione o un esame.

Confrontare gli intervalli per un evento

Valuti più date senza considerare per errore un sabato o una domenica al confine come un weekend completo.

Domande frequenti

Le date di riferimento e obiettivo sono incluse?

Sì. Entrambi gli estremi appartengono all’intervallo, ma il weekend conta solo se comprende sia sabato sia domenica.

Che cosa accade se la data obiettivo è precedente?

Il calcolatore usa lo stesso periodo e indica la direzione passata. Invertire gli estremi non modifica il conteggio.

Un periodo che termina di sabato conta quel weekend?

No. La domenica successiva cade fuori dall’intervallo, quindi la coppia non costituisce un weekend completo.

Sono incluse festività o convenzioni regionali?

No. Un weekend è rigorosamente sabato e domenica; festività e altri giorni di riposo regionali non sono considerati.

Il fuso orario o l’ora legale influiscono sul risultato?

No. Il calcolo usa soltanto date di calendario, senza orari, fusi orari o cambi dell’ora legale.

Quanto costa una richiesta API?

Ogni richiesta API costa $0.002. La versione nel browser esegue gratuitamente lo stesso calcolo deterministico.

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

POSThttps://api.kit.forhosting.com/date/weekends-until

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/weekends-until \
  -H "Authorization: Bearer $KIT_KEY" \
  -H "Content-Type: application/json" \
  -d '{"reference_date":"2026-08-12","target_date":"2026-09-07"}'

const res = await fetch("https://api.kit.forhosting.com/date/weekends-until", {
  method: "POST",
  headers: {
    "Authorization": `Bearer ${process.env.KIT_KEY}`,
    "Content-Type": "application/json"
  },
  body: JSON.stringify({
    "reference_date": "2026-08-12",
    "target_date": "2026-09-07"
  })
});
const { task_id } = await res.json();

import os, requests

res = requests.post(
    "https://api.kit.forhosting.com/date/weekends-until",
    headers={"Authorization": f"Bearer {os.environ['KIT_KEY']}"},
    json={
    "reference_date": "2026-08-12",
    "target_date": "2026-09-07"
},
)
task_id = res.json()["task_id"]

<?php
$res = file_get_contents("https://api.kit.forhosting.com/date/weekends-until", false, stream_context_create([
  "http" => [
    "method"  => "POST",
    "header"  => "Authorization: Bearer " . getenv("KIT_KEY") . "\r\nContent-Type: application/json",
    "content" => '{"reference_date":"2026-08-12","target_date":"2026-09-07"}',
  ],
]));
$task = json_decode($res, true);

body := bytes.NewBufferString(`{"reference_date":"2026-08-12","target_date":"2026-09-07"}`)
req, _ := http.NewRequest("POST", "https://api.kit.forhosting.com/date/weekends-until", 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

{
  "reference_date": "2026-08-12",
  "target_date": "2026-09-07"
}

Esempio di risposta

{
  "task_id": "tsk_a1b2c3d4e5f6a1b2c3d4e5f6",
  "type": "date.weekends_until",
  "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

per richiesta$0.002

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.

Leggi la documentazione completa del KIT →