Preparar la aplicación para el cambio de la era japonesa

El calendario japonés se divide en eras y, durante la mayor parte de la época moderna de la informática, hemos estado dentro de la era Heisei; sin embargo, se iniciará una nueva era el 1 de mayo de 2019. Dado que es la primera vez en décadas que hay un cambio de era, el software compatible con el calendario japonés deberá probarse para asegurar que funcionará correctamente cuando se inicie la nueva era.

En las secciones siguientes, aprenderás lo que puedes hacer para preparar y probar la aplicación para la nueva era que está al llegar.

Agregar una clave del Registro para la nueva era

Es importante comprobar si hay problemas de compatibilidad antes de que cambie la era, y ahora puedes hacerlo con el nombre de la nueva era. Para ello, agrega una clave del Registro para la nueva era con Editor del Registro:

1. Navega a Computer\HKEY_LOCAL_MACHINE\SYSTEM\CurrentControlSet\Control\Nls\Calendars\Japanese\Eras.
2. Seleccione Editar > Nuevo > Valor de cadena y asígnele el nombre 01 05 2019.
3. Haz clic con el botón derecho en la clave y selecciona Modificar.
4. En el campo Datos del valor, escribe 令和_令_Reiwa_R (puedes copiar y pegar desde aquí para que sea más fácil).

Consulta Tratamiento de las eras del calendario japonés para obtener más información sobre el formato de estas claves del Registro.

El 1 de abril de 2019 se anunció el nombre de la nueva era. El 25 de abril se publicó una actualización con una nueva clave del Registro para las versiones compatibles de Windows que contiene el nombre, lo que te permite validar que la aplicación la controla correctamente. Esta actualización se propagará a las versiones anteriores de Windows 10 compatibles, así como a Windows 8 y Windows 7.

Puedes eliminar la clave del Registro de marcador de posición cuando hayas terminado de probar la aplicación. Esto garantiza que no interfiera con la nueva clave del Registro que se agregará al actualizar Windows.

Cambiar el formato de calendario del dispositivo

Una vez que hayas agregado la clave del Registro de la nueva era, hay que configurar el dispositivo para usar el calendario japonés. No necesitas un dispositivo con idioma japonés para hacerlo. Para realizar pruebas exhaustivas, puedes instalar también el paquete de idioma japonés, pero no es necesario para las pruebas básicas.

Para configurar el dispositivo para usar el calendario japonés:

1. Abre intl.cpl (búscalo desde la barra de búsqueda de Windows).
2. Desde el menú desplegable Formato, selecciona Japonés (Japón).
3. Seleccione Configuración adicional.
4. Selecciona la pestaña Fecha.
5. En el menú desplegable Tipo de calendario, selecciona 和暦 (wareki, el calendario japonés). Debería ser la segunda opción.
6. Haga clic en Aceptar.
7. Haz clic en Aceptar, en la ventana Región.

Ahora, el dispositivo debería quedar configurado para usar el calendario japonés y reflejará todas las eras que haya en el Registro. A continuación se incluye un ejemplo de lo que pudiera aparecer en la esquina inferior derecha de la pantalla:

Ajustar el reloj del dispositivo

En Windows 10

1. Haz clic con el botón derecho en el área de fecha y hora de la esquina inferior derecha de la pantalla.
2. Selecciona Ajustar fecha/hora.
3. En la aplicación Configuración, en Cambiar fecha y hora, selecciona Cambiar.
4. Cambia la fecha al 1 de mayo de 2019 o a otra fecha posterior.

En Windows 11

1. Haz clic con el botón derecho en el área de fecha y hora de la esquina inferior derecha de la pantalla.
2. Selecciona Ajustar fecha/hora.
3. En la aplicación Configuración, en Establecer la fecha y la hora manualmente, seleccione Cambiar.
4. Cambia la fecha al 1 de mayo de 2019 o a otra fecha posterior.

Prueba de la aplicación

Ahora, prueba cómo la aplicación controla la nueva era. Comprueba los lugares donde se muestra la fecha, como selectores de fecha y marcas de tiempo. Asegúrate de que la era sea correcta antes del 1 de mayo de 2019 (Heisei, 平成) y después (Reiwa, 令和).

Gannen (元年)

El formato para el calendario japonés suele ser <Nombre de la era><Año de la era>. Por ejemplo, el año 2018 es Heisei 30 (平成30年). Sin embargo, el primer año de cada era es especial; en lugar de ser <Nombre de la era> 1, es <Nombre de la era> 元年 (gannen). Por lo tanto, el primer año de la era Heisei sería 平成元年 (Heisei gannen). Asegúrate de que tu aplicación maneje correctamente el primer año de la nueva era y presente correctamente 令和元年.

API relacionadas

Hay varias API de WinRT, .NET y Win32 que se van a actualizar para manejar el cambio de era, por lo que, si las usas, no deberías tener demasiados problemas. Sin embargo, aunque confíes totalmente en estas API, sigue siendo una buena idea que pruebes la aplicación y te asegures de obtener el comportamiento buscado, especialmente si haces algo especial con ellas, como analizar.

Puedes seguir con las actualizaciones para el sistema operativo y el SDK en Actualizaciones para el cambio de era japonesa de mayo de 2019.

Se verán afectadas las API siguientes:

WinRT

• Windows.Globalization Namespace
  • Clase 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
    • Propiedad Era
    • Método EraAsString
    • Propiedad FirstYearInThisEra
    • Propiedad LastEra
    • Propiedad LastYearInThisEra
    • Propiedad NumberOfYearsInThisEra
• Espacio de nombres Windows.Globalization.DateTimeFormatting
  • Clase DateTimeFormatter
    • Método Format

.NET

• Espacio de nombres System
  • Estructura DateTime
  • Estructura DateTimeOffset
• Espacio de nombres System.Globalization
  • Clase Calendar
  • Clase DateTimeFormatInfo
  • Clase JapaneseCalendar
  • Clase JapaneseLunisolarCalendar

Win32

• Encabezado datetimeapi.h
  • Función GetDateFormatA
  • Función GetDateFormatEx
  • Función GetDateFormatW
• Encabezado winnls.h
  • Función EnumDateFormatsA
  • Función EnumDateFormatsExA
  • Función EnumDateFormatsExEx
  • Función EnumDateFormatsExW
  • Función EnumDateFormatsW
  • Función GetCalendarInfoA
  • Función GetCalendarInfoEx
  • Función GetCalendarInfoW

Consulta también

• Tratamiento de las eras en el calendario japonés
• Momento Y2K del calendario japonés
• Uso del Registro para probar la nueva era japonesa en Windows
• Gannen frente a Ichinen
• Actualizaciones para el cambio de era japonesa de mayo de 2019
• Manejo de una nueva era del calendario japonés en .NET