為日文時代變更準備您的應用程式

備註

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 日之前（海西、平成）和之後（雷瓦、令和）之前，這個時代是正確的。

甘寧 （元年）

日曆的格式通常為日本年曆 <紀元><年>。 例如，2018 年是 平成 30 （平成30年）。 然而，一個時代的第一年是特別的：而不是 <紀元名稱> 1，它是 <紀元名稱> 元年 (gannen)。 因此，平成時代的第一年將是平成元年（Heisei 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 方法
    • 時代屬性
    • EraAsString 方法
    • FirstYearInThisEra 屬性
    • LastEra 屬性
    • LastYearInThisEra 屬性
    • NumberOfYearsInThisEra 屬性
• Windows.Globalization.DateTimeFormatting 命名空間
  • DateTimeFormatter 類別
    • 格式化方法

.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 Ichinen
• 2019年5月日本時代變更更新
• 在 .NET 中處理日本曆的新紀元