ForHosting KIT · Strumenti per sviluppatori

Convertitore da data persiana Jalali a gregoriana

Converta l’anno, il mese e il giorno espliciti di una data del calendario persiano Jalali, o Egira solare, nella corrispondente data gregoriana.

● BetaGratis · nel tuo browser
Usalo da WebAPIEmailTelegramApp presto

Il convertitore applica il ciclo aritmetico persiano di 2.820 anni ed esegue direttamente il calcolo, senza interrogare servizi remoti né usare l’orologio del dispositivo. Il risultato comprende una data gregoriana chiara in formato simile a ISO e i valori separati di anno, mese e giorno, adatti a persone, script, importazioni, archivi storici e campi data interoperabili.

Inserisca una data persiana completa

Indichi l’anno, il mese e il giorno dell’Egira solare persiana come tre numeri interi separati. I mesi da 1 a 6 possono contenere 31 giorni, quelli da 7 a 11 ne possono contenere 30, mentre il mese 12 ha 29 giorni in un anno comune o 30 in un anno bisestile aritmetico. Il convertitore verifica queste regole prima di procedere, quindi una data impossibile viene rifiutata anziché slittare silenziosamente nel mese seguente. Sono ammessi gli anni da 1 a 9999. Inserisca l’anno esattamente come è scritto nel calendario persiano, senza aggiungere uno scarto gregoriano e senza specificare un’ora o l’abbreviazione di un fuso. L’output contiene la data gregoriana corrispondente in una stringa anno-mese-giorno simile al formato ISO e i tre componenti numerici distinti. I campi separati sono pratici per compilare colonne di un database, creare una visualizzazione localizzata o confrontare il risultato con un’altra data strutturata. La conversione rappresenta un giorno di calendario e non un particolare istante al suo interno.

Come viene eseguita la conversione aritmetica

Il calcolo segue il modello aritmetico del calendario persiano basato su un ciclo ricorrente di 2.820 anni. Per prima cosa trasforma la data persiana fornita in un numero di giorno giuliano, un conteggio continuo dei giorni che costituisce un ponte neutro fra sistemi di calendario. Poi scompone tale numero secondo i cicli gregoriani di 400, 100, 4 e 1 anni per ricavare anno, mese e giorno gregoriani. Ogni passaggio usa aritmetica intera limitata e costanti calendariali fisse. La data corrente, le impostazioni internazionali del sistema operativo, il fuso del browser, le richieste di rete e le tabelle storiche non partecipano al risultato. Per questo, chiamate ripetute con lo stesso input restituiscono sempre la stessa risposta tramite API e nel browser. La definizione “aritmetico” è significativa: alcune implementazioni del calendario persiano usano osservazioni astronomiche o calcoli ufficiali dell’equinozio, che in certi anni lontani possono differire da un sistema a ciclo fisso. Questa capacità applica coerentemente la convenzione dichiarata, così Lei può conoscere con precisione il modello usato e riprodurlo in modo indipendente.

Usi correttamente il risultato nei dati e nel software

Consideri il valore restituito una conversione fra date appartenenti a calendari definiti, non un timestamp Unix. Una data da sola non individua un istante finché non vengono indicati un orario, un fuso e le eventuali regole civili pertinenti. Se un database conserva valori composti dalla sola data, la stringa simile al formato ISO è normalmente il dato più diretto da memorizzare. Se invece un sistema richiede un timestamp, aggiunga in un passaggio distinto l’ora locale desiderata e il fuso esplicito, senza presumere la mezzanotte UTC. Questa distinzione impedisce che la data appaia un giorno prima o dopo quando il software applica uno scarto inatteso. Il modello aritmetico è particolarmente adatto a migrazioni ripetibili, procedure di validazione e trasformazioni archivistiche, poiché non cambia con nuove osservazioni o impostazioni regionali. Per attività ufficiali o legali contemporanee, verifichi che l’organizzazione destinataria adotti la stessa convenzione, soprattutto se le sue regole prescrivono un calendario persiano osservazionale. Il prezzo dell’API è $0.002 per richiesta; la versione nel browser svolge localmente la medesima conversione pura.

Normalizzare record importati

Converta le colonne con date persiane in valori gregoriani strutturati prima di caricare i record in un sistema che standardizza le date gregoriane.

Verificare la data di un documento

Trovi l’equivalente gregoriano di una data persiana stampata su un modulo, un certificato, una fattura o un documento archiviato.

Creare una logica calendariale deterministica

Adotti una conversione aritmetica fissa in test, integrazioni e strumenti offline nei quali input identici devono sempre generare risultati identici.

Quale calendario persiano usa questo convertitore?

Usa il calendario persiano aritmetico dell’Egira solare con un ciclo ricorrente di 2.820 anni, non un calcolo osservazionale dell’equinozio.

La conversione dipende dal mio fuso orario?

No. Converte un giorno di calendario in un altro tramite aritmetica fissa e non usa l’orologio del dispositivo, il fuso locale o le regole dell’ora legale.

Come vengono gestiti gli anni bisestili persiani?

Sono determinati dallo stesso ciclo aritmetico di 2.820 anni usato nella conversione. In un anno bisestile aritmetico, il mese 12 può avere 30 giorni.

Cosa accade se inserisco una data impossibile?

La richiesta restituisce un errore di input non valido. Prima della conversione vengono controllati l’intervallo del mese e il numero di giorni ammesso per il mese e l’anno specificati.

Il risultato è un timestamp?

No. Il risultato è una data del calendario gregoriano. Se la Sua applicazione richiede un timestamp, aggiunga separatamente un orario e un fuso esplicito.

Quanto costa una richiesta API?

Il prezzo è $0.002 per richiesta API. La stessa conversione deterministica è disponibile anche localmente nel browser.

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.

POSThttps://api.kit.forhosting.com/date/persian-to-gregorian

Autenticazione con Bearer token: un POST mette in coda l'attività e il risultato arriva via webhook o link firmato.

curl -X POST https://api.kit.forhosting.com/date/persian-to-gregorian \
  -H "Authorization: Bearer $KIT_KEY" \
  -H "Content-Type: application/json" \
  -d '{"year":1400,"month":1,"day":1}'
{
  "year": 1400,
  "month": 1,
  "day": 1
}
{
  "task_id": "tsk_a1b2c3d4e5f6a1b2c3d4e5f6",
  "type": "date.persian_to_gregorian",
  "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.

per richiesta$0.002

Prezzo pubblicato, senza token né crediti. Se l'attività fallisce, non paghi.

HTTPCodiceSignificato
401unauthorizedChiave API mancante o non valida: controlla l'header Authorization.
402insufficient_balanceCredito esaurito: ricarica per continuare a eseguire attività.
404unknown_typeTipo di attività sconosciuto: controlla il campo type della richiesta.
429rate_limitedTroppe richieste in poco tempo: rallenta e riprova tra qualche secondo.

Leggi la documentazione completa del KIT →