CKTIS / JavaScript
Intl.DateTimeFormat: consultar las opciones efectivas
Usa `resolvedOptions()` para saber qué ajustes de fecha y hora utiliza realmente una instancia, en lugar de deducirlos de los argumentos del constructor.
Versión: ECMAScript 2024 and the current web platform; runtime support varies
Sintaxis
formatter.resolvedOptions()Intl.DateTimeFormat.prototype.resolvedOptions es un método de instancia que no recibe argumentos. Cada llamada devuelve un objeto ordinario nuevo con los ajustes determinados al crear el formateador. Modificar el resultado no cambia el formateador. A diferencia de format(), no recibe una fecha ni produce texto formateado. Llamarlo sin vincularlo a la instancia o con un this incompatible, como {}, lanza un TypeError.
El resultado incluye locale (la etiqueta de idioma BCP 47 que se seleccionó), calendar, numberingSystem y timeZone. No es una copia de lo que se pasó al constructor: la negociación regional y los valores predeterminados pueden cambiar el resultado. Si no se especifica timeZone, el formateador toma al crearse la zona horaria predeterminada del entorno de ejecución. El identificador de zona puede normalizarse, así que no des por hecho que coincide exactamente con la cadena de entrada.
Sin dateStyle ni timeStyle, las propiedades como year, month y hour reflejan el patrón seleccionado; se omiten los componentes que no se usan. Con dateStyle o timeStyle, el resultado indica los estilos solicitados sin desglosarlos en componentes. Combinar un estilo con una opción explícita de componente, como hour, lanza un TypeError en el constructor.
Si el patrón incluye la hora, el resultado contiene hourCycle y el valor derivado hour12, incluso cuando timeStyle hace que no aparezca la propiedad hour. hour12 es true con h11 y h12, y false con h23 y h24. Si el patrón no incluye la hora, se omiten ambas propiedades. Al elegir el ciclo, la opción hour12 tiene prioridad sobre hourCycle y la extensión Unicode hc.
Usa el resultado para diagnosticar diferencias entre entornos de ejecución. La compatibilidad de las opciones y los datos regionales pueden variar, y unas opciones efectivas iguales no garantizan un texto formateado idéntico.
Ejemplos
const formatter = new Intl.DateTimeFormat("en-GB", {
timeZone: "UTC",
timeStyle: "short",
hour12: false,
});
const options = formatter.resolvedOptions();
console.log(options.timeZone);
console.log(options.timeStyle);
console.log(options.hour12);
console.log(Object.hasOwn(options, "hour"));
options.timeZone = "Asia/Tokyo";
console.log(formatter.resolvedOptions().timeZone);Resultado
UTC short false false UTC
El código imprime `UTC`, `short`, `false`, `false` y `UTC`, en ese orden. El primer `false` indica el formato de 24 horas; el segundo indica que no hay una propiedad propia `hour`. Asignar `Asia/Tokyo` solo modifica el objeto devuelto.
Lecciones relacionadas
- JavaScript · Lección 25 · Avanzado · Versión: 4
Fuentes
- ECMAScript® 2024 Internationalization API Specification — Intl.DateTimeFormat.prototype.resolvedOptions
- ECMAScript Internationalization API Specification (living draft) — Intl.DateTimeFormat.prototype.resolvedOptions
- ECMAScript Internationalization API Specification (living draft) — CreateDateTimeFormat