ForHosting KIT · Strumenti per sviluppatori

Giorni rimanenti nel mese

Il calcolatore dei giorni rimanenti nel mese riceve una data di calendario ISO esplicita e misura quanti passaggi completi di giornata separano tale data dall’ultimo giorno dello stesso mese.

● BetaGratis · nel tuo browser

Esegui gratis nel browser Vedi l'API

Usalo da WebAPIEmailTelegramApp presto

Non consulta l’ora attuale, non presume che la data sia quella odierna e non dipende dal fuso orario del dispositivo. Il risultato è quindi riproducibile per calendari, report, test e flussi di dati. La risposta indica anche la data di fine mese e la durata del mese, così Lei può verificare subito il calcolo.

Inserisca una data di calendario esatta

Fornisca la data come stringa nel formato esatto AAAA-MM-GG, mantenendo lo zero iniziale per mesi e giorni di una sola cifra. Una data all’inizio di aprile, per esempio, deve comunque avere due cifre in entrambi i componenti. Il calcolatore accetta gli anni del calendario gregoriano da 0001 a 9999 e verifica che i componenti rappresentino una data reale. Rifiuta il mese zero, il mese tredici, un giorno successivo alla fine del mese e il 29 febbraio di un anno non bisestile. Questo contratto rigoroso impedisce che formati regionali ambigui, con il mese o il giorno in prima posizione, alterino il significato del calcolo. La data deve essere esplicita: espressioni come oggi o domani non sono accettate, perché richiederebbero l’orologio corrente e potrebbero produrre in seguito una risposta diversa. Dopo la convalida, l’output conserva la stringa ISO canonica fornita, facilitando il collegamento al record di origine. Un dato non valido genera un errore client tipizzato, senza stime o correzioni nascoste.

Comprenda il significato del conteggio

Il risultato conta i giorni interi tra la data fornita e l’ultima data civile dello stesso mese. La formula sottrae il numero del giorno dalla quantità di giorni del mese. Con questa definizione, l’ultimo giorno restituisce zero, perché non rimane alcun passaggio completo di giornata prima della fine del mese. Il giorno precedente restituisce uno. La data iniziale non viene aggiunta come ulteriore giorno residuo: il valore è una durata, non un conteggio inclusivo delle date. Oltre a days_remaining, l’output contiene month_end e days_in_month. Questi campi mostrano i dati alla base della sottrazione e consentono di controllare il risultato. Febbraio segue la regola gregoriana: gli anni divisibili per quattro sono bisestili, tranne gli anni secolari non divisibili anche per quattrocento. Aprile, giugno, settembre e novembre hanno trenta giorni; gli altri mesi, escluso febbraio, ne hanno trentuno. Non vengono impiegate approssimazioni, durate medie del mese o conversioni di timestamp.

Utilizzi risultati deterministici nell’automazione

Questa capacità è adatta ai sistemi che dispongono già di una data e richiedono un intervallo stabile fino alla fine del mese. Un processo di fatturazione può calcolare i giorni interi residui del periodo per ogni record datato. Un report di progetto può mostrare un conto alla rovescia basato sulla propria data di riferimento, senza sostituirla accidentalmente con il giorno di apertura. Una suite di test può conservare valori attesi perché la stessa entrata genera sempre la stessa uscita. L’algoritmo usa esclusivamente aritmetica intera del calendario. Non contatta servizi, non genera valori casuali, non crea oggetti Date, non controlla il fuso del sistema e non legge l’orologio corrente. Di conseguenza, un browser a Tokyo e un’esecuzione API in UTC restituiscono lo stesso risultato per la medesima data ISO. Tale coerenza è particolarmente utile intorno alla mezzanotte locale. Ogni richiesta API applica il prezzo base pubblicato di $0.002; il browser può eseguire localmente lo stesso calcolo puro. Per giorni lavorativi, festività, intervalli inclusivi o date in mesi diversi, scelga una capacità che descriva esplicitamente tali regole.

Casi d'uso

Preparare un report mensile

Aggiunga un intervallo riproducibile usando la data del report, non il giorno in cui qualcuno lo apre.

Verificare le scadenze di fatturazione

Crei casi stabili per mesi ordinari, febbraio bisestile e confini mensili senza simulare l’orologio di sistema.

Arricchire record con data

Associ a ogni record la data finale, la durata del mese e i giorni interi rimanenti.

Domande frequenti

Il conteggio include la data inserita?

No. Misura i passaggi completi di giornata fino alla fine del mese. L’ultimo giorno restituisce zero, il precedente uno.

Viene utilizzata la data odierna?

No. Lei deve fornire una data esplicita e l’orologio corrente non viene mai consultato.

Come viene gestito febbraio?

La regola gregoriana stabilisce se febbraio ha ventotto o ventinove giorni, comprese le eccezioni secolari e dei quattrocento anni.

Il fuso orario può cambiare il risultato?

No. Il calcolo usa componenti del calendario e aritmetica intera, senza oggetti Date né conversioni orarie.

Quanto costa una richiesta API?

Ogni richiesta API applica il prezzo base pubblicato di $0.002.

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/days-remaining-month

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/days-remaining-month \
  -H "Authorization: Bearer $KIT_KEY" \
  -H "Content-Type: application/json" \
  -d '{"date":"2024-02-20"}'

const res = await fetch("https://api.kit.forhosting.com/date/days-remaining-month", {
  method: "POST",
  headers: {
    "Authorization": `Bearer ${process.env.KIT_KEY}`,
    "Content-Type": "application/json"
  },
  body: JSON.stringify({
    "date": "2024-02-20"
  })
});
const { task_id } = await res.json();

import os, requests

res = requests.post(
    "https://api.kit.forhosting.com/date/days-remaining-month",
    headers={"Authorization": f"Bearer {os.environ['KIT_KEY']}"},
    json={
    "date": "2024-02-20"
},
)
task_id = res.json()["task_id"]

<?php
$res = file_get_contents("https://api.kit.forhosting.com/date/days-remaining-month", false, stream_context_create([
  "http" => [
    "method"  => "POST",
    "header"  => "Authorization: Bearer " . getenv("KIT_KEY") . "\r\nContent-Type: application/json",
    "content" => '{"date":"2024-02-20"}',
  ],
]));
$task = json_decode($res, true);

body := bytes.NewBufferString(`{"date":"2024-02-20"}`)
req, _ := http.NewRequest("POST", "https://api.kit.forhosting.com/date/days-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": "2024-02-20"
}

Esempio di risposta

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

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 →