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.
Esegui gratis nel browser
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.
Casi d'uso
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.
Domande frequenti
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.
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
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/persian-to-gregorian \
-H "Authorization: Bearer $KIT_KEY" \
-H "Content-Type: application/json" \
-d '{"year":1400,"month":1,"day":1}'const res = await fetch("https://api.kit.forhosting.com/date/persian-to-gregorian", {
method: "POST",
headers: {
"Authorization": `Bearer ${process.env.KIT_KEY}`,
"Content-Type": "application/json"
},
body: JSON.stringify({
"year": 1400,
"month": 1,
"day": 1
})
});
const { task_id } = await res.json();import os, requests
res = requests.post(
"https://api.kit.forhosting.com/date/persian-to-gregorian",
headers={"Authorization": f"Bearer {os.environ['KIT_KEY']}"},
json={
"year": 1400,
"month": 1,
"day": 1
},
)
task_id = res.json()["task_id"]<?php
$res = file_get_contents("https://api.kit.forhosting.com/date/persian-to-gregorian", false, stream_context_create([
"http" => [
"method" => "POST",
"header" => "Authorization: Bearer " . getenv("KIT_KEY") . "\r\nContent-Type: application/json",
"content" => '{"year":1400,"month":1,"day":1}',
],
]));
$task = json_decode($res, true);body := bytes.NewBufferString(`{"year":1400,"month":1,"day":1}`)
req, _ := http.NewRequest("POST", "https://api.kit.forhosting.com/date/persian-to-gregorian", 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
{
"year": 1400,
"month": 1,
"day": 1
}Esempio di risposta
{
"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.
Prezzi
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. |