ForHosting KIT · Date e tempo

Giorni rimanenti nell'anno

Il 25 luglio 2026 mancano 159 giorni interi al 31 dicembre: quella data è il giorno 206 su 365. Inserisca una data qualsiasi e ottenga i giorni rimanenti nell'anno, il numero del giorno e la verifica dell'anno bisestile. Gratis nel suo browser.

Gratis
Funziona nel suo browser
Senza registrazione
I suoi dati restano sul dispositivo

Esegui gratis nel browser Vedi l'API

Usalo da WebAPIEmailTelegramApp presto

Esempio risolto

Se inserisce

Data: 2026-07-25

Ottiene

Anno: 2026
Mese: 7
Giorno: 25
Giorno dell'anno: 206

Una calcolatrice dei giorni rimanenti nell'anno risponde a una domanda di pianificazione che le persone pongono ogni settimana: da un giorno di calendario dato, quanti giorni interi restano fino alla fine dell'anno? Incolli una data ISO in forma anno-mese-giorno e questo strumento restituisce il conteggio dei giorni rimanenti fino al trentuno dicembre di quello stesso anno, l'ordinale del giorno dell'anno, se l'anno è bisestile gregoriano e la stringa ISO di fine anno.

Cosa significa «giorni rimanenti fino a fine anno» nel calendario gregoriano

Una data di calendario ISO si scrive con quattro cifre per l'anno, un trattino, due cifre per il mese, un altro trattino e due cifre per il giorno del mese—ad esempio duemilaventisei trattino zero sette trattino venticinque. Sotto, il calendario gregoriano regola ancora la lunghezza dei mesi: trenta o trentuno giorni per la maggior parte, febbraio con ventotto in un anno comune e ventinove solo in un anno bisestile. Un anno bisestile è ogni anno divisibile per quattro, eccetto gli anni secolari non divisibili per quattrocento.

Il giorno dell'anno è la posizione ordinale della data in quell'anno: il primo gennaio è il giorno uno e il trentuno dicembre è il giorno trecentosessantacinque o trecentosessantasei. I giorni rimanenti fino alla fine dell'anno si definiscono come la lunghezza dell'anno meno quel giorno dell'anno, così l'ultimo giorno di calendario riporta zero giorni interi rimanenti e il primo gennaio riporta trecentosessantaquattro in un anno comune o trecentosessantacinque in un bisestile.

Quella definizione combacia con il linguaggio quotidiano dei conti alla rovescia e della pianificazione di fine anno senza inventare un orizzonte dell'anno successivo né contare solo i giorni lavorativi.

Suggerimenti pratici, limiti e ricerche correlate

Invii sempre una data di calendario completa, non un datetime con componente oraria né una Z finale; questo strumento rifiuta deliberatamente i timestamp ISO estesi affinché i chiamanti non codifichino per errore mezzenotti dipendenti dal fuso. Nell'insegnamento o nei test, mantenga un piccolo insieme noto: una data infrasettimanale a metà anno, il primo gennaio in un anno comune e in un bisestile, il trentuno dicembre per il caso di zero rimanenti, un ventinove febbraio valido come successo e un fallimento deliberato come duemilaventitre trattino zero due trattino ventinove.

I limiti di anno si fermano a novemilanovecentonovantanove per mantenere ben definite le stringhe ISO a quattro cifre su questa superficie di prodotto. Questa pagina si rivolge a chi cerca i giorni rimasti nell'anno, i giorni rimanenti fino a fine anno o un conto alla rovescia di fine anno da una data ISO; non è un contatore di giorni lavorativi, né un formattatore di date consapevole della locale, né un calcolatore di intervalli multi-anno.

Preferisca questa capacità quando ha già una data ISO e le serve solo il resto fino a fine anno; se le servono i giorni lavorativi escludendo weekend e festivi, usi invece una capacità business-days.

Casi d'uso

Pianificazione di progetti e ferie di fine anno

I responsabili inseriscono una data ISO obiettivo e vedono quanti giorni di calendario interi restano fino al 31 dicembre per buffer di ferie, finestre di freeze e tagli di consegna.

Controllo compiti di aritmetica del giorno dell'anno

Gli studenti confrontano conteggi manuali del giorno dell'anno e dei giorni rimanenti con un risultato deterministico che include le regole di febbraio bisestile.

Domande frequenti

Come si contano i giorni rimanenti fino alla fine dell'anno?

Il 1 gennaio in un anno comune ha 364 giorni rimanenti; il 31 dicembre ne ha 0. Il conteggio sono i giorni di calendario interi rimasti dopo la data data entro lo stesso anno.

Un anno bisestile cambia la risposta?

Sì. Gli anni bisestili hanno 366 giorni, quindi il giorno dell'anno dopo febbraio e il conteggio rimanente tengono conto del 29 febbraio quando l'anno è divisibile per 4 (con le solite eccezioni secolari).

La calcolatrice dei giorni rimanenti nell'anno è gratuita?

