Résumé des nouvelles mises à jour de l’ère japonaise pour .NET Framework

Cet article présente les nouvelles mises à jour de l’ère japonaise pour .NET Framework.

Version du produit d’origine : .NET Framework 3.5 et versions ultérieures
Numéro de la base de connaissances d’origine : 4477957

Résumé

Le 1er mai 2019, la nouvelle ère du calendrier japonais commencera. Microsoft se prépare à ces modifications et prévoit d’envoyer des mises à jour dans chaque version du correctif cumulatif mensuel. Il s’agit de la première transition d’une ère à une autre depuis janvier 1989, et également la première dans l’histoire du .NET Framework. Cet article est destiné à aider les développeurs à tester et à vérifier le fonctionnement des ères dans les applications .NET, la façon dont les applications sont affectées par le changement d’ère et ce que vous, en tant que développeur, devez faire pour vous assurer que vos applications gèrent correctement les modifications de l’ère japonaise à venir.

Pour plus d’informations sur les mises à jour Windows pour le changement de l’ère japonaise, consultez kb 4469068.

Mises à jour du .NET Framework

Les versions suivantes contiennent les mises à jour de l’ère japonaise pour .NET Framework. Ils contiennent également des améliorations en matière de qualité et de fiabilité.

• Correctif cumulatif de qualité .NET Framework de septembre 2018 (préversion)
• Correctif cumulatif de sécurité et de qualité .NET Framework de novembre 2018
• Correctif cumulatif de sécurité et de qualité .NET Framework de décembre 2018
• Mise à jour de mars 2019 du .NET Framework
• Correctif cumulatif de sécurité et de qualité .NET Framework de mai 2019

Articles de la base de connaissances par version du .NET Framework pour les mises à jour de l’ère japonaise

Les mises à jour de maintenance répertoriées dans le tableau suivant contiennent toutes les mises à jour de l’ère japonaise pour .NET Framework qui étaient déjà incluses dans les mises à jour publiées précédemment. Les mises à jour de maintenance contiennent également une nouvelle mise à jour de qualité qui supprime la dépendance aux guillemets simples pour générer le caractère Gannen dans la mise en forme de l’ère japonaise, de sorte que "y年" ou "y'年'" de la chaîne de format de date et d’heure personnalisée permet au .NET Framework de mettre en forme l’année 1 en 元. Ces mises à jour sont disponibles sur Windows Update, Windows Server Update Service (WSUS) et Windows Update Catalog.

Microsoft a publié un correctif cumulatif de sécurité et de qualité .NET Framework pour Windows 8.1 et versions antérieures prises en charge de Windows en mai 2019, comme indiqué ci-dessous. Tous les correctifs cumulatifs de sécurité et de qualité publiés ultérieurement à ces mises à jour contiendront également des mises à jour de l’ère japonaise.

Modifications pour les clients de mise à jour de sécurité uniquement

Cette section s’adresse aux clients qui s’appuient sur les mises à jour de sécurité uniquement (SO) pour Windows 8.1 et les versions antérieures de Windows pris en charge.

À l’instar des mises à jour .NET Framework pour les Windows 10 répertoriées dans la section précédente, les mises à jour répertoriées dans le tableau suivant contiennent toutes les mises à jour de l’ère japonaise pour .NET Framework qui étaient déjà incluses dans les mises à jour publiées précédemment et une nouvelle mise à jour qualité pour supprimer la dépendance à l’utilisation de guillemets simples pour générer le caractère Gannen dans la mise en forme de l’ère japonaise.

Ces mises à jour n’incluent pas de nouvelles mises à jour de sécurité ou de nouvelles améliorations supplémentaires en matière de qualité et de fiabilité qui n’étaient pas déjà incluses dans les mises à jour publiées précédemment, à l’exception de la mise à jour pour le problème de guillemet unique. Par conséquent, les utilisateurs qui s’appuient sur les mises à jour de sécurité uniquement (SO) et les mises à jour du correctif cumulatif mensuel (MO) pour Windows 8.1 et les versions antérieures prises en charge de Windows peuvent également sélectionner ces mises à jour pour la nouvelle ère japonaise. Ces mises à jour sont disponibles via windows Server Update Service (WSUS) et Windows Update Catalogue uniquement.

Tester la nouvelle ère japonaise sur .NET Framework

Pour toutes les versions de .NET Framework dans le tableau des articles de la Base de connaissances, ainsi que pour .NET Core exécuté sur Windows, les informations de l’ère du calendrier sont fournies par le système d’exploitation Windows et récupérées à partir du Registre système lorsque vous appliquez les mises à jour pour .NET Framework. Pour vous préparer plus facilement à la modification de l’ère japonaise, vous pouvez contrôler quand vous ajoutez l’entrée de registre d’espace réservé à vos systèmes et choisir le moment qui répond à vos besoins. Actuellement, le registre d’espaces réservés pour le système d’exploitation Windows est pris en charge pour les systèmes suivants :

