Idiomas y formato

Los documentos se formatean para quien los lee. Envía un locale con cada generación, y los tres filtros de formato lo siguen.

Elegir el idioma

El locale es una etiqueta BCP 47: en-US, es-ES, de-DE, ja-JP, ar-EG. Vale el primero de estos que esté definido:

1. el locale de la petición de generación,
2. el locale de la plantilla guardada,
3. el idioma por defecto de tu cuenta (en Settings).

Una etiqueta inválida es un 400.

Filtros

currency

{{ total | currency(code="EUR") }}

El importe es un número o una cadena numérica; usa la cadena ("1234.50") para evitar sorpresas con la coma flotante. El código es una moneda ISO 4217. Los importes se redondean a los decimales de la propia moneda: dos en la mayoría, ninguno para el yen, tres para el dinar kuwaití.

Idioma	1234.5 como USD / BRL / EUR
en-US	$1,234.50
pt-BR	R$ 1.234,50 (BRL)
de-DE	1.234,50 € (EUR)

number

{{ qty | number }}
{{ ratio | number(digits=2) }}

Agrupa los dígitos y usa el separador decimal del idioma. digits redondea y completa con exactamente esa cantidad de decimales.

date

{{ issued | date(style="long") }}

El valor es una fecha ISO (2024-03-15) o una marca de tiempo completa (2024-03-15T10:00:00Z); solo se usa la parte de la fecha. style es short, medium (por defecto) o long.

Idioma	long
en-US	March 15, 2024
es-ES	15 de marzo de 2024

Cambiar el idioma en un solo punto

Todos los filtros aceptan locale=, para una cifra que debe leerse igual en cada generación:

{{ total | currency(code="USD", locale="en-US") }}

Escrituras y fuentes

Las escrituras de derecha a izquierda, como el árabe y el hebreo, y escrituras como el devanagari y el tailandés, se forman correctamente. Asegúrate de que haya una fuente que cubra la escritura; consulta Fuentes.