ForHosting KIT · Strumenti per sviluppatori

Fine del mese successivo

Il calcolatore della fine del mese successivo riceve una data esplicita nel formato YYYY-MM-DD e restituisce l’ultimo giorno di calendario del mese seguente.

● BetaGratis · nel tuo browser

Esegui gratis nel browser Vedi l'API

Usalo da WebAPIEmailTelegramApp presto

Gestisce febbraio, gli anni bisestili, i mesi di trenta o trentuno giorni e il passaggio da dicembre a gennaio senza dipendere dall’orologio o dal fuso orario del dispositivo. Può usarlo quando una regola di fatturazione, un periodo di rendicontazione, un avviso di rinnovo o un flusso di lavoro richiede una data ISO stabile e riproducibile nel browser, tramite un’integrazione API o in una suite di test.

Calcoli un limite chiaro per il mese successivo

Molte regole aziendali sembrano semplici finché non si incontra il confine tra due mesi. L’indicazione «fino alla fine del mese successivo» non può essere realizzata aggiungendo un numero fisso di giorni, perché i mesi di calendario ne contengono ventotto, ventinove, trenta o trentuno. Questo calcolatore parte dal mese presente nella data ISO fornita, avanza di un solo mese di calendario e seleziona l’ultimo giorno valido del mese di destinazione. Una data di gennaio porta quindi alla fine di febbraio, mentre una data di novembre porta alla fine di dicembre. Il giorno della data iniziale non modifica il limite calcolato, ma viene comunque convalidato per impedire che una data impossibile entri silenziosamente in un processo. Il risultato è restituito come data ISO e si presta a campi di database, attività pianificate, fatture, report e sistemi che richiedono un valore inequivocabile. Il calcolo usa il calendario gregoriano prolettico e produce sempre la stessa risposta per la stessa voce valida.

Comprenda anni bisestili e passaggi d’anno

Febbraio è il punto in cui le scorciatoie falliscono più spesso. Nel calendario gregoriano un anno è bisestile se è divisibile per quattro, con l’eccezione degli anni secolari, che devono essere divisibili anche per quattrocento. Febbraio 2024 ha quindi ventinove giorni, febbraio 2100 ne ha ventotto e febbraio 2000 ne ha ventinove. Il calcolatore applica direttamente questa regola con aritmetica intera. Gestisce anche il passaggio da dicembre a gennaio incrementando l’anno: una data di dicembre 2026 restituisce l’ultimo giorno di gennaio 2027. L’input deve contenere un anno reale di quattro cifre compreso tra 0001 e 9999, un mese di due cifre e un giorno di due cifre. Il giorno indicato deve esistere nel rispettivo mese; il 31 aprile e il 29 febbraio di un anno comune vengono rifiutati. Se dicembre 9999 richiedesse di superare l’intervallo ISO di quattro cifre supportato, la richiesta verrebbe rifiutata anziché produrre un valore malformato o ambiguo.

Usi un’aritmetica deterministica e sicura rispetto a UTC

I calcoli sulle date possono spostarsi inaspettatamente quando un software interpreta la mezzanotte in un fuso orario e la formatta in un altro. Questa capacità elimina l’intera categoria di problemi. Non legge l’orologio corrente, non crea un oggetto Date, non usa il fuso orario del sistema, non contatta servizi di rete e non genera valori casuali. Analizza invece l’anno, il mese e il giorno scritti ed esegue un’aritmetica gregoriana limitata su questi numeri interi. Il progetto è sicuro rispetto a UTC perché nessuno scarto locale partecipa al risultato. Inviando lo stesso input da un browser a Tokyo, da un server a New York o da un ambiente di test configurato su UTC, la data restituita resta identica. Per l’automazione, convalidi come data ISO il campo end_of_next_month restituito e lo memorizzi direttamente se il contratto a valle usa limiti inclusivi di fine mese. Se un altro sistema prevede un limite esclusivo, converta il risultato secondo la convenzione documentata di quel sistema, senza presumere che «fine mese» significhi il primo istante del giorno seguente.

Casi d'uso

Impostare una scadenza di fatturazione

Trasformi una data di riferimento nella data finale inclusiva del mese di fatturazione successivo.

Chiudere un periodo di rendicontazione

Crei un limite stabile di fine mese per i report senza dipendere dal fuso orario del server.

Verificare i flussi di rinnovo

Generi date attese deterministiche per anni bisestili, mesi brevi e passaggi d’anno.

Domande frequenti

Quale formato di input è richiesto?

Inserisca una data gregoriana reale nel formato esatto YYYY-MM-DD, compresi gli zeri iniziali per mese e giorno.

Il giorno iniziale modifica il risultato?

No. Viene convalidato, ma ogni data valida dello stesso mese produce lo stesso limite alla fine del mese successivo.

Come vengono gestiti gli anni bisestili?

Le regole gregoriane di divisibilità per 4, 100 e 400 stabiliscono se il febbraio di destinazione ha ventotto o ventinove giorni.

Il fuso orario può cambiare la risposta?

No. Il calcolo utilizza soltanto i componenti della data, senza richiamare l’ora locale, l’orologio o l’API Date.

Quanto costa una richiesta API?

Ogni richiesta API costa $0.002. Il calcolatore nel browser può funzionare localmente senza eseguire calcoli in rete.

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/end-of-next-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/end-of-next-month \
  -H "Authorization: Bearer $KIT_KEY" \
  -H "Content-Type: application/json" \
  -d '{"date":"2024-01-15"}'

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

import os, requests

res = requests.post(
    "https://api.kit.forhosting.com/date/end-of-next-month",
    headers={"Authorization": f"Bearer {os.environ['KIT_KEY']}"},
    json={
    "date": "2024-01-15"
},
)
task_id = res.json()["task_id"]

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

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

Esempio di risposta

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