ForHosting KIT · Strumenti per sviluppatori

Conversione da data Minguo ROC a gregoriana

Converta una data esplicita del calendario Minguo della Repubblica di Cina nella corrispondente data gregoriana senza dipendere da fuso orario, rete o orologio.

● BetaGratis · nel tuo browser

Esegui gratis nel browser Vedi l'API

Usalo da WebAPIEmailTelegramApp presto

Inserisca anno, mese e giorno Minguo nel formato anno-MM-DD, per esempio 113-07-25. Il convertitore aggiunge 1911 all’anno, mantiene mese e giorno e verifica che la data gregoriana esista, applicando anche la regola corretta degli anni bisestili. La risposta include entrambe le date complete e le relative parti numeriche, così da poterle usare facilmente in archivi e integrazioni.

Inserisca una data Minguo inequivocabile

Indichi un anno Minguo positivo seguito da mese e giorno di due cifre, separati da trattini. Per esempio, 113-07-25 identifica l’anno 113 del calendario della Repubblica di Cina, il mese 07 e il giorno 25. L’anno non richiede zeri iniziali, mentre mese e giorno sì: una struttura fissa impedisce letture ambigue. Lo strumento accetta volutamente una data completa, non un solo anno, una data con barre o un testo contenente il nome localizzato di un’era. Questo contratto ristretto rende prevedibili le importazioni automatiche e mette in evidenza i dati non validi, senza tentare di indovinare l’intenzione del mittente. L’anno Minguo 1 corrisponde al 1912 gregoriano, quindi sono ammessi soltanto anni positivi. Prima della conversione, il mese deve essere compreso tra 01 e 12 e il giorno deve esistere nel mese indicato. Un campo mancante, l’anno zero, spazi aggiuntivi o un ordine diverso generano un errore di input che Lei può correggere alla fonte.

Comprenda il calcolo e la convalida

La relazione applicata è: anno gregoriano uguale ad anno Minguo più 1911. Cambia soltanto l’anno; mese e giorno restano invariati. Pertanto 113-07-25 diventa 2024-07-25. Il calcolo usa aritmetica intera e non crea un oggetto Date di JavaScript. In questo modo l’interpretazione non cambia tra ambienti e non viene applicato un fuso locale vicino alla mezzanotte. Lo stesso input genera dunque lo stesso risultato in un browser, su un server o in un test automatico. La validità viene controllata sull’anno gregoriano ottenuto: i mesi di trenta giorni rifiutano il giorno 31, febbraio rifiuta i giorni eccedenti e il 29 febbraio è accettato solo quando l’anno convertito rispetta le regole di divisibilità per 4, dei secoli e per 400. Il risultato contiene le date Minguo e gregoriana normalizzate e i valori numerici di anno, mese e giorno, pronti per la visualizzazione o l’elaborazione strutturata senza analizzare nuovamente il testo.

Utilizzi il risultato in modo sicuro

Il convertitore è utile quando un documento taiwanese, un modulo pubblico, una fattura, un certificato o un’esportazione di database registra una data con anno Minguo, mentre un altro sistema richiede una data gregoriana. Se la tracciabilità è importante, conservi il valore Minguo originale insieme a quello convertito; la risposta abbinata agevola il controllo della fonte. Nei flussi in serie, richiami la capacità una volta per elemento e consideri una risposta di input non valido come un problema di qualità dei dati da esaminare, anziché sostituirla in silenzio con una data presunta. Lo strumento esegue esclusivamente una conversione di calendario. Non deduce se un numero di due o tre cifre appartenga al calendario Minguo, non interpreta caratteri cinesi dell’era, non converte date lunari e non aggiunge un orario. Non sposta neppure la data per il fuso orario, poiché una data civile non possiede un offset. Il browser è adatto ai controlli singoli; tramite API ogni richiesta costa $0.002 e usa lo stesso calcolo deterministico.

Casi d'uso

Normalizzare archivi taiwanesi

Converta date Minguo complete di documenti amministrativi o commerciali prima di importarle in un sistema con date gregoriane.

Controllare un campo del modulo

Verifichi che una data Minguo sia valida e consulti l’equivalente gregoriano prima di inviare o trascrivere un modulo.

Realizzare una migrazione verificabile

Conservi insieme i valori Minguo e gregoriano affinché ogni data convertita possa essere ricondotta alla rappresentazione originale.

Domande frequenti

Come si converte un anno Minguo in gregoriano?

Il convertitore aggiunge 1911 all’anno Minguo positivo. Mese e giorno rimangono invariati dopo la convalida della data completa.

Quale formato di input è accettato?

Usi un anno Minguo positivo, un mese di due cifre e un giorno di due cifre separati da trattini, per esempio 113-07-25.

I giorni bisestili vengono verificati?

Sì. Il 29 febbraio è accettato solo se l’anno gregoriano corrispondente è bisestile secondo le regole gregoriane.

La conversione dipende dal mio fuso orario?

No. Usa aritmetica intera del calendario, senza orologio né oggetto Date, quindi un cambio di fuso non altera il risultato.

Posso convertire date precedenti all’anno Minguo 1?

No. Questa capacità accetta solo anni Minguo positivi e non interpreta le notazioni anteriori alla Repubblica.

Quanto costa una conversione tramite API?

Ogni richiesta API costa $0.002. La versione nel browser esegue localmente lo stesso calcolo deterministico.

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/minguo-to-gregorian

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

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

import os, requests

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

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

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

{
  "date": "113-07-25"
}

Esempio di risposta

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

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 →