Convertitore gregoriano → egira
Inserisca una data gregoriana e ottenga la data dell'egira tabulare civile: il 1° gennaio 2000 è il 24 Ramadan 1420. Le regole aritmetiche kuwaitiane danno lo stesso risultato su qualsiasi dispositivo, senza avvistamento della luna. Gratis nel suo browser.
- Gratis
- Funziona nel suo browser
- Senza registrazione
- I suoi dati restano sul dispositivo
Esegui gratis nel browser
Esempio risolto
- Data
- 2000-01-01
- Anno gregoriano
- 2000
- Mese gregoriano
- 1
- Giorno gregoriano
- 1
- Jdn
- 2.451.545
Convertire una data civile gregoriana in una data islamica dell’egira è un’esigenza quotidiana per pianificazione, documentazione, didattica e funzioni di prodotto che devono mostrare entrambi i calendari affiancati. Festività religiose, etichette fiscali, certificati e stringhe di localizzazione spesso memorizzano un sistema e devono visualizzare l’altro senza dipendere dall’orologio del browser né da un servizio astronomico remoto. Questo convertitore da data gregoriana a egira accetta una data di calendario ISO esplicita nel formato YYYY-MM-DD, la tratta come giorno civile UTC (senza ora del giorno e senza scostamento di fuso locale) e restituisce anno, mese e giorno dell’egira civile tabulare corrispondenti tramite il noto algoritmo aritmetico kuwaitiano. L’algoritmo è aritmetica intera pienamente deterministica: giorno gregoriano in Numero del Giorno Giuliano, poi JDN in egira sul ciclo fisso di anni bisestili di 30 anni. Non è avvistamento della luna; i calendari amministrativi e molti software usano questa convenzione civile, che può differire di un giorno dall’osservazione religiosa locale.
Cosa significa egira civile tabulare e come differisce dall’avvistamento lunare
Undici anni su trenta sono bisestili secondo la convenzione aritmetica (tabulare) comune, dando una durata media dell’anno di trecentocinquantaquattro e undici trentesimi di giorno. Quel calendario aritmetico è talvolta chiamato egira civile o tabulare perché governi, database e molte librerie usano regole fisse invece di attendere un avvistamento locale del crescente.
I calendari di avvistamento usati per l’osservanza religiosa in una città possono iniziare il mese un giorno prima o dopo della tabella civile; questa capacità documenta deliberatamente la via civile così che i risultati restino riproducibili tra macchine e anni. L’epoca civile dell’algoritmo colloca il 1 muharram dell’anno 1 AH sul giorno gregoriano prolettico che gli interi kuwaitiani codificano (classicamente legato a metà luglio 622 d.C. nel computo giuliano).
Quando pubblica documenti a doppia datazione, associ questo convertitore a un’etichetta chiara come AH civile tabulare affinché i lettori sappiano che non si rivendica una data di avvistamento di grado fatwa. Se il Suo prodotto deve coincidere con una specifica autorità religiosa nazionale, usi la mappatura pubblicata da quell’autorità invece di trattare una singola tabella aritmetica come verità sacra universale.
Contratto di input, semantica del giorno UTC e campi di risposta
Il valore deve essere esattamente quattro cifre, un trattino, due cifre, un trattino e due cifre: YYYY-MM-DD. Il giorno deve esistere sul calendario gregoriano prolettico: mese tra 01 e 12, giorno entro la lunghezza di quel mese, e 29 febbraio solo negli anni bisestili. Gli anni fuori da 0001–9999 sono rifiutati.
Non c’è componente oraria né offset di fuso nella richiesta: la stringa è interpretata come un intero giorno civile UTC, così due chiamanti in zone diverse non spezzano mai la stessa stringa di data a mezzanotte. Esempio: 2000-01-01 si converte in 24 Ramadan 1420 AH secondo questa tabella civile. Non passi Date.now() a meno che prima non formatti un giorno di calendario fisso; la capacità non legge mai l’orologio del server.
Casi d'uso
Documenti e certificati a doppia datazione
Stampi date gregoriane e di egira civile tabulare su diplomi, contratti e lettere ufficiali a partire da una sola stringa ISO memorizzata.
Localizzazione e righe di data nel CMS
Generi etichette AH stabili per articoli, pagine evento e modelli e-mail senza sorprese di fuso del Date lato client.
Confronti di calendario in aula
Consenta agli studenti di verificare le conversioni aritmetiche dell’egira rispetto alle tabelle dei manuali e di contrastare convenzioni civili e avvistamento lunare.
Domande frequenti
È avvistamento lunare o civile tabulare?
Solo civile tabulare (aritmetica kuwaitiana su un ciclo bisestile fisso di 30 anni). L’osservazione religiosa locale può differire di un giorno; etichetti i risultati come AH civile quando quella distinzione conta.
Il fuso orario o l’orologio del server influenzano il risultato?
No. La data ISO è trattata come un intero giorno civile UTC senza ora del giorno. Il gestore non chiama mai Date né legge l’ora di parete.
Quanti anni bisestili ha il calendario dell'egira tabulare?
Undici ogni trenta. In quegli anni il dodicesimo mese riceve un giorno in più, e il ciclo di trent'anni si ripete sempre uguale, così si può calcolare qualsiasi data senza tavole.
Quanti giorni ha un mese dell'egira?
Nel sistema civile i dodici mesi lunari si alternano tra 29 e 30 giorni. L'unica eccezione è il dodicesimo mese degli anni bisestili, che guadagna un giorno in più.
Come indicare la data su un documento con doppia datazione?
Aggiunga un'etichetta chiara, come «egira tabulare civile», così chi legge sa che non è una data basata sull'avvistamento della luna. Se deve seguire un'autorità religiosa nazionale, usi le date che pubblica.
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
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/gregorian-to-hijri \
-H "Authorization: Bearer $KIT_KEY" \
-H "Content-Type: application/json" \
-d '{"date":"2000-01-01"}'const res = await fetch("https://api.kit.forhosting.com/date/gregorian-to-hijri", {
method: "POST",
headers: {
"Authorization": `Bearer ${process.env.KIT_KEY}`,
"Content-Type": "application/json"
},
body: JSON.stringify({
"date": "2000-01-01"
})
});
const { task_id } = await res.json();import os, requests
res = requests.post(
"https://api.kit.forhosting.com/date/gregorian-to-hijri",
headers={"Authorization": f"Bearer {os.environ['KIT_KEY']}"},
json={
"date": "2000-01-01"
},
)
task_id = res.json()["task_id"]<?php
$res = file_get_contents("https://api.kit.forhosting.com/date/gregorian-to-hijri", false, stream_context_create([
"http" => [
"method" => "POST",
"header" => "Authorization: Bearer " . getenv("KIT_KEY") . "\r\nContent-Type: application/json",
"content" => '{"date":"2000-01-01"}',
],
]));
$task = json_decode($res, true);body := bytes.NewBufferString(`{"date":"2000-01-01"}`)
req, _ := http.NewRequest("POST", "https://api.kit.forhosting.com/date/gregorian-to-hijri", 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": "2000-01-01"
}Esempio di risposta
{
"task_id": "tsk_a1b2c3d4e5f6a1b2c3d4e5f6",
"type": "date.gregorian_to_hijri",
"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. |
Note tecniche
Lo stesso modulo puro alimenta lo strumento gratuito del browser e il percorso API, così controlli dei compiti, plugin CMS e worker all’edge non dissentono mai sulla data AH stampata per un dato input.
Cosa significa egira civile tabulare e come differisce dall’avvistamento lunare
Il calendario islamico è un calendario lunare puro di dodici mesi che, nello schema civile, alternano tra ventinove e trenta giorni, con un giorno intercalare aggiunto al dodicesimo mese negli anni bisestili di un ciclo di trenta anni. La conversione non consulta almanacchi, satelliti o API: con lo stesso input ISO gregoriano, ogni client riceve lo stesso anno, numero di mese, nome del mese e giorno dell’egira.
Contratto di input, semantica del giorno UTC e campi di risposta
Invii con POST un corpo JSON con un solo campo stringa obbligatorio chiamato date (sono accettati gli alias iso_date, value e gregorian). In caso di successo la risposta ripete la data gregoriana normalizzata e il suo anno, mese e giorno; include il Numero del Giorno Giuliano intero usato come intermedio; e restituisce hijri_year, hijri_month (1–12), hijri_day, hijri_month_name in inglese, hijri_iso come anno-mese-giorno con mese e giorno a zero-padding, e hijri_formatted come frase leggibile del tipo 24 Ramadan 1420 AH. I campi di metadati calendar, algorithm e formula documentano che il percorso è hijri_tabular_civil tramite kuwaiti_arithmetic. Campi mancanti, valori non stringa, stringhe ISO malformate e giorni di calendario impossibili falliscono con invalid_input e non vengono addebitati.
Dove un’API da gregoriano a egira crea valore
I team di prodotto che consegnano righe di data bilingui su biglietti, diplomi e moduli ufficiali hanno bisogno di una sola funzione che trasformi una data ISO memorizzata in una stringa AH stabile senza incorporare grandi librerie di calendario in ogni client. Le piattaforme educative che insegnano i sistemi di calendario possono mostrare il ciclo civile degli anni bisestili accanto alle regole bisestili gregoriane e lasciare che gli studenti verifichino i compiti senza fare scraping di siti terzi che cambiano algoritmo in silenzio. Le pipeline di localizzazione che generano e-mail o PDF in più locale possono chiamare questo endpoint una volta per data di documento e mettere in cache i campi strutturati. Poiché l’implementazione è pure parse di livello A, ogni chiamata riuscita costa il prezzo base pubblicato $0.002 senza token di modello e senza rete in uscita; la validazione fallita non consuma saldo.
Domande tecniche
Come converto una data gregoriana in egira?
Invii {"date":"YYYY-MM-DD"} come giorno civile gregoriano reale. L’API restituisce hijri_year, hijri_month, hijri_day, nome del mese in inglese, hijri_iso e una stringa AH formattata con l’algoritmo civile tabulare.
Quali errori di input vengono rifiutati?
Data mancante, valori non stringa, stringhe che non sono esattamente YYYY-MM-DD, anni fuori da 0001–9999 e giorni impossibili come 2023-02-29 falliscono con invalid_input e non vengono addebitati.
Quanto costa il convertitore da gregoriano a egira?
Lo strumento del browser è gratuito. Le richieste API usano il saldo KIT prepagato a $0.002 per chiamata riuscita; l’input non valido non viene addebitato.