Conversor de data Minguo ROC para gregoriana
Converta uma data explícita do calendário Minguo da República da China na data gregoriana correspondente sem depender de fuso horário, rede ou relógio.
Executar grátis
Informe ano, mês e dia Minguo no formato ano-MM-DD, como 113-07-25. O conversor soma 1911 ao ano, preserva mês e dia e verifica se a data gregoriana existe, inclusive pela regra correta de anos bissextos. A resposta traz as duas datas completas e suas partes numéricas para uso simples em registros e integrações.
Informe uma data Minguo sem ambiguidade
Digite um ano Minguo positivo seguido de mês e dia com dois dígitos, separados por hífens. Por exemplo, 113-07-25 representa o ano 113 do calendário da República da China, o mês 07 e o dia 25. O ano não precisa de zeros à esquerda, mas o mês e o dia precisam, pois a estrutura fixa evita interpretações ambíguas. A ferramenta aceita de propósito uma data completa, e não um ano isolado, uma data com barras ou texto contendo um nome de era localizado. Esse contrato restrito torna importações automatizadas previsíveis e evidencia dados malformados, sem tentar adivinhar a intenção de quem os enviou. O ano Minguo 1 corresponde a 1912 no calendário gregoriano, portanto somente anos positivos são aceitos. Antes da conversão, o mês deve estar entre 01 e 12 e o dia precisa existir naquele mês. Campo ausente, ano zero, espaços extras ou outra ordem geram uma entrada inválida que você pode corrigir na origem.
Entenda o cálculo e a validação
A relação usada é: ano gregoriano igual ao ano Minguo mais 1911. Apenas o ano muda; mês e dia mantêm os mesmos valores. Assim, 113-07-25 vira 2024-07-25. O cálculo usa aritmética inteira e não cria um objeto Date do JavaScript. Isso evita que a leitura da data varie entre ambientes ou aplique um fuso local perto da meia-noite. A mesma entrada produz a mesma saída no navegador, no servidor ou em um teste automatizado. A validade é verificada no ano gregoriano resultante: meses de trinta dias rejeitam o dia 31, fevereiro rejeita dias além de sua duração e 29 de fevereiro só é aceito quando o ano convertido segue as regras de divisibilidade por 4, de séculos e por 400. O resultado contém as datas Minguo e gregoriana normalizadas, além dos valores numéricos de ano, mês e dia, prontos para exibição ou processamento estruturado sem nova análise do texto.
Use o resultado com segurança
Este conversor ajuda quando um documento taiwanês, formulário público, nota, certificado ou exportação de banco de dados registra uma data com ano Minguo, mas outro sistema exige uma data gregoriana. Quando a rastreabilidade for importante, mantenha o valor Minguo original ao lado do valor convertido; a resposta pareada facilita a conferência da fonte. Em operações em lote, chame a capacidade uma vez por item e trate uma resposta de entrada inválida como um problema de qualidade dos dados que precisa de revisão, em vez de substituir silenciosamente a data por uma suposição. A ferramenta faz apenas a conversão de calendário. Ela não deduz se um número de dois ou três dígitos pertence ao calendário Minguo, não interpreta caracteres chineses de era, não converte datas lunares e não acrescenta horário. Também não desloca a data por fuso horário, porque uma data civil não tem deslocamento de relógio. O navegador atende verificações individuais; pela API, cada solicitação custa US$ 0,002 e usa o mesmo cálculo determinístico.
Casos de uso
Normalizar registros taiwaneses
Converta datas Minguo completas de registros administrativos ou comerciais antes de importar para um sistema que armazena datas gregorianas.
Conferir um campo de formulário
Verifique se uma data Minguo é válida e veja o equivalente gregoriano antes de enviar ou transcrever um formulário.
Criar uma migração auditável
Armazene juntos os valores Minguo e gregoriano para que revisores rastreiem cada data convertida até a representação original.
Perguntas frequentes
Como um ano Minguo é convertido em ano gregoriano?
O conversor soma 1911 ao ano Minguo positivo. Mês e dia são preservados depois que a data completa é validada.
Qual formato de entrada é aceito?
Use um ano Minguo positivo, mês com dois dígitos e dia com dois dígitos separados por hífens, como 113-07-25.
A ferramenta valida dias bissextos?
Sim. O dia 29 de fevereiro só é aceito quando o ano gregoriano correspondente é bissexto pelas regras gregorianas.
A conversão depende do meu fuso horário?
Não. Ela usa aritmética inteira de calendário, sem relógio nem objeto Date, e nenhuma mudança de fuso altera o resultado.
É possível converter datas anteriores ao ano Minguo 1?
Não. Esta capacidade aceita somente anos Minguo positivos e não interpreta notações anteriores à República.
Quanto custa uma conversão pela API?
Cada solicitação à API custa US$ 0,002. A versão no navegador executa localmente o mesmo cálculo determinístico.
Para desenvolvedores — acesso via API
Tudo nesta página está disponível via API. Esta seção é para equipes que querem integrar a ferramenta aos próprios sistemas; quem não precisa disso pode simplesmente usar a ferramenta acima.
Endpoint
Autenticação por token Bearer. Um único POST coloca a tarefa na fila; o resultado chega por webhook ou link assinado.
Chame do seu código
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)Exemplo de requisição
{
"date": "113-07-25"
}Exemplo de resposta
{
"task_id": "tsk_a1b2c3d4e5f6a1b2c3d4e5f6",
"type": "date.minguo_to_gregorian",
"status": "queued",
"_links": {
"result": "/tasks/tsk_…/result"
}
}A API é assíncrona: cada chamada devolve um task_id na hora. Se preferir polling, consulte o status a até 1 requisição por segundo.
Preço
Preço publicado, sem tokens nem créditos escondidos. Tarefa que falha não é cobrada.
Erros
| HTTP | Código | O que significa |
|---|---|---|
401 | unauthorized | Token ausente ou inválido. Confira o header Authorization. |
402 | insufficient_balance | Saldo insuficiente para esta tarefa. Faça uma recarga e tente de novo. |
404 | unknown_type | Esse tipo de tarefa não existe. Confira o campo type no catálogo. |
429 | rate_limited | Muitas requisições em pouco tempo. Espere um instante e tente de novo. |