ForHosting KIT · Outils pour développeurs

Convertisseur de date Minguo ROC en date grégorienne

Convertissez une date explicite du calendrier Minguo de la République de Chine en date grégorienne correspondante, sans dépendre d’un fuseau horaire, du réseau ni de l’heure actuelle.

● BetaGratuit · dans votre navigateur

Lancer gratuitement Voir l’API

Utilisez-le depuis WebAPIE-mailTelegramApp bientôt

Saisissez l’année, le mois et le jour au format année-MM-DD, par exemple 113-07-25. Le convertisseur ajoute 1911 à l’année, conserve le mois et le jour, puis vérifie que la date grégorienne existe, y compris selon la règle exacte des années bissextiles. La réponse fournit les deux dates complètes et leurs composantes numériques pour vos dossiers et intégrations.

Saisissez une date Minguo sans ambiguïté

Indiquez une année Minguo positive, puis un mois et un jour sur deux chiffres, séparés par des tirets. Ainsi, 113-07-25 désigne l’année 113 du calendrier de la République de Chine, le mois 07 et le jour 25. L’année ne requiert pas de zéro initial, contrairement au mois et au jour : cette structure fixe empêche les interprétations ambiguës. L’outil accepte volontairement une date complète, et non une année seule, une date avec des barres obliques ou un texte comportant un nom d’ère localisé. Ce contrat précis fiabilise les imports automatisés et signale les données mal formées au lieu d’en deviner le sens. L’année Minguo 1 correspond à 1912 dans le calendrier grégorien ; seules les années positives sont donc admises. Avant la conversion, le mois doit être compris entre 01 et 12 et le jour doit exister. Un champ absent, l’année zéro, des espaces superflus ou un ordre différent entraînent une erreur d’entrée à corriger à la source.

Comprenez le calcul et les contrôles

La relation appliquée est simple : l’année grégorienne est égale à l’année Minguo plus 1911. Seule l’année change ; le mois et le jour restent identiques. Ainsi, 113-07-25 devient 2024-07-25. Le calcul emploie des nombres entiers et ne crée aucun objet Date JavaScript. Cette précaution évite qu’un analyseur traite le texte différemment selon l’environnement ou applique un fuseau local autour de minuit. Une même entrée produit donc la même sortie dans un navigateur, sur un serveur ou dans un test automatisé. La validité est contrôlée pour l’année grégorienne obtenue : les mois de trente jours refusent le 31, février refuse les jours excédentaires et le 29 février n’est accepté que si l’année respecte les règles de divisibilité par 4, des siècles et par 400. Le résultat contient les dates normalisées ainsi que les valeurs numériques de l’année, du mois et du jour, prêtes à être affichées ou traitées sans nouvelle analyse.

Exploitez le résultat en toute sécurité

Ce convertisseur convient lorsqu’un document taïwanais, un formulaire administratif, une facture, un certificat ou un export de base de données emploie une année Minguo alors qu’un autre système attend une date grégorienne. Si la traçabilité est essentielle, conservez la valeur Minguo d’origine avec la valeur convertie ; la réponse associant les deux facilite les vérifications ultérieures. Pour un traitement par lots, appelez la capacité une fois par élément et considérez toute entrée invalide comme un problème de qualité des données à examiner, plutôt que de remplacer silencieusement la date par une supposition. L’outil effectue uniquement une conversion de calendrier. Il ne déduit pas qu’un nombre à deux ou trois chiffres relève du calendrier Minguo, n’interprète pas les caractères chinois d’une ère, ne convertit pas les dates lunaires et n’ajoute aucune heure. Il ne décale pas non plus la date selon un fuseau. Le navigateur convient aux contrôles ponctuels ; via l’API, chaque requête coûte $0.002 et applique le même calcul déterministe.

Cas d’usage

Normaliser des dossiers taïwanais

Convertissez les dates Minguo complètes de documents administratifs ou commerciaux avant leur import dans un système grégorien.

Contrôler une saisie de formulaire

Vérifiez la validité calendaire d’une date Minguo et son équivalent grégorien avant de transmettre ou recopier un formulaire.

Créer une migration vérifiable

Conservez ensemble les valeurs Minguo et grégorienne afin que chaque conversion puisse être rapprochée de sa représentation d’origine.

Questions fréquentes

Comment convertir une année Minguo en année grégorienne ?

Le convertisseur ajoute 1911 à l’année Minguo positive. Le mois et le jour sont conservés après validation de la date complète.

Quel format d’entrée faut-il utiliser ?

Saisissez une année Minguo positive, un mois sur deux chiffres et un jour sur deux chiffres séparés par des tirets, comme 113-07-25.

Les jours bissextiles sont-ils vérifiés ?

Oui. Le 29 février n’est admis que si l’année grégorienne correspondante est bissextile selon les règles grégoriennes.

Mon fuseau horaire influence-t-il la conversion ?

Non. Le calcul repose sur une arithmétique calendaire entière, sans horloge ni objet Date ; aucun fuseau ne modifie donc le résultat.

Puis-je convertir une date antérieure à l’année Minguo 1 ?

Non. Cette capacité accepte uniquement les années Minguo positives et n’interprète pas les notations antérieures à la République.

Quel est le prix d’une conversion par API ?

Chaque requête API coûte $0.002. La version dans le navigateur exécute localement le même calcul déterministe.

Pour les développeurs — accès API

Tout sur cette page est disponible par programmation. Cette section s'adresse aux équipes qui veulent l'intégrer à leurs systèmes ; les autres peuvent simplement utiliser l'outil ci-dessus.

Endpoint

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

Authentification par jeton Bearer : un seul POST met la tâche en file d’attente, et le résultat vous parvient par webhook ou lien signé.

Appeler depuis votre 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)

Exemple de requête

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

Exemple de réponse

{
  "task_id": "tsk_a1b2c3d4e5f6a1b2c3d4e5f6",
  "type": "date.minguo_to_gregorian",
  "status": "queued",
  "_links": {
    "result": "/tasks/tsk_…/result"
  }
}

L’API est asynchrone : chaque appel renvoie un task_id immédiatement, puis vous interrogez l’état à raison d’une requête par seconde.

Tarifs

par requête$0.002

Le prix est publié, sans tokens ni crédits. Une tâche qui échoue n’est pas facturée.

Erreurs

HTTP	Code	Signification
`401`	`unauthorized`	Clé API absente ou invalide : vérifiez l’en-tête Authorization.
`402`	`insufficient_balance`	Solde insuffisant : rechargez votre compte pour lancer cette tâche.
`404`	`unknown_type`	Type de tâche inconnu : vérifiez le champ type de votre requête.
`429`	`rate_limited`	Trop de requêtes : ralentissez la cadence, puis réessayez.

Consulter la documentation complète du KIT →

Lancer gratuitement