准备你的应用程序以进行日本纪元更改

注释

2019年4月1日，新纪元名称宣布：瑞瓦（令和）。 4 月 25 日，Microsoft 发布了针对不同 Windows 操作系统的包，其中包含更新的注册表项和新纪元名称。 更新设备并检查注册表，查看其是否具有新密钥，然后测试应用程序。 请查看此支持文章，确保操作系统已经收到更新的注册表项。

日本的日历分为不同的时代，在现代计算机领域，我们一直处于平成时代。然而，2019年5月1日，一个新的时代将开始。 因为这是几十年来第一次改变这个时代，因此需要测试支持日本日历的软件，以确保它在新时代开始时能够正常运行。

在以下部分中，你将了解如何为即将到来的新的时代做好准备和测试你的应用程序。

注释

建议为此使用测试计算机，因为所做的更改会影响整个计算机的行为。

为新纪元添加注册表项

注释

以下说明适用于尚未使用新注册表项更新的设备。 首先，检查设备是否包含新的注册表项，如果没有，请使用以下说明进行测试。

在纪元变更之前测试兼容性非常重要，现在可以使用新纪元名称进行测试。 若要执行此操作，请使用注册表编辑器为新纪元添加注册表项：

1. 导航到 Computer\HKEY_LOCAL_MACHINE\SYSTEM\CurrentControlSet\Control\Nls\Calendars\Japanese\Eras。
2. 依次选择“编辑”>“新建”>“字符串值”，并将其命名为“2019 05 01”。
3. 右键单击该项并选择“修改”。
4. 在“值数据”中，输入“令和_令_Reiwa_R”（可以从此处复制并粘贴以简化操作）。

有关这些注册表项的格式的详细信息，请参阅日本历的纪元处理。

2019年4月1日，新纪元名称公布。 4 月 25 日，我们发布了包含该名称的适用于受支持的 Windows 版本的新注册表项更新，这样你就可以验证应用程序是否可以正确处理它。 此更新将推送到受支持的早期版本的 Windows 10 以及 Windows 8 和 Windows 7。

完成应用程序测试后，你可以删除占位符注册表项。 这样可以确保它不会干扰更新 Windows 时要添加的新注册表项。

更改设备的日历格式

为新纪元添加注册表项后，需要将设备配置为使用日本历。 你无需拥有日语设备即可完成此操作。 为了进行彻底的测试，你可能还需要安装日语语言包，但基本测试不需要它。

若要将设备配置为使用日语日历，请执行以下作：

1. 打开 intl.cpl （从 Windows 搜索栏搜索它）。
2. 从“格式”下拉列表中，选择“日语”（日本）。
3. 选择“其他设置”。
4. 选择“日期”选项卡。
5. 在 “日历类型 ”下拉列表中，选择 “和暦 ”（wareki，日语日历）。 它应该是第二个选项。
6. 单击 “确定” 。
7. 在“区域”窗口中单击“确定”。

设备现在应配置为使用日语日历，它将反映注册表中存在哪个纪元。 下面是屏幕右下角现在可能看到的内容的示例：

调整设备的时钟

在 Windows 10 上

1. 右键单击屏幕右下角的日期和时间区域。
2. 选择“调整日期/时间”。
3. 在“设置”中，在 “更改日期和时间”下，选择“ 更改”。
4. 将日期更改为 2019 年 5 月 1 日或之后。

在 Windows 11 上

1. 右键单击屏幕右下角的日期和时间区域。
2. 选择“调整日期/时间”。
3. 在“设置”中， 在“手动设置日期和时间”下，选择“ 更改”。
4. 将日期更改为 2019 年 5 月 1 日或之后。

注释

当“自动设置时间”为“打开”时，可能无法更改日期和时间。

注释

你可能无法根据组织设置更改日期；如果发生此情况，请联系你的管理员。或者，你可以编辑占位符注册表项以设置过去的日期。

测试应用程序

现在，测试应用程序如何处理新时代。 检查显示日期的位置，例如时间戳和日期选取器。 确保纪元在 2019 年 5 月 1 日 (Heisei, 平成) 之前和 (Reiwa, 令和) 之后正确无误。

Gannen (元年)

日本日历的格式通常是 <纪元><年>。 例如，2018 年是 Heisei 30 (平成 30 年)。 但是，纪元的第一年很特殊；不是<纪元名称> 1，而是<纪元名称> 元年 (gannen)。 因此，平成时代的第一年将是平成元年（平成元年）。 请确保应用程序正常处理新纪元的第一年，并且正确输出令和元年。

相关 API

有几个 WinRT、.NET 和 Win32 API 将更新以处理纪元更改，因此如果使用它们，则不必担心太多。 但是，即使完全依赖于这些 API，进行测试以确保获得所需的效果仍然是个好主意，尤其是在进行诸如解析等特殊操作时。

你可以遵循 2019 年 5 月日本纪元更改的更新中的操作系统和 SDK 的更新。

以下 API 将受到影响：

WinRT

• Windows.Globalization 命名空间
  • Calendar 类
    • AddDays 方法
    • AddEras 方法
    • AddHours 方法
    • AddMinutes 方法
    • AddMonths 方法
    • AddNanoseconds 方法
    • AddPeriods 方法
    • AddSeconds 方法
    • AddWeeks 方法
    • AddYears 方法
    • Era 属性
    • EraAsString 方法
    • “FirstYearInThisEra” 属性
    • LastEra 属性
    • LastYearInThisEra 属性
    • NumberOfYearsInThisEra 属性
• Windows.Globalization.DateTimeFormatting 命名空间
  • DateTimeFormatter 类
    • Format 方法

.NET

• 系统命名空间
  • DateTime 结构
  • DateTimeOffset 结构
• System.Globalization 命名空间
  • Calendar 类
  • DateTimeFormatInfo 类
  • JapaneseCalendar 类
  • JapaneseLunisolarCalendar 类

Win32

• datetimeapi.h 标头
  • GetDateFormatA 函数
  • GetDateFormatEx 函数
  • GetDateFormatW 函数
• winnls.h 标头
  • EnumDateFormatsA 函数
  • EnumDateFormatsExA 函数
  • EnumDateFormatsExEx 函数
  • EnumDateFormatsExW 函数
  • EnumDateFormatsW 函数
  • GetCalendarInfoA 函数
  • GetCalendarInfoEx 函数
  • GetCalendarInfoW 函数

另请参阅

• 日本历的纪元处理
• 日本历的 Y2K 时刻
• 使用注册表在 Windows 上测试新的日本纪元
• 甘宁 vs 伊钦宁
• 2019 年 5 月日本纪元更改的更新
• 在 .NET 中处理日本历中的新纪元