Préparer votre application pour le changement d’ère du Japon

Le calendrier japonais est divisé en ères. Depuis presque le début de l’âge informatique moderne, nous sommes dans l’ère Heisei ; toutefois, le 1er mai 2019, une nouvelle ère a commencé. Dans la mesure où il s’agit de la première fois depuis plusieurs décennies qu’une ère change, les logiciels prenant en charge le calendrier japonais doivent être testés, pour vérifier qu’ils fonctionnent correctement depuis le début de la nouvelle ère.

Dans les sections suivantes, vous allez découvrir ce que vous pouvez faire pour préparer et tester votre application pour la nouvelle ère.

Ajouter une clé de Registre pour la nouvelle ère

Il est important de tester les problèmes de compatibilité avant le changement d’ère, et vous pouvez le faire maintenant à l’aide du nom de la nouvelle ère. Pour ce faire, ajoutez une clé de Registre pour la nouvelle ère dans l’Éditeur du Registre :

1. Accédez à Ordinateur\HKEY_LOCAL_MACHINE\SYSTEM\CurrentControlSet\Control\Nls\Calendars\Japanese\Eras.
2. Sélectionnez Édition > Nouveau > Valeur de chaîne, et donnez-lui le nom 2019 05 01.
3. Cliquez avec le bouton droit sur la clé, puis sélectionnez Modifier.
4. Dans le champ Données de la valeur, entrez 令和_令_Reiwa_R (vous pouvez faire un copier-coller à partir d’ici pour faciliter la tâche).

Consultez Gestion des ères pour le calendrier japonais pour en savoir plus sur le format de ces clés de Registre.

Le nom de la nouvelle ère a été annoncé le 1er avril 2019. Le 25 avril, une mise à jour avec une nouvelle clé de Registre pour les versions Windows prises en charge contenant le nom a été publiée, ce qui vous permet de valider que votre application le gère correctement. Cette mise à jour est répercutée aux versions antérieures de Windows 10 ainsi que Windows 8 et Windows 7.

Vous pouvez supprimer votre clé de Registre d’espace réservé une fois que vous avez terminé de tester votre application. Cela permet de garantir qu’elle n’interfère pas avec la nouvelle clé de Registre qui est ajoutée lors de la mise à jour de Windows.

Changer le format de calendrier de votre appareil

Une fois que vous avez ajouté la clé de Registre pour la nouvelle ère, vous devez configurer votre appareil pour utiliser le calendrier japonais. Vous n’avez pas besoin de disposer d’un appareil en japonais pour effectuer cette opération. Pour réaliser des tests approfondis, vous pouvez installer le module linguistique japonais également, mais cela n’est pas nécessaire pour le test de base.

Pour configurer votre appareil pour utiliser le calendrier japonais :

1. Ouvrez intl.cpl (recherchez ce fichier dans la barre de recherche Windows).
2. Dans la liste déroulante Format, sélectionnez Japonais (Japon).
3. Sélectionnez Paramètres supplémentaires.
4. Sélectionnez l’onglet Date.
5. Dans la liste déroulante Type de calendrier, sélectionnez 和暦 (wareki, le calendrier japonais). Il doit être la deuxième option.
6. Cliquez sur OK.
7. Cliquez sur OK dans la fenêtre Région.

Votre appareil doit maintenant être configuré pour utiliser le calendrier japonais, et qu’il reflète les ères présentes dans le Registre. Voici un exemple de ce que vous pouvez voir maintenant dans l’angle inférieur droit de l’écran :

Ajuster l’horloge de votre appareil

Sous Windows 10

1. Cliquez avec le bouton droit dans la zone de date et d’heure dans l’angle inférieur droit de l’écran.
2. Sélectionnez Ajuster la date/l’heure.
3. Dans l’application Paramètres, sous Modifier la date et l’heure, sélectionnez Modifier.
4. Définissez la date sur le 1er mai 2019 ou sur une date ultérieure.

Sous Windows 11

1. Cliquez avec le bouton droit dans la zone de date et d’heure dans l’angle inférieur droit de l’écran.
2. Sélectionnez Ajuster la date/l’heure.
3. Dans l’application Paramètres, sous Configurer la date et l’heure manuellement, sélectionnez Modifier.
4. Définissez la date sur le 1er mai 2019 ou sur une date ultérieure.

Tester votre application

Maintenant, testez la façon dont votre application gère la nouvelle ère. Vérifiez les emplacements où s’affiche la date, comme les horodatages et les sélecteurs de date. Assurez-vous que l’ère est correcte avant le 1er mai 2019 (Heisei, 平成) et après (Reiwa, 令和).

Gannen (元年)

Le format du calendrier japonais est généralement <Nom de l’ère><Année de l’ère>. Par exemple, l’année 2018 correspond à Heisei 30 (平成30年). Toutefois, la première année d’une ère est spéciale ; au lieu d’être <Nom de l’ère> 1, elle correspond à <Nom de l’ère> 元年 (gannen). Ainsi, la première année de l’ère Heisei serait 平成元年 (Heisei gannen). Assurez-vous que votre application gère correctement la première année de la nouvelle ère et affiche correctement 令和元年.

API associées

Il existe plusieurs API WinRT, .NET et Win32 qui seront mises à jour pour gérer le changement d’ère ; si vous les utilisez, vous ne devriez pas rencontrer de problèmes. Toutefois, même si vous vous reposez entièrement sur ces API, il est toujours judicieux de tester votre application et de vérifier que vous obtenez le comportement souhaité, surtout si vous réalisez des opérations particulières, telles qu’une analyse.

Vous pouvez suivre les mises à jour apportées au système d’exploitation et aux SDK sur la page Mises à jour pour le changement d’ère du Japon en mai 2019.

Les API suivantes seront impactées :

WinRT

• Espace de noms Windows.Globalization
  • Classe Calendar
    • Méthode AddDays
    • Méthode AddEras
    • Méthode AddHours
    • Méthode AddMinutes
    • Méthode AddMonths
    • Méthode AddNanoseconds
    • Méthode AddPeriods
    • Méthode AddSeconds
    • Méthode AddWeeks
    • Méthode AddYears
    • Propriété Era
    • Méthode EraAsString
    • Propriété FirstYearInThisEra
    • Propriété LastEra
    • Propriété LastYearInThisEra
    • Propriété NumberOfYearsInThisEra
• Espace de noms Windows.Globalization.DateTimeFormatting
  • Classe DateTimeFormatter
    • Méthode Format

.NET

• Espace de noms System
  • Struct DateTime
  • Struct DateTimeOffset
• Espace de noms System.Globalization
  • Classe Calendar
  • Classe DateTimeFormatInfo
  • Classe JapaneseCalendar
  • Classe JapaneseLunisolarCalendar

Win32

• En-tête datetimeapi.h
  • Fonction GetDateFormatA
  • Fonction GetDateFormatEx
  • Fonction GetDateFormatW
• En-tête winnls.h
  • Fonction EnumDateFormatsA
  • Fonction EnumDateFormatsExA
  • Fonction EnumDateFormatsExEx
  • Fonction EnumDateFormatsExW
  • Fonction EnumDateFormatsW
  • Fonction GetCalendarInfoA
  • Fonction GetCalendarInfoEx
  • Fonction GetCalendarInfoW

Voir aussi

• Gestion d’ères pour le calendrier japonais
• Moment An 2000 du calendrier japonais
• Utilisation du Registre pour tester la nouvelle ère japonaise sur Windows
• Gannen vs Ichinen
• Mises à jour pour le changement d’ère du Japon en mai 2019
• Gestion d’une nouvelle ère dans le calendrier japonais dans .NET