Prepare seu aplicativo para a mudança de era japonesa

O calendário japonês é dividido em eras e, durante a maior parte da era moderna da computação, estivemos na era Heisei; no entanto, em 1º de maio de 2019, uma nova era começará. Como esta é a primeira vez em décadas para uma era mudar, o software que dá suporte ao calendário japonês precisará ser testado para garantir que ele funcione 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 próxima nova era.

Adicionar uma chave do Registro para a nova era

É importante testar problemas de compatibilidade antes que a era seja alterada e você pode fazer isso agora usando o nome da nova era. Para fazer 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 > Nova > Valor de Cadeia de Caracterese dê a ele o nome de 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 facilitar).

Consulte o Tratamento de Era para o Calendário Japonês para ler mais sobre o formato dessas chaves de registro.

Em 1º de abril de 2019, o nome da nova era foi anunciado. Em 25 de abril, uma atualização com uma nova chave do Registro para versões com suporte do Windows que contêm o nome foi lançada, permitindo que você valide se seu aplicativo a manipula corretamente. Essa atualização está sendo propagada para versões anteriores com suporte do Windows 10, bem como windows 8 e Windows 7.

Você pode excluir a chave de registro temporária depois de terminar de testar seu aplicativo. Isso garantirá que ela não interfira na nova chave do Registro que será adicionada quando o Windows for atualizado.

Alterar o formato de calendário do 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 em japonês para fazer isso. Para testes completos, talvez você queira instalar o pacote de idiomas japonês também, mas ele não é necessário para testes básicos.

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

1. Abra intl.cpl (pesquise na barra de pesquisa do Windows).
2. Na lista suspensa Format, selecione japonês (Japão).
3. Selecione Configurações adicionais.
4. Selecione a guia de Data.
5. Na lista suspensa do tipo de calendário , selecione 和暦 (wareki, o calendário japonês). Deve ser a segunda opção.
6. Clique em OK.
7. Clique OK na janela Região.

Seu dispositivo agora deve ser configurado para usar o calendário japonês e refletirá as eras que estão no registro. Veja abaixo um exemplo do que você pode ver agora no canto inferior direito da tela:

Ajustar o relógio do dispositivo

No Windows 10

1. Clique com o botão direito do mouse na área de 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 posterior.

No Windows 11

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

Teste seu aplicativo

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

Gannen (元年)

O formato do calendário japonês geralmente é <Nome da Era><Ano da Era>. Por exemplo, o ano de 2018 é Heisei 30 (平成30年). No entanto, o primeiro ano de uma era é especial; ao invés de ser <Nome da Era> 1, é denominado <Nome da Era> 元年 (gannen). Assim, o primeiro ano da era Heisei seria 平成元年 (Heisei gannen). Certifique-se de que seu aplicativo manipule corretamente o primeiro ano da nova era e exiba corretamente 令和元年.

APIs relacionadas

Há várias APIs WinRT, .NET e Win32 que serão atualizadas para lidar com a alteração de era, portanto, se você usá-las, não precisará se preocupar muito. No entanto, mesmo que você dependa inteiramente dessas APIs, ainda é uma boa ideia testar seu aplicativo e garantir que você obtenha o comportamento desejado, especialmente se estiver fazendo algo especial com elas, como analisar.

Você pode acompanhar as atualizações do sistema operacional e dos SDKs no Updates de maio de 2019 no Japan Era Change.

As seguintes APIs serão afetadas:

WinRT

• Namespace Windows.Globalization
  • Classe de Calendário
    • 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
    • Era Propriedade
    • Método EraAsString
    • Propriedade FirstYearInThisEra
    • Propriedade LastEra
    • propriedade LastYearInThisEra
    • Propriedade NúmeroDeAnosNestaEra
• Namespace Windows.Globalization.DateTimeFormatting
  • de classe DateTimeFormatter
    • Método de Formatação

.REDE

• namespace do sistema
  • Estrutura de DataHora
  • estrutura DateTimeOffset
• Namespace System.Globalization
  • Classe de Calendário
  • classe DateTimeFormatInfo
  • classe JapaneseCalendar
  • Classe JapaneseLunisolarCalendar

Win32

• cabeçalho datetimeapi.h
  • função GetDateFormatA
  • função GetDateFormatEx
  • função GetDateFormatW
• cabeçalho winnls.h
  • função EnumDateFormatsA
  • função "EnumDateFormatsExA"
  • função EnumDateFormatsExEx
  • função EnumDateFormatsExW
  • função EnumDateFormatsW
  • função GetCalendarInfoA
  • Função GetCalendarInfoEx
  • A função GetCalendarInfoW

Consulte também

• Manipulação da era para o calendário japonês
• O momento Y2K do calendário japonês
• Usando o Registro para Testar a Nova Era Japonesa no Windows
• Gannen vs Ichinen
• atualizações para maio de 2019 no Japão,
• Lidando com uma nova era no calendário japonês no .NET