O Angular usa o identificador de locale Unicode (Unicode locale ID) para encontrar os dados corretos de locale para internacionalização de strings de texto.
Unicode locale ID
Um locale ID está em conformidade com a especificação principal do Unicode Common Locale Data Repository (CLDR). Para mais informações sobre locale IDs, veja [Identificadores de Idioma e Locale do Unicode][UnicodeCldrDevelopmentCoreSpecificationLocaleIDs].
CLDR e Angular usam tags BCP 47 como base para o locale ID
Um locale ID especifica o idioma, país e um código opcional para variantes ou subdivisões adicionais.
Um locale ID consiste do identificador de idioma, um caractere de hífen (-) e a extensão de locale.
{language_id}-{locale_extension}HELPFUL: Para traduzir com precisão seu projeto Angular, você deve decidir quais idiomas e locales você está mirando para internacionalização.
Muitos países compartilham o mesmo idioma, mas diferem no uso. As diferenças incluem gramática, pontuação, formatos para moeda, números decimais, datas e assim por diante.
Para os exemplos neste guia, use os seguintes idiomas e locales.
| Idioma | Locale | Unicode locale ID |
|---|---|---|
| Inglês | Canadá | en-CA |
| Inglês | Estados Unidos | en-US |
| Francês | Canadá | fr-CA |
| Francês | França | fr-FR |
O repositório Angular inclui locales comuns.
Para uma lista de códigos de idioma, veja ISO 639-2.
Definir o locale ID de origem
Use o Angular CLI para definir o idioma de origem no qual você está escrevendo o template do component e o código.
Por padrão, o Angular usa en-US como o locale de origem do seu projeto.
Para alterar o locale de origem do seu projeto para o build, complete as seguintes ações.
- Abra o arquivo de configuração do workspace
angular.json. - Adicione ou modifique o campo
sourceLocaledentro da seçãoi18n:
{ "projects": { "your-project": { "i18n": { "sourceLocale": "ca" // Use your desired locale code } } }}