일본의 시대 변경을 대비한 애플리케이션 준비Prepare your application for the Japanese era change

참고

2019년 4월 1일에 새로운 연호 레이와(令和)가 발표되었습니다.On April 1, 2019, the new era name was announced: Reiwa (令和). 4월 25일에 Microsoft는 업데이트된 레지스트리 키와 새로운 연호가 포함된 다른 Windows 운영 체제에 대한 패키지를 출시했습니다.On April 25, Microsoft released packages for different Windows operating systems containing the updated registry key with the new era name. 디바이스를 업데이트하고 레지스트리를 검사하여 새 키가 있는지 확인하고 애플리케이션을 테스트하세요.Update your device and check your registry to see if it has the new key, and then test your application. 이 지원 문서를 검토하여 현재 사용하는 운영 체제에서 업데이트된 레지스트리 키를 받았는지 확인하세요.Check this support article to make sure your operating system should have received the updated registry key.

일본력은 연호에 따라 구분되며, 현대 컴퓨팅의 대부분은 헤이세이 시대에 있었습니다. 그러나 2019년 5월 1일부로 새로운 연호가 사용됩니다.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. 연호가 바뀌는 것은 수십 년 만에 처음이기 때문에, 새 연호가 사용될 때 일본력을 지원하는 소프트웨어가 올바르게 작동하는지 테스트할 필요가 있습니다.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 the following sections, you will learn what you can do to prepare and test your application for the upcoming new era.

참고

여기서 변경하는 내용은 컴퓨터 전체의 동작에 영향을 주기 때문에 테스트 컴퓨터를 사용하는 것이 좋습니다.We recommend that you use a test machine for this, because the changes you make will impact the behavior of the entire machine.

새 연호를 위한 레지스트리 키 추가Add a registry key for the new era

참고

다음 지침은 아직 새 레지스트리 키로 업데이트되지 않은 디바이스를 위한 것입니다.The following instructions are meant for devices that have not yet been updated with the new registry key. 먼저 디바이스에 새 레지스트리 키가 있는지 확인하고, 없으면 다음 지침에 따라 테스트합니다.First check if your device contains the new registry key, and if not, test using the following instructions.

연호가 바뀌기 전에 호환성 문제를 테스트해야 하는데, 이제 새 연호를 사용하여 호환성을 테스트할 수 있습니다.It is important to test for compatibility problems before the era has changed, and you can do so now using the new era name. 그렇게 하려면 레지스트리 편집기를 사용하여 새 연호에 대한 레지스트리 키를 추가합니다.To do this, add a registry key for the new era using Registry Editor:

  1. 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. 편집 > 새로 만들기 > 문자열 값을 선택하고, 이름을 2019 05 01로 지정합니다.Select Edit > New > String Value, and give it the name 2019 05 01.
  3. 키를 마우스 오른쪽 단추로 클릭하고 수정을 선택합니다.Right-click the key and select Modify.
  4. 값 데이터 필드에 令和_令_Reiwa_R을 입력합니다. 여기서 복사하여 붙여넣으면 간편합니다.In the Value data field, enter 令和_令_Reiwa_R (you can copy and paste from here to make it easier).

이러한 레지스트리 키의 형식에 대한 자세한 내용은 일본력의 연호 처리를 참조하세요.See Era Handling for the Japanese Calendar to read more about the format for these registry keys.

2019년 4월 1일에 새 연호가 발표되었습니다.On April 1, 2019, the new era name was announced. 4월 25일에 이름을 포함하고 있는 지원되는 Windows 버전에 대한 새 레지스트리 키가 포함된 업데이트가 발표되었으며, 애플리케이션에서 이 업데이트를 올바르게 처리하는지 확인할 수 있습니다.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. 이 업데이트는 지원되는 이전 Windows 10 릴리스뿐 아니라 Windows 8 및 7에도 전파됩니다.This update is being propagated to supported earlier releases of Windows 10, as well as Windows 8 and 7.

애플리케이션 테스트가 완료되면 자리 표시자 레지스트리 키를 삭제할 수 있습니다.You can delete your placeholder registry key once you're finished testing your application. 이렇게 하면 Windows가 업데이트될 때 추가될 새 레지스트리 키와 겹치지 않습니다.This will ensure it doesn't interfere with the new registry key that will be added when Windows is updated.

디바이스의 달력 형식 변경Change your device's calendar format

새 연호의 레지스트리 키를 추가한 후에는 일본력을 사용하도록 디바이스를 구성해야 합니다.Once you've added the registry key for the new era, you need to configure your device to use the Japanese calendar. 이 작업을 수행하기 위해 일본어 디바이스가 필요한 것은 아닙니다.You don't need to have a Japanese-language device to do this. 철저한 테스트를 위해 일본어 팩을 설치할 수 있지만, 기본적인 테스트에는 없어도 괜찮습니다.For thorough testing, you may want to install the Japanese language pack as well, but it isn't required for basic testing.

일본력을 사용하도록 디바이스를 구성하려면 다음을 수행합니다.To configure your device to use the Japanese calendar:

  1. intl.cpl 파일을 엽니다(Windows 검색 창에서 검색).Open intl.cpl (search for it from the Windows search bar).
  2. 형식 드롭다운에서 일본어(일본) 를 선택합니다.From the Format dropdown, select Japanese (Japan).
  3. 추가 설정을 선택합니다.Select Additional settings.
  4. 날짜 탭을 선택합니다.Select the Date tab.
  5. 달력 타입 드롭다운에서 和暦(와레키, 화력)를 선택합니다.From the Calendar type dropdown, select 和暦 (wareki, the Japanese calendar). 두 번째 옵션입니다.It should be the second option.
  6. 확인을 클릭합니다.Click OK.
  7. 지역 창에서 확인을 클릭합니다.Click OK in the Region window.

이제 디바이스가 일본력을 사용하도록 구성되었으며, 레지스트리에 있는 연호가 반영됩니다.Your device should now be configured to use the Japanese calendar, and it will reflect whichever eras are in the registry. 아래는 화면의 오른쪽 아래 모서리에 보이는 내용의 예입니다.Below is an example of what you might see now in the lower-right corner of the screen:

일본력 형식의 날짜 및 시간

디바이스의 시계 조정Adjust your device's clock

애플리케이션이 새 연호에서 작동하는지 테스트하려면 컴퓨터의 시계를 2019년 5월 1일 이후로 조정해야 합니다.To test that your application works with the new era, you must advance your computer's clock to May 1, 2019 or later. 다음은 Windows 10 지침이지만, Windows 8 및 7에서도 비슷하게 작동합니다.The following instructions are for Windows 10, but Windows 8 and 7 should work similarly:

  1. 화면의 오른쪽 아래 모서리에 있는 날짜 및 시간 영역을 마우스 오른쪽 단추로 클릭합니다.Right-click the date and time area in the lower-right corner of the screen.
  2. 날짜/시간 조정을 선택합니다.Select Adjust date/time.
  3. 설정 앱의 날짜 및 시간 변경에서 변경을 선택합니다.In the Settings app, under Change date and time, select Change.
  4. 날짜를 2019년 5월 1일 이후로 변경합니다.Change the date to on or after May 1, 2019.

참고

조직 설정에 따라 날짜를 변경할 수 없는 경우가 있습니다. 이 경우 관리자에게 문의하세요. 또는 자리 표시자 레지스트리 키를 편집하여 이미 지나간 날짜를 사용할 수도 있습니다.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.

애플리케이션 테스트Test your application

이제 애플리케이션이 새 연호를 어떻게 처리하는지 테스트합니다.Now, test out how your application handles the new era. 타임스탬프 및 날짜 선택기처럼 날짜가 표시되는 곳을 확인합니다.Check places where the date is displayed, such as timestamps and date pickers. 2019년 5월 1일 전의 연호(Heisei, 平成)와 이후의 연호(Reiwa, 令和)가 올바른지 확인합니다.Make sure that the era is correct before May 1, 2019 (Heisei, 平成) and after (Reiwa, 令和).

간넨(元年)Gannen (元年)

일본력의 형식은 일반적으로 <연호><연도> 입니다.The format for the Japanese calendar is generally <Era name> <Year of era>. 예를 들어 2018년은 헤이세이 30년(平成30年)입니다.For example, the year 2018 is Heisei 30 (平成30年). 단, 첫 번째 해는 특별합니다. <연호> 1년 대신 <연호> 元年(간넨)을 사용합니다.However, the first year of an era is special; instead of being <Era name> 1, it is <Era name> 元年 (gannen). 따라서 헤이세이 시대의 첫 번째 해는 平成元年(헤이세이 간넨)입니다.So, the first year of the Heisei era would be 平成元年 (Heisei gannen). 애플리케이션이 새 시대의 첫 번째 해를 제대로 처리하여 令和元年을 출력하는지 확인합니다.Make sure that your application properly handles the first year of the new era, and correctly outputs 令和元年.

연호 변경을 처리하기 위해 여러 WinRT, .NET 및 Win32 API가 업데이트될 예정이므로 이러한 API를 사용하는 분들은 너무 걱정할 필요 없습니다.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. 그러나 이러한 API에 전적으로 의존하는 경우에도 애플리케이션을 테스트하여 원하는 대로 작동하는지 확인하는 것이 좋습니다. 특히 이러한 API로 구문 분석 같은 특별한 작업을 수행하는 경우에는 반드시 테스트해야 합니다.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.

2019년 5월 일본 연호 변경을 위한 업데이트에서 OS 및 SDK 업데이트를 추적할 수 있습니다.You can follow along with updates to the OS and SDKs at Updates for May 2019 Japan Era Change.

다음 API가 영향을 받습니다.The following APIs will be impacted:

WinRTWinRT

.NET.NET

Win32Win32

참고 항목See also