Lo strumento del browser è gratuito e gira in locale.

Che numero ha un giorno all'interno dell'anno?

Compare accanto al risultato. Il 1° gennaio è il giorno 1, quindi il 25 luglio 2026 è il giorno 206 su 365 e il 31 dicembre è il 365, oppure il 366 in un anno bisestile.

Conta solo i giorni lavorativi?

No. Contano tutti i giorni del calendario, compresi fine settimana e festività. Il risultato è la durata dell'anno meno il numero del giorno della sua data, senza regole sui giorni lavorativi.

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

POSThttps://api.kit.forhosting.com/date/days-remaining-year

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-year \
  -H "Authorization: Bearer $KIT_KEY" \
  -H "Content-Type: application/json" \
  -d '{"date":"2026-07-25"}'

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

import os, requests

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

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

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

Esempio di risposta

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

Limiti

`year_min`	1
`year_max`	9999

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

Le stringhe non valide—forma errata, mesi impossibili o un ventinove febbraio fuori da un anno bisestile—vengono rifiutate con un errore chiaro invalid_input invece di una risposta sbagliata silenziosa.

Cosa significa «giorni rimanenti fino a fine anno» nel calendario gregoriano

Quella forma è non ambigua tra le località che scrivono prima il mese o prima il giorno nella prosa quotidiana, ed è per questo che le API e i database la preferiscono. Poiché lo strumento non apre mai il costruttore Date dell'host, i risultati non possono scostarsi quando un browser gira in un fuso diverso dal Worker dell'API, e i casi limite del giorno bisestile si decidono solo con regole di divisibilità intera.

Come chiamare l'API e cosa restituisce

Il valore deve corrispondere al pattern esatto di quattro cifre, trattino, due cifre, trattino, due cifre, e deve rappresentare un giorno gregoriano reale nell'intervallo inclusivo di anni da uno a novemilanovecentonovantanove. Invii un corpo JSON con un campo stringa obbligatorio denominato date, che può anche essere fornito con gli alias iso_date, value o day. In caso di successo la risposta echeggia la stringa data canonica, year, month e day come numeri, imposta day_of_year all'ordinale a base uno, days_in_year a trecentosessantacinque o trecentosessantasei, days_remaining e days_left allo stesso intero non negativo di giorni interi fino al trentuno dicembre, days_elapsed allo stesso ordinale di day_of_year per chi ragiona in giorni trascorsi, leap_year a un booleano, year_end alla stringa ISO del trentuno dicembre di quell'anno, e include un breve messaggio più un array ordinato steps che riformula il parsing e la sottrazione. La validazione fallita—campo assente, tipo non stringa, forma errata, anno fuori intervallo, mese o giorno impossibile, o un ventinove febbraio non bisestile—restituisce invalid_input e non viene mai addebitata. Il prezzo è un $0.002 fisso per richiesta riuscita con voce unitaria e prezzo marginale unitario zero.

Suggerimenti pratici, limiti e ricerche correlate

Preferisca il nome di campo principale date quando controlla il client; gli alias esistono per compatibilità con moduli che etichettano il controllo iso_date o value. I controlli andata e ritorno sono semplici: ricalcoli day_of_year a mano dalle lunghezze dei mesi e confermi che days_in_year meno quell'ordinale è uguale a days_remaining. Le attività fallite che restituiscono invalid_input non consumano il saldo prepagato, il che mantiene economici gli script esplorativi quando si inviano di proposito date errate.

Casi di integrazione

Fixture di conto alla rovescia per app e test

Gli sviluppatori generano valori noti di giorni rimanenti per test unitari e widget di conto alla rovescia nell'interfaccia senza dipendere dall'orologio host o dal fuso orario.

Domande tecniche

Cosa succede il 31 dicembre?

Lo strumento restituisce days_remaining = 0 e segnala che l'ingresso è l'ultimo giorno dell'anno. Non passa all'anno successivo.

E se la data non è valida?

Campi assenti, stringhe non YYYY-MM-DD, mesi o giorni impossibili e 29 febbraio non bisestile restituiscono invalid_input e non vengono mai addebitati.

Leggi la documentazione completa del KIT →

Esegui gratis nel browser

Esempio risolto

Cosa significa «giorni rimanenti fino a fine anno» nel calendario gregoriano

Suggerimenti pratici, limiti e ricerche correlate

Casi d'uso

Pianificazione di progetti e ferie di fine anno

Controllo compiti di aritmetica del giorno dell'anno

Domande frequenti

Strumenti correlati

Per sviluppatori — accesso via API

Endpoint

Chiamala dal tuo stack

Esempio di richiesta

Esempio di risposta

Prezzi

Limiti

Errori

Note tecniche

Cosa significa «giorni rimanenti fino a fine anno» nel calendario gregoriano

Come chiamare l'API e cosa restituisce

Suggerimenti pratici, limiti e ricerche correlate

Casi di integrazione

Fixture di conto alla rovescia per app e test

Domande tecniche

grazie