# Idioma e formatos

> A língua em que as telas da estação são escritas, e os formatos de data, de hora e de número em que toda tela e todo arquivo exportado são lidos.

Idioma e formatos é a quarta linha do grupo GERAL na página Configurações. A primeira lista de escolha dela decide a língua em que toda tela da estação é escrita; as quatro abaixo dela decidem como a estação escreve uma data, uma hora do dia e um número, em todo lugar de uma vez: na tela, na barra de status, nos gráficos, nas exportações e nos relatórios. Cada linha de formato mostra uma prévia ao vivo do que a escolha produz. A página exige a permissão **Alterar configurações**; um formato vale no instante em que é escolhido, e uma língua vale na próxima vez que o aplicativo inicia.

## Idioma da interface {#interface-language}

| Campo | O que é | Valores / padrão | Efeito |
| --- | --- | --- | --- |
| Idioma da interface | A língua em que as telas da estação são escritas. A linha diz "A língua em que as telas desta estação são escritas, aqui e em qualquer dispositivo que as abra. Ela passa a valer na próxima vez que o Ganter Lab iniciar: nada em andamento é interrompido, e os formatos de data, hora e número abaixo continuam como estão." | As onze línguas que o produto entrega, cada uma escrita no nome dela mesma, para que quem não consegue ler a tela ainda ache a sua. Padrão: a língua de exibição do Windows quando o produto fala essa língua, e inglês quando não fala. | Toda palavra que o aplicativo escreve: rótulos, descrições, menus, avisos, confirmações e recusas, aqui e em qualquer navegador que abra a estação, além da ajuda offline e dos documentos legais. |

Escolher uma língua guarda a escolha na hora e ainda não muda nada na tela. A linha passa a trazer uma frase na cor de destaque, "Salvo. As telas continuam escritas em … até o Ganter Lab ser reiniciado.", nomeando a língua que ainda está sendo lida, e as palavras novas chegam no próximo início comum: nada se reinicia sozinho, e nenhuma aquisição, gravação ou execução é interrompida para trocar um rótulo. A escolha é da estação, não da tela que a fez: fica guardada no banco de configuração junto com o tema e com os formatos abaixo (uma linha só, levada por um backup), e um navegador na rede da planta lê a língua da estação em vez da dele, então um dashboard se lê igual onde quer que seja aberto.

Um agente com a área Settings aberta na página [Agente](agent) lê a língua atual com `settings_read` e a define com `localization_set`, passando o código de cultura de uma língua que esta versão entrega (`en`, `pt-BR`, `de-DE`, `fr`, `fr-CA`, `it-IT`, `es`, `es-MX`, `zh-CN`, `ja-JP`, `ko-KR`); qualquer outro código é recusado, e a resposta é essa lista. O que um agente define fica registrado igual a uma escolha feita aqui, e é lido no próximo início.

## Os quatro formatos {#the-four-formats}

| Campo | O que é | Valores / padrão | Efeito |
| --- | --- | --- | --- |
| Formato de data | O arranjo de uma data de calendário. Prévia: a data de hoje. | **Dia / Mês / Ano (31/12/2026)**, **Mês / Dia / Ano (12/31/2026)**, **Ano - Mês - Dia (2026-12-31)**. Padrão: Dia / Mês / Ano. | Toda data que a estação mostra ou escreve num arquivo. |
| Formato de hora | O arranjo de uma hora de relógio. Prévia: a hora agora. | **24 horas (14:05:09)**, **12 horas AM/PM (02:05:09 PM)**. Padrão: 24 horas. | Toda hora do dia; as leituras que carregam milissegundos os mantêm (14:05:09.123, ou 02:05:09.123 PM). |
| Separador decimal | A marca entre a parte inteira e a fração, e com ela a marca de agrupamento. Prévia: 1234.5678 escrito com as casas decimais atuais. | **Ponto (1,234.56)**, **Vírgula (1.234,56)**. Padrão: Ponto. | Todo número que a estação escreve para ser lido, e todo decimal digitado num campo de texto (o ponto também é lido em qualquer estação). |
| Casas decimais | "Quantidade de dígitos fracionários mostrados nos valores." | De 0 a 6. Padrão: 2. | Todo número que não tem uma regra mais próxima própria. |

Uma mudança vale na hora em toda tela aberta, tanto na janela da estação quanto em qualquer navegador, e é guardada no banco de configuração junto com o tema (uma linha só, levada por um backup). As listas de escolha não ficam travadas enquanto uma unidade está em execução: estas são preferências de exibição, não mudanças na estação. Um agente com a área Settings aberta na página [Agente](agent) as lê com `settings_read` e as muda com `localization_set`, limitado às mesmas 0 a 6 casas decimais que a lista de escolha oferece: qualquer outro número é recusado, com essa faixa como resposta, e a chamada não muda nada. Enquanto o runtime está parado, nem os formatos nem o idioma podem ser mudados: esta página dá lugar ao aviso de pausa, como toda página menos a Conta (veja [O que o runtime parado faz com esta página](settings#what-the-stopped-runtime-does-to-this-page)), e `localization_set` responde "Runtime parado".

## Onde cada formato se aplica {#where-each-format-applies}

Tudo o que uma pessoa lê passa por um formatador só, então duas superfícies da mesma janela nunca falam calendários diferentes.

- **O relógio da barra de status**: data e hora na ponta direita da barra, nos formatos de data e de hora escolhidos.
- **Connector**: os valores ao vivo das tags com o separador decimal e a sua marca de agrupamento, nas casas que a própria tag declara e não nas escolhidas aqui ([Tags](connector-tags#the-live-value-card)), os carimbos de tempo de origem e de aplicativo de uma tag, com milissegundos, e a tabela de prévia do assistente de dois pontos ([Calibração](connector-calibration#step-3-read-the-verdict-and-the-preview)).
- **Logic**: os valores dos pontos nas linhas e nos painéis do espaço de endereços, e o cartão Valor de uma variável, com o separador decimal e a sua marca de agrupamento: um número inteiro sem fração, o valor decimal de uma tag nas casas que a tag declara (como no Connector), e qualquer outro valor decimal nas casas escolhidas aqui. O limite que uma ação nomeia quando o script dela é abortado também leva a marca de agrupamento ([Ações](logic-actions#run)).
- **Dashboards**: os mostradores de valor, os cartões de KPI, as linhas do aviso de alarme. Um componente que declara as casas decimais dele usa as dele para o valor; o separador é sempre o da estação. A leitura mostrada sob um campo de endereço no editor é escrita como o Valor que ela confirma quando esse Valor não declara casas: um número inteiro sem fração, e um valor decimal nas casas escolhidas aqui mesmo quando a tag declara as dela, então, numa estação que escreve duas casas, uma tag que declara uma aparece como 239.10 ali e como 239.1 no Connector e na Logic.
- **Gráficos**: os rótulos de eixo de todo gráfico usam a marca decimal escolhida, a ordem da data e o relógio de 12 ou de 24 horas, e as casas decimais da estação, a menos que uma série declare as dela.
- **Process**: os cartões de unidade, a lista dos Históricos, os comentários de execução, as etiquetas e os relatórios gerados. Nas telas de configuração, as frases de efeito sob os campos de uma avaliação, a frase de resultado de cada estágio de um procedimento, a leitura de amostra de um canal e a coluna Valor dos vínculos de uma unidade. E todo tamanho em bytes: os bytes congelados de uma etiqueta no registro da execução, e o tamanho da cópia de um relatório guardada na execução, de uma execução exportada ou importada como arquivo `.glab` e dos comandos de um modelo de etiqueta.
- **Exportações**: uma execução exportada como CSV escreve números com a marca decimal escolhida, e o separador de colunas a acompanha: uma vírgula entre colunas com decimais de ponto, um ponto e vírgula com decimais de vírgula, para que o arquivo abra limpo numa planilha da mesma região. A exportação XLSX e as exportações de Eventos carregam os mesmos carimbos.
- **Eventos, Usuários, Conta e Configurações**: as linhas de diário, o histórico de alarmes, o último acesso de um usuário, as datas da assinatura, a lista de backups e as datas de validade dos certificados.

Os instantes são guardados em UTC e mostrados no fuso horário local da estação; essa conversão acontece no mesmo formatador, então um arquivo que carrega carimbos nomeia o fuso da estação uma vez, no cabeçalho da coluna de carimbo de tempo. A região do próprio navegador remoto é ignorada: um dashboard se lê igual onde quer que seja aberto.

## O que estas configurações não mudam {#what-these-settings-do-not-change}

O armazenamento, o tráfego dos drivers, as gravações, as cargas de barramento e os nomes dos arquivos baixados usam sempre um formato fixo e invariante; uma mudança de formato nunca reescreve um valor gravado. Um formato que um item declara para si mesmo, como o marcador de uma etiqueta, uma parte de um identificador sequencial ou um eixo de gráfico com as casas dele, é dado daquele item. Uma etiqueta imprime os seus números para a máquina que os lê, com o ponto decimal invariante e nunca uma marca de agrupamento, seja qual for a escolha feita aqui ([Modelos de etiqueta](process-labels#where-the-values-come-from)), e o seletor de origem de uma nova etiqueta no registro da execução mostra cada número do jeito que a etiqueta o imprime. A língua lá de cima também não é um desses formatos: uma estação lida em japonês continua escrevendo a data, a hora e o número do jeito que as quatro linhas dizem, e ela nunca traduz o que alguém digitou, então os nomes de dispositivo, de tag, de variável, de dashboard e de unidade, as observações e os comentários se leem exatamente como foram escritos.