Idiomas e formatação

Os documentos são formatados para quem os lê. Envie um locale em cada geração, e os três filtros de formatação o seguem.

Escolher o idioma

O locale é uma tag BCP 47: en-US, pt-BR, de-DE, ja-JP, ar-EG. Vale o primeiro destes que estiver definido:

1. o locale da requisição de geração,
2. o locale do template salvo,
3. o idioma padrão da sua conta (em Settings).

Uma tag inválida é um 400.

Filtros

currency

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

O valor é um número ou uma string numérica; prefira a string ("1234.50") para evitar surpresas com ponto flutuante. O código é uma moeda ISO 4217. Os valores são arredondados para os dígitos da própria moeda: dois na maioria, nenhum para o iene, três para o dinar kuwaitiano.

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 os dígitos e usa o separador decimal do idioma. digits arredonda e completa com exatamente essa quantidade de casas.

date

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

O valor é uma data ISO (2024-03-15) ou um instante completo (2024-03-15T10:00:00Z); só a parte da data é usada. style é short, medium (padrão) ou long.

Idioma	long
en-US	March 15, 2024
pt-BR	15 de março de 2024

Trocar o idioma em um ponto só

Todo filtro aceita locale=, para um valor que deve ser lido igual em toda geração:

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

Escritas e fontes

Escritas da direita para a esquerda, como o árabe e o hebraico, e escritas como devanágari e tailandês, são formadas corretamente. Garanta que haja uma fonte que cubra a escrita; veja Fontes.