針對日本紀元變更準備您的應用程式

注意

新的紀元年號已在 2019 年 4 月 1 日宣布：Reiwa (令和)。 在 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 日之前 (平成) 和之後 (令和) 的年號是正確的。

元年

日本曆的格式通常是 <紀元年號><紀元年份>。 例如，2018 年是平成 30 年。 不過，紀元的第一年有特殊格式；使用的不是 <紀元年號> 1 年，而是 <紀元年號> 元年。 因此，平成紀元的第一年會是「平成元年」。 請確定您的應用程式會適當處理新紀元的第一年，並正確輸出「令和元年」。

相關的 API

有幾個 WinRT、.NET 和 Win32 API 會更新來處理紀元變更，因此用到這些 API 的話，您應該不需要太過擔心。 不過，即使您可以完全依賴這些 API，最好還是要測試您的應用程式，確定看到您想要得到的行為，尤其是在您要用它們來執行任何特殊作業 (例如剖析) 的時候。

您可以透過因應日本紀元於 2019 年 5 月變更的更新深入了解 OS 與 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 header
  • GetDateFormatA 函式
  • GetDateFormatEx 函式
  • GetDateFormatW 函式
• winnls.h 標頭
  • EnumDateFormatsA 函式
  • EnumDateFormatsExA 函式
  • EnumDateFormatsExEx 函式
  • EnumDateFormatsExW 函式
  • EnumDateFormatsW 函式
  • GetCalendarInfoA 函式
  • GetCalendarInfoEx 函式
  • GetCalendarInfoW 函式

另請參閱

• 日本曆的紀元處理方式
• 日本曆的千禧年 (Y2K) 時刻
• 使用登錄來測試 Windows 上的新日本紀元
• 元年與第一年
• 因應日本紀元於 2019 年 5 月變更的更新
• 在 .NET 中處理日本曆的新紀元