Vorbereiten Ihrer Anwendung auf den Wechsel der japanischen ÄraPrepare your application for the Japanese era change

Hinweis

Am 1. April 2019 wurde der Name der neuen Ära verkündet: Reiwa (令和).On April 1, 2019, the new era name was announced: Reiwa (令和). Am 25. April veröffentlichte Microsoft Pakete für verschiedene Windows-Betriebssysteme mit dem aktualisierten Registrierungsschlüssel mit dem Namen der neuen Ära.On April 25, Microsoft released packages for different Windows operating systems containing the updated registry key with the new era name. Aktualisieren Sie Ihr Gerät, und überprüfen Sie die Registrierung, um festzustellen, ob sie den neuen Schlüssel aufweist: Testen Sie anschließend Ihre Anwendung.Update your device and check your registry to see if it has the new key, and then test your application. Sehen Sie diesen Supportartikel ein, um sich zu vergewissern, dass Ihr Betriebssystem den aktualisierten Registrierungsschlüssel empfangen haben sollte.Check this support article to make sure your operating system should have received the updated registry key.

Der japanische Kalender ist in Ären unterteilt, und für den Großteil des modernen Computerzeitalters haben wir uns in der Heisei-Ära befunden. Am 1. Mai 2019 beginnt jedoch eine neue Ära.The Japanese calendar is divided into eras, and for most of the modern age of computing, we've been in the Heisei era; however, on May 1, 2019, a new era will begin. Da dies das erste Mal seit Jahrzehnten ist, dass ein Wechsel der Ären stattfindet, muss Software, die den japanischen Kalender unterstützt, getestet werden, um sicherzustellen, dass sie zu Beginn der neuen Ära ordnungsgemäß funktioniert.Because this is the first time in decades for an era to change, software that supports the Japanese calendar will need to be tested to ensure it will function properly when the new era begins.

In den folgenden Abschnitten erfahren Sie, was Sie tun können, um Ihre Anwendung auf die neue Ära vorzubereiten und zu testen.In the following sections, you will learn what you can do to prepare and test your application for the upcoming new era.

Hinweis

Wir empfehlen, hierfür eine Testmaschine zu verwenden, da die von Ihnen vorgenommenen Änderungen das Verhalten des gesamten Computers beeinflussen.We recommend that you use a test machine for this, because the changes you make will impact the behavior of the entire machine.

Hinzufügen eines Registrierungsschlüssels für die neue ÄraAdd a registry key for the new era

Hinweis

Die folgenden Anweisungen beziehen sich auf Geräte, die noch nicht mit dem neuen Registrierungsschlüssel aktualisiert wurden.The following instructions are meant for devices that have not yet been updated with the new registry key. Überprüfen Sie zunächst, ob Ihr Gerät den neuen Registrierungsschlüssel enthält. Falls dies nicht der Fall ist, führen Sie entsprechend den folgenden Anweisungen einen Test aus.First check if your device contains the new registry key, and if not, test using the following instructions.

Es ist wichtig, auf Kompatibilitätsprobleme zu testen, bevor der Ärawechsel stattgefunden hat. Dies können Sie nun mithilfe des Namens der neuen Ära vornehmen.It is important to test for compatibility problems before the era has changed, and you can do so now using the new era name. Fügen Sie dazu mithilfe des Registrierungs-Editors einen Registrierungsschlüssel für die neue Ära hinzu:To do this, add a registry key for the new era using Registry Editor:

  1. Navigieren Sie zu Computer\HKEY_LOCAL_MACHINE\SYSTEM\CurrentControlSet\Control\Nls\Calendars\Japanese\Eras.Navigate to Computer\HKEY_LOCAL_MACHINE\SYSTEM\CurrentControlSet\Control\Nls\Calendars\Japanese\Eras.
  2. Wählen Sie Bearbeiten > Neu > Zeichenfolge aus, und weisen Sie ihr den Namen 2019 05 01 zu.Select Edit > New > String Value, and give it the name 2019 05 01.
  3. Klicken Sie mit der rechten Maustaste auf den Schlüssel, und wählen Sie Ändern aus.Right-click the key and select Modify.
  4. Geben Sie im Feld Wertdaten den Wert 令和_令_Reiwa_R ein (Sie können den Wert der Einfachheit halber von hier kopieren und einfügen).In the Value data field, enter 令和_令_Reiwa_R (you can copy and paste from here to make it easier).