• Client Windows : Windows 7 SP1 et versions ultérieures
• Windows Server : Windows Server 2008 R2 SP1 et versions ultérieures

Une mise à jour de Windows ajoute la nouvelle valeur d’ère au Registre une fois que le nom de l’ère et le nom de l’ère abrégé sont connus. .NET sur Windows reflète automatiquement cette mise à jour.

Scénarios de test recommandés à couvrir

• Vérifications de plage d’ères assouplies

  Ce scénario de test consiste à vérifier que les applications métier fonctionnent lorsque la transition de la nouvelle ère est définie sur une date ultérieure.

  Une date dans une ère particulière peut « déborder » dans l’ère suivante, et aucune ou FormatException n’est ArgumentOutOfRangeException levée par défaut. Lorsque vous définissez la valeur de Switch.System.Globalization.EnforceJapaneseEraYearRanges sur true, vous pouvez restaurer des vérifications d’ère strictes.

• La première année d’une ère

  Ce scénario de test consiste à vérifier la convention de Gannen (元年) dans les opérations de mise en forme en tant que première année d’une nouvelle ère de calendrier japonais.

  Par défaut, .NET adopte la convention Gannen (元年) dans les opérations de mise en forme. Vous pouvez restaurer le comportement précédent. Ce comportement représente toujours l’année comme « 1 » au lieu de Gannen (元年). Pour ce faire, définissez la valeur suivante sur true :

  Switch.System.Globalization.FormatJapaneseFirstYearAsANumber

Fonctionnalités prises en charge par l’ère japonaise

• Mise à jour de la source de données

  À l’origine, les informations de l’ère japonaise étaient conservées en tant que données codées en dur dans .NET Framework 3.5 et les versions antérieures de .NET Framework, mais de la même façon que .NET Framework 4.0 et versions ultérieures, sa source pour l’ère japonaise a été modifiée de données privées codées en dur à la clé de Registre sous HKEY_LOCAL_MACHINE\SYSTEM\CurrentControlSet\Control\Nls\Calendars\Japanese\Eras le chemin du Registre. La mise à jour pour Windows ajoute la clé de Registre pour la nouvelle ère après l’annonce de son nom.

• Relaxation de la plage

  Quand Heisei (平成) Era se termine le 30 avril, 2019 qui est Heisei (平成) 31, et la nouvelle ère commence le 1er mai 2019, :::no-loc text=""平成 31 年 5 月 1 日" » ::: devient non valide. Nous avons assoupli nos analyseurs pour permettre aux dates futures ou passées (à la fois grégoriennes et japonaises) dans les applications .NET, d’être converties en une date d’ère japonaise pertinente sans lever d’exception telle que ArgumentOutOfRangeException et System.FormatException. Vous serez également en mesure de convertir les dates futures de Heisei en nouvelle ère japonaise une fois le nom de l’ère japonaise annoncé. Il peut être désactivé dans .NET Framework. En définissant la valeur de Switch.System.Globalization.EnforceJapaneseEraYearRanges sur true.

• Gannen (元年) pour la première année de l’ère japonaise

  Dans la pratique historique, pour la première année de l’époque, un caractère spécial « Gan (元) », dont le caractère kanji signifie « origine » ou « début », est utilisé à la place du nombre « Ichi (1) ». La première année « Gannen (元年) » se poursuit jusqu’à la date de fin de l’année civile grégorienne, le 31 décembre. .NET Framework prend en charge « Gannen (元年) » et « Ichinen (1 年) » pour la première année de l’ère. Pour toutes les versions de .NET Framework, Gannen a la valeur ON par défaut. Il peut être désactivé en définissant la valeur de Switch.System.Globalization.FormatJapaneseFirstYearAsANumber sur true.

Mises à jour publiées précédemment

Les clients doivent uniquement installer la dernière mise à jour répertoriée ci-dessus dans les articles de la Base de connaissances de la section de la version du .NET Framework pour les mises à jour de l’ère japonaise ou celles de Windows Update, windows Server Update Service (WSUS) ou Windows Update Catalog.

Ressources supplémentaires

• Gestion d’une nouvelle ère dans le calendrier japonais dans .NET - Blog .NET
• Utilisation du Registre pour tester la nouvelle ère japonaise sur Windows - Blog août 2018
• Gannen vs Ichinen - Blog de novembre 2018