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

注意

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)。 因此，平成纪元的第一年将为平成元年 (Heisei gannen)。 请确保应用程序正常处理新纪元的第一年，并且正确输出令和元年。

相关 API

有几个 WinRT、.NET 和 Win32 API，将更新这些 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

• System 命名空间
  • 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 上测试新的日本纪元
• Gannen 与 Ichinen
• 2019 年 5 月日本纪元更改的更新
• Handling a new era in the Japanese calendar in .NET（在 .NET 中处理日本历中的新纪元）