Weitere Informationen finden Sie unter Umgang mit Ären im japanischen Kalender, wo Sie weitere Einzelheiten über das Format für diese Registrierungsschlüssel erhalten.See Era Handling for the Japanese Calendar to read more about the format for these registry keys.

Am 1. April 2019 wurde der Name der neuen Ära verkündet.On April 1, 2019, the new era name was announced. Am 25. April wurde ein Update mit einem neuen Registrierungsschlüssel für unterstützte Windows-Versionen mit dem Namen veröffentlicht. Dies ermöglicht es Ihnen zu überprüfen, ob er von Ihrer Anwendung ordnungsgemäß verarbeitet wird.On April 25, an update with a new registry key for supported Windows versions containing the name was released, allowing you to validate that your application handles it properly. Dieses Update wird für unterstützte frühere Versionen von Windows 10 sowie Windows 8 und 7 bereitgestellt.This update is being propagated to supported earlier releases of Windows 10, as well as Windows 8 and 7.

Nachdem Sie das Testen Ihrer Anwendung abgeschlossen haben, können Sie den Platzhalter-Registrierungsschlüssel löschen.You can delete your placeholder registry key once you're finished testing your application. Auf diese Weise wird sichergestellt, dass der neue Registrierungsschlüssel, der bei der Aktualisierung von Windows hinzugefügt wird, nicht beeinträchtigt wird.This will ensure it doesn't interfere with the new registry key that will be added when Windows is updated.

Ändern des Kalenderformats Ihres GerätsChange your device's calendar format

Nachdem Sie den Registrierungsschlüssel für die neue Ära hinzugefügt haben, müssen Sie Ihr Gerät für die Verwendung des japanischen Kalenders konfigurieren.Once you've added the registry key for the new era, you need to configure your device to use the Japanese calendar. Sie benötigen dazu kein Gerät in japanischer Sprache.You don't need to have a Japanese-language device to do this. Um gründliche Tests durchzuführen, können Sie auch das japanische Language Pack installieren; dies ist für die grundlegenden Tests jedoch nicht erforderlich.For thorough testing, you may want to install the Japanese language pack as well, but it isn't required for basic testing.

So konfigurieren Sie Ihr Gerät für die Verwendung des japanischen Kalenders:To configure your device to use the Japanese calendar:

  1. Öffnen Sie intl.cpl (suchen Sie in der Windows-Suchleiste danach).Open intl.cpl (search for it from the Windows search bar).
  2. Wählen Sie in der Dropdownliste Format den Eintrag Japanisch (Japan) aus.From the Format dropdown, select Japanese (Japan).
  3. Wählen Sie Zusätzliche Einstellungen aus.Select Additional settings.
  4. Wählen Sie die Registerkarte Datum aus.Select the Date tab.
  5. Wählen Sie in der Dropdownliste Kalendertyp den Eintrag 和暦 (Wareki, den japanischen Kalender) aus.From the Calendar type dropdown, select 和暦 (wareki, the Japanese calendar). Es sollte die zweite Option sein.It should be the second option.
  6. Klicken Sie auf OK.Click OK.
  7. Klicken Sie im Fenster Region auf OK.Click OK in the Region window.

Ihr Gerät sollte nun für die Verwendung des japanischen Kalenders konfiguriert sein und die in der Registrierung eingetragenen Ären anzeigen.Your device should now be configured to use the Japanese calendar, and it will reflect whichever eras are in the registry. Nachstehend sehen Sie ein Beispiel dafür, was Sie möglicherweise in der rechten unteren Ecke des Bildschirms sehen:Below is an example of what you might see now in the lower-right corner of the screen:

Datum und Uhrzeit im japanischen Kalenderformat

Einstellen der Uhr des GerätsAdjust your device's clock

Um zu überprüfen, ob Ihre Anwendung mit der neuen Ära funktioniert, müssen Sie die Uhr Ihres Computers auf den 1. Mai 2019 oder auf ein späteres Datum stellen.To test that your application works with the new era, you must advance your computer's clock to May 1, 2019 or later. Die folgenden Anweisungen gelten für Windows 10. Windows 8 und 7 sollten jedoch ähnlich funktionieren:The following instructions are for Windows 10, but Windows 8 and 7 should work similarly:

  1. Klicken Sie mit der rechten Maustaste auf den Datums-/Uhrzeitbereich in der unteren rechten Ecke des Bildschirms.Right-click the date and time area in the lower-right corner of the screen.
  2. Wählen Sie Datum/Uhrzeit ändern aus.Select Adjust date/time.
  3. Wählen Sie in der Einstellungs-App unter Datum und Uhrzeit ändern die Option Ändern aus.In the Settings app, under Change date and time, select Change.
  4. Ändern Sie das Datum auf den 1. Mai 2019 oder später.Change the date to on or after May 1, 2019.

Hinweis

Sie können das Datum gemäß den Organisationseinstellungen möglicherweise nicht ändern. Wenn dies der Fall ist, wenden Sie sich an Ihren Administrator. Sie können jedoch auch den Platzhalter-Registrierungsschlüssel bearbeiten, sodass Sie über ein bereits akzeptiertes Datum verfügen.You may not be able to change the date based on organization settings; if this is the case, talk to your admin. Alternatively, you can edit your placeholder registry key to have a date that has already passed.

Testen Ihrer AnwendungTest your application

Testen Sie nun, wie Ihre Anwendung mit der neuen Ära umgeht.Now, test out how your application handles the new era. Überprüfen Sie Stellen, an denen das Datum angezeigt wird, z. B. bei Zeitstempeln und in Datumsauswahlfeldern.Check places where the date is displayed, such as timestamps and date pickers. Stellen Sie sicher, dass die Ära vor dem 1. Mai 2019 (Heisei, 平成) und danach (Reiwa, 令和) korrekt ist.Make sure that the era is correct before May 1, 2019 (Heisei, 平成) and after (Reiwa, 令和).

Gannen (元年)Gannen (元年)

Das Format für den japanischen Kalender lautet generell <Name der Ära> <Jahr der Ära> .The format for the Japanese calendar is generally <Era name> <Year of era>. Das Jahr 2018 ist z. B. Heisei 30 (平成30年).For example, the year 2018 is Heisei 30 (平成30年). Das erste Jahr einer Ära ist jedoch ein Sonderfall. Anstelle von <Name der Ära> 1 hat es das Format <Name der Ära> 元年 (Gannen).However, the first year of an era is special; instead of being <Era name> 1, it is <Era name> 元年 (gannen). Dementsprechend wäre das erste Jahr der Heisei-Ära 平成元年 (Heisei Gannen).So, the first year of the Heisei era would be 平成元年 (Heisei gannen). Vergewissern Sie sich, dass Ihre Anwendung das erste Jahr der neuen Ära richtig verarbeitet und ordnungsgemäß 令和元年 ausgibt.Make sure that your application properly handles the first year of the new era, and correctly outputs 令和元年.

Es gibt mehrere WinRT-, .NET- und Win32-APIs, die aktualisiert werden, um mit dem Wechsel der Ären umgehen zu können. Sie müssen sich daher keine Sorgen machen, sofern Sie diese APIs verwenden.There are several WinRT, .NET, and Win32 APIs that will be updated to handle the era change, so if you use them, you shouldn't have to worry too much. Auch wenn Sie sich vollständig auf diese APIs verlassen, ist es dennoch eine gute Idee, Ihre Anwendung zu testen und sicherzustellen, dass sie sich erwartungsgemäß verhält, insbesondere, wenn Sie sie für etwas Besonderes wie Parsing verwenden.However, even if you do rely entirely on these APIs, it's still a good idea to test your application and make sure you get the desired behavior, especially if you are doing anything special with them like parsing.

Aktualisierungen des Betriebssystems und der SDKs finden Sie unter Updates für den Wechsel der japanischen Ära im Mai 2019.You can follow along with updates to the OS and SDKs at Updates for May 2019 Japan Era Change.

Die folgenden APIs werden betroffen sein:The following APIs will be impacted:

WinRTWinRT

.NET.NET

Win32Win32

Weitere InformationenSee also