Prepare seu aplicativo para a mudança de era japonesa

  • Artigo

Observação

Em 1º de abril de 2019, o nome da nova era foi anunciado: 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. Atualize seu dispositivo e verifique seu Registro para ver se ele tem a nova chave e, em seguida, teste seu aplicativo. Confira este artigo de suporte para garantir que seu sistema operacional recebeu a chave do Registro atualizada.

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. 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.

Nas seções a seguir, você aprenderá o que pode fazer para preparar e testar seu aplicativo para a nova 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.

Adicionar uma chave do Registro para a nova era

Observação

As instruções a seguir destinam-se a dispositivos que ainda não foram atualizados com a nova chave do Registro. Primeiro, verifique se o dispositivo contém a nova chave do Registro e, se não contiver, tente usar as instruções a seguir.

É importante testar os problemas de compatibilidade antes da mudança de era. Você pode fazer isso agora mesmo usando o nome da nova era. Para isso, adicione uma chave do Registro para a nova era usando o Editor do Registro:

  1. Navegue até Computer\HKEY_LOCAL_MACHINE\SYSTEM\CurrentControlSet\Control\Nls\Calendars\Japanese\Eras.
  2. Selecione Editar > Novo > Valor da cadeia e nomeie como 2019 05 01.
  3. Clique com o botão direito do mouse na chave e selecione Modificar.
  4. No campo Dados de valor, insira 令和_令_Reiwa_R (você pode copiar e colar daqui para ficar mais fácil).

Confira Gerenciamento de eras para o calendário japonês para ler mais sobre o formato dessas chaves do Registro.

Em 1º de abril de 2019, o nome da nova era foi anunciado. 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. Esta atualização está sedo propagada para versões anteriores compatíveis do Windows 10, Windows 8 e Windows 7.

Você pode excluir a chave do Registro de espaço reservado depois que terminar de testar seu aplicativo. Isso garantirá que ele não interfira com a nova chave do Registro que será adicionada quando o Windows for atualizado.

Alterar o formato do calendário de seu dispositivo

Depois de adicionar a chave do Registro para a nova era, você precisará configurar seu dispositivo para usar o calendário japonês. Você não precisa ter um dispositivo no idioma japonês para fazer isso. Para testes extensivos, é interessante instalar o pacote de idioma japonês também, mas isso não é necessário para os testes básicos.

Para configurar seu dispositivo para usar o calendário japonês:

  1. Acesse intl.cpl (pesquise na barra de pesquisa do Windows).
  2. No menu suspenso Formato, selecione Japonês (Japão).
  3. Selecione Configurações adicionais.
  4. Selecione a guia Data.
  5. No menu suspenso Tipo de calendário, selecione 和暦 (wareki, o calendário japonês). Ele deve aparecer como a segunda opção.
  6. Clique em OK.
  7. Clique em OK na janela Região.

Agora, seu dispositivo deve estar configurado para usar o calendário japonês e ele refletirá a era que estiver no Registro. Abaixo está um exemplo do que você poderá ver agora no canto inferior direito da tela:

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

Ajuste o relógio de seu dispositivo

No Windows 10

  1. Clique com o botão direito do mouse na data e hora no canto inferior direito da tela.
  2. Selecione Ajustar data/hora.
  3. No aplicativo Configurações, em Alterar data e hora, selecione Alterar.
  4. Altere a data para 1º de maio de 2019 ou depois.

No Windows 11

  1. Clique com o botão direito do mouse na data e hora no canto inferior direito da tela.
  2. Selecione Ajustar data/hora.
  3. No aplicativo Configurações, em Definir data e hora manualmente, selecione Alterar.
  4. Altere a data para 1º de maio de 2019 ou depois.

Observação

Talvez você não consiga alterar a data e a hora, quando "Definir hora automaticamente" estiver "ativado".

Observação

Talvez você não consiga alterar a data com base nas configurações da organização. Nesse caso, converse com o administrador. Como alternativa, você pode editar sua chave de registro de espaço reservado para ter uma data que já tenha passado.

Teste seu aplicativo

Agora, teste como seu aplicativo lida com a nova era. Verifique os locais em que a data é exibida, como carimbos de data e hora e seletores de data. Certifique-se de que a era esteja correta antes de 1º de maio de 2019 (Heisei, 平成) e depois de (Reiwa, 令和).

Gannen (元年)

Normalmente, o formato do calendário japonês é <Nome da era><Ano da era>. Por exemplo, o ano 2018 é Heisei 30 (平成30年). No entanto, o primeiro ano de uma era é especial; em vez de ser <Nome da era> 1, é <Nome da era> 元年 (gannen). Portanto, o primeiro ano da era Heisei seria 平成元年 (Heisei gannen). Certifique-se de que seu aplicativo lide corretamente com o primeiro ano da nova era e gere corretamente 令和元年.

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. 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.

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.

As seguintes APIs serão afetadas:

WinRT

.NET

Win32

Confira também