Prepare seu aplicativo para a mudança de era japonesaPrepare your application for the Japanese era change

Observação

Em 1º de abril de 2019, o nome da nova era foi anunciado: Reiwa (令和).On April 1, 2019, the new era name was announced: Reiwa (令和). Em 25 de abril, a Microsoft lançou pacotes para diferentes sistemas operacionais do Windows contendo a chave do Registro atualizada com o nome da nova era.On April 25, Microsoft released packages for different Windows operating systems containing the updated registry key with the new era name. Atualize seu dispositivo e verifique seu Registro para ver se ele tem a nova chave e, em seguida, teste seu aplicativo.Update your device and check your registry to see if it has the new key, and then test your application. Confira este artigo de suporte para garantir que seu sistema operacional recebeu a chave do Registro atualizada.Check this support article to make sure your operating system should have received the updated registry key.

O calendário japonês é dividido em eras e, durante quase toda a era moderna da computação, estivemos na era Heisei. No entanto, em 1 de maio de 2019, uma nova era será iniciada.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. Como esta é a primeira mudança de era em décadas, os softwares compatíveis com o calendário japonês precisarão ser testados para se garantir que funcionarão corretamente quando a nova era começar.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.

Nas seções a seguir, você aprenderá o que pode fazer para preparar e testar seu aplicativo para a nova era.In the following sections, you will learn what you can do to prepare and test your application for the upcoming new era.

Observação

Recomendamos que você use um computador de teste para isso, pois as alterações feitas afetarão o comportamento de todo o computador.We recommend that you use a test machine for this, because the changes you make will impact the behavior of the entire machine.

Adicionar uma chave do Registro para a nova eraAdd a registry key for the new era

Observação

As instruções a seguir destinam-se a dispositivos que ainda não foram atualizados com a nova chave do Registro.The following instructions are meant for devices that have not yet been updated with the new registry key. Primeiro, verifique se o dispositivo contém a nova chave do Registro e, se não contiver, tente usar as instruções a seguir.First check if your device contains the new registry key, and if not, test using the following instructions.

É importante testar os problemas de compatibilidade antes da mudança de era. Você pode fazer isso agora mesmo usando o nome da nova era.It is important to test for compatibility problems before the era has changed, and you can do so now using the new era name. Para isso, adicione uma chave do Registro para a nova era usando o Editor do Registro:To do this, add a registry key for the new era using Registry Editor:

  1. Navegue até 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. Selecione Editar > Novo > Valor da cadeia e nomeie como 2019 05 01.Select Edit > New > String Value, and give it the name 2019 05 01.
  3. Clique com o botão direito do mouse na chave e selecione Modificar.Right-click the key and select Modify.
  4. No campo Dados de valor, insira 令和_令_Reiwa_R (você pode copiar e colar daqui para ficar mais fácil).In the Value data field, enter 令和_令_Reiwa_R (you can copy and paste from here to make it easier).

Confira Gerenciamento de eras para o calendário japonês para ler mais sobre o formato dessas chaves do Registro.See Era Handling for the Japanese Calendar to read more about the format for these registry keys.

Em 1º de abril de 2019, o nome da nova era foi anunciado.On April 1, 2019, the new era name was announced. Em 25 de abril, foi lançada uma atualização com uma nova chave do Registro para as versões com suporte do Windows contendo o nome, permitindo que você valide que seu aplicativo lidará com isso adequadamente.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. Esta atualização está sedo propagada para versões anteriores compatíveis do Windows 10, bem como do Windows 8 e 7.This update is being propagated to supported earlier releases of Windows 10, as well as Windows 8 and 7.

Você pode excluir a chave do Registro de espaço reservado depois que terminar de testar seu aplicativo.You can delete your placeholder registry key once you're finished testing your application. Isso garantirá que ele não interfira com a nova chave do Registro que será adicionada quando o Windows for atualizado.This will ensure it doesn't interfere with the new registry key that will be added when Windows is updated.

Alterar o formato do calendário de seu dispositivoChange your device's calendar format

Depois de adicionar a chave do Registro para a nova era, você precisará configurar seu dispositivo para usar o calendário japonês.Once you've added the registry key for the new era, you need to configure your device to use the Japanese calendar. Você não precisa ter um dispositivo no idioma japonês para fazer isso.You don't need to have a Japanese-language device to do this. Para testes extensivos, é interessante instalar o pacote de idioma japonês também, mas isso não é necessário para os testes básicos.For thorough testing, you may want to install the Japanese language pack as well, but it isn't required for basic testing.

Para configurar seu dispositivo para usar o calendário japonês:To configure your device to use the Japanese calendar:

  1. Acesse intl.cpl (pesquise na barra de pesquisa do Windows).Open intl.cpl (search for it from the Windows search bar).
  2. No menu suspenso Formato, selecione Japonês (Japão) .From the Format dropdown, select Japanese (Japan).
  3. Selecione Configurações adicionais.Select Additional settings.
  4. Selecione a guia Data.Select the Date tab.
  5. No menu suspenso Tipo de calendário, selecione 和暦 (wareki, o calendário japonês).From the Calendar type dropdown, select 和暦 (wareki, the Japanese calendar). Ele deve aparecer como a segunda opção.It should be the second option.
  6. Clique em OK.Click OK.
  7. Clique em OK na janela Região.Click OK in the Region window.

Agora, seu dispositivo deve estar configurado para usar o calendário japonês e ele refletirá a era que estiver no Registro.Your device should now be configured to use the Japanese calendar, and it will reflect whichever eras are in the registry. Abaixo está um exemplo do que você poderá ver agora no canto inferior direito da tela:Below is an example of what you might see now in the lower-right corner of the screen:

Data e hora no formato do calendário japonês

Ajuste o relógio de seu dispositivoAdjust your device's clock

Para testar se o seu aplicativo funciona com a nova era, é necessário avançar o relógio do computador para 1º de maio de 2019 ou depois.To test that your application works with the new era, you must advance your computer's clock to May 1, 2019 or later. As seguintes instruções são para Windows 10, mas o Windows 8 e 7 devem funcionar de forma semelhante:The following instructions are for Windows 10, but Windows 8 and 7 should work similarly:

  1. Clique com o botão direito do mouse na data e hora no canto inferior direito da tela.Right-click the date and time area in the lower-right corner of the screen.
  2. Selecione Ajustar data/hora.Select Adjust date/time.
  3. No aplicativo Configurações, em Alterar data e hora, selecione Alterar.In the Settings app, under Change date and time, select Change.
  4. Altere a data para 1º de maio de 2019 ou depois.Change the date to on or after May 1, 2019.

Observação

Talvez você não possa alterar a data com base nas configurações da organização. Se esse for o caso, fale com seu administrador. Como alternativa, você pode editar a chave do Registro de espaço reservado para ter uma data no passado.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.

Testar o aplicativoTest your application

Agora, teste como seu aplicativo lida com a nova era.Now, test out how your application handles the new era. Verifique os locais em que a data é exibida, como carimbos de data e hora e seletores de data.Check places where the date is displayed, such as timestamps and date pickers. Certifique-se de que a era esteja correta antes de 1º de maio de 2019 (Heisei, 平成) e depois de (Reiwa, 令和).Make sure that the era is correct before May 1, 2019 (Heisei, 平成) and after (Reiwa, 令和).

Gannen (元年)Gannen (元年)

Normalmente, o formato do calendário japonês é <Nome da era> <Ano da era> .The format for the Japanese calendar is generally <Era name> <Year of era>. Por exemplo, o ano 2018 é Heisei 30 (平成30年).For example, the year 2018 is Heisei 30 (平成30年). No entanto, o primeiro ano de uma era é especial; em vez de ser <Nome da era> 1, é <Nome da era> 元年 (gannen).However, the first year of an era is special; instead of being <Era name> 1, it is <Era name> 元年 (gannen). Portanto, o primeiro ano da era Heisei seria 平成元年 (Heisei gannen).So, the first year of the Heisei era would be 平成元年 (Heisei gannen). Certifique-se de que seu aplicativo lide corretamente com o primeiro ano da nova era e gere corretamente 令和元年.Make sure that your application properly handles the first year of the new era, and correctly outputs 令和元年.

Há várias APIs do WinRT, .NET e Win32 que serão atualizadas para lidarem com a mudança de era. Caso você as use, não precisará se preocupar.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. No entanto, mesmo se você depender inteiramente dessas APIs, ainda será uma boa ideia testar seu aplicativo e garantir que você obtenha o comportamento desejado, especialmente se estiver fazendo algo importante com elas, como análises.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.

Você pode acompanhar as atualizações do sistema operacional e do SDK em Atualizações para a mudança de era japonesa de maio de 2019.You can follow along with updates to the OS and SDKs at Updates for May 2019 Japan Era Change.

As seguintes APIs serão afetadas:The following APIs will be impacted:

WinRTWinRT

.NET.NET

Win32Win32

Consulte tambémSee also