Prepare seu aplicativo para a mudança de era japonesa
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:
- Navegue até Computer\HKEY_LOCAL_MACHINE\SYSTEM\CurrentControlSet\Control\Nls\Calendars\Japanese\Eras.
- Selecione Editar > Novo > Valor da cadeia e nomeie como 2019 05 01.
- Clique com o botão direito do mouse na chave e selecione Modificar.
- 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:
- Acesse intl.cpl (pesquise na barra de pesquisa do Windows).
- No menu suspenso Formato, selecione Japonês (Japão).
- Selecione Configurações adicionais.
- Selecione a guia Data.
- No menu suspenso Tipo de calendário, selecione 和暦 (wareki, o calendário japonês). Ele deve aparecer como a segunda opção.
- Clique em OK.
- 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:
Ajuste o relógio de seu dispositivo
No Windows 10
- Clique com o botão direito do mouse na data e hora no canto inferior direito da tela.
- Selecione Ajustar data/hora.
- No aplicativo Configurações, em Alterar data e hora, selecione Alterar.
- Altere a data para 1º de maio de 2019 ou depois.
No Windows 11
- Clique com o botão direito do mouse na data e hora no canto inferior direito da tela.
- Selecione Ajustar data/hora.
- No aplicativo Configurações, em Definir data e hora manualmente, selecione Alterar.
- 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 令和元年.
APIs relacionadas
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
- Namespace Windows.Globalization
- Classe Calendar
- Método AddDays
- Método AddEras
- Método AddHours
- Método AddMinutes
- Método AddMonths
- Método AddNanoseconds
- Método AddPeriods
- Método AddSeconds
- Método AddWeeks
- Método AddYears
- Propriedade Era
- Método EraAsString
- Propriedade FirstYearInThisEra
- Propriedade LastEra
- Propriedade LastYearInThisEra
- Propriedade NumberOfYearsInThisEra
- Classe Calendar
- Namespace Windows.Globalization.DateTimeFormatting
.NET
Win32
Confira também
Windows developer