Format d'adresse japonais : codes postaux, préfectures et ordre romanisé

Deux ordres d’affichage, pas une simple inversion

Les adresses japonaises nationales s’écrivent généralement d'une vaste zone géographique à un emplacement spécifique : code postal, préfecture, municipalité, district et pâté de maisons, bâtiment et pièce, puis destinataire. Le rendu international romanisé commence généralement par le destinataire et l’emplacement précis.

N'inversez pas les chaînes brutes. Analysez les champs significatifs de préfecture, de municipalité, de bloc et de bâtiment, puis effectuez le rendu pour la langue cible.

Mapper les données japonaises dans des champs internationaux

Cartographiez la préfecture sur address-level1, la municipalité sur address-level2, le district et le bloc sur la ligne 1, et le bâtiment et la pièce sur la ligne 2. Conservez l'original non analysé pour examen et analyse future.

Saisie et affichage du code postal à sept chiffres

L'affichage habituel est composé de trois chiffres, d'un trait d'union et de quatre chiffres. Stockez-le sous forme de texte pour conserver les zéros non significatifs. Un formulaire peut accepter la marque postale, mais doit la stocker séparément de la valeur du code postal.

function normalizeJapanPostcode(value) {
  const digits = value.replace(/[^0-9]/g, '');
  return digits.length === 7 ? `${digits.slice(0, 3)}-${digits.slice(3)}` : value.trim();
}

La romanisation n’est pas une traduction anglaise sans perte

Stockez séparément le texte source japonais et un formulaire romanisé confirmé par l'utilisateur. Les noms et les bâtiments peuvent avoir plusieurs orthographes établies, évitez donc de les régénérer à chaque rendu.

Les canaux d'étiquettes Japan Post ont des contraintes de caractères. Testez l’acceptation de la base de données séparément de l’acceptation de l’impression des étiquettes.

Fixtures de régression pour les adresses japonaises

Incluez la source japonaise, la sortie romanisée, une ligne de bâtiment vide et un nom de bâtiment long. Les données synthétiques testent la structure, et non l'existence d'un bloc particulier.

• Conserver les zéros non significatifs du code postal dans CSV
• Définir une politique pour la saisie de chiffres sur toute la chasse
• Stocker les valeurs japonaises et romanisées séparément
• Autoriser une deuxième ligne vide
• Ne tronquez jamais silencieusement un numéro de chambre

Vérifier deux ordres d’affichage à partir d’un même enregistrement

Créez à la fois une version japonaise nationale et une version internationale romanisée à partir du même fixture structuré. Si les deux vues dépendent de chaînes brutes non liées, il n'existe aucun moyen fiable de montrer que la pièce, le bâtiment et le bloc ont survécu à la conversion. Au lieu de cela, affirmez que chaque composant sémantique apparaît exactement une fois, puis examinez l'ordre localisé.

Saisissez le code postal avec un trait d'union, sans trait d'union et avec la marque postale. Les trois entrées peuvent converger vers un affichage canonique tout en conservant la valeur brute pour les diagnostics. Stockez les chiffres sous forme de texte afin qu'un zéro non significatif ne puisse pas disparaître entre un tableur et l’API.

Enfin, testez le canal d'impression réel. Une base de données peut conserver le texte source japonais tandis qu'un service d'étiquetage international particulier impose un jeu de caractères plus restreint. Signalez cela comme une limitation du canal plutôt que de modifier l'adresse source. L'orthographe romanisée confirmée par l'utilisateur doit rester distincte et réutilisable. Répétez la vérification chaque fois que l'intégration du transporteur ou la version du modèle d'étiquette change.

• Générez les deux commandes à partir d'un seul enregistrement structuré
• Affirmer qu'aucun composant sémantique n'est perdu ou dupliqué
• Normaliser plusieurs formulaires de saisie de code postal
• Vérifier la prise en charge des caractères dans le canal d'impression réel