Formatador de strings
Modifique a formatação de um ou mais valores de acordo com uma regra personalizável.
É possível usar o formatador de strings para:
- Adicionar caracteres antes ou depois de um valor, se o valor da variável de origem for numérico.
- Formatar e parametrizar consultas SQL para usar em objetos de banco de dados.
- Vincular várias strings em uma série.
- Aplicar formatação numérica, como casas decimais ou arredondamento flutuante.
Propriedades
Propriedade | Descrição |
---|---|
Formato | A regra de formatação para referência de variável:
|
Modo | A direção do vínculo dinâmico:
|
Origem
Uma ou mais variáveis identificadas por:
- Espaço reservado{index_number}
- Inteiro progressivo igual ou maior que zero. Por exemplo{1}
- Espaço reservado{#placeholder_identifier}
- String prefixada com#. Por exemplo{#speed}
DICA:
Use qualquer combinação de espaços reservados em qualquer ordem. Use qualquer número de espaços reservados na expressão.
Você também pode aninhar espaços reservados
{index,alignment:format}
para alterar dinamicamente a formatação dos dados exibidos. Por exemplo:- {0:f{1}}
- O valor da variável vinculado a{1}define o número de casas decimais.
- {0:{1}{2}}
- O valor da variável vinculado a{1}define o tipo de dados numéricos.
- O valor da variável vinculado a{2}define o número de casas decimais.
- {0,{1}:{2}{3}}
- O valor da variável vinculado a{1}define o alinhamento.
- O valor da variável vinculado a{2}define o tipo de dados numéricos.
- O valor da variável vinculado a{3}define o número de casas decimais.
Tipos de dados
Formato | Descrição | Exemplo |
---|---|---|
g | Data e hora abreviadas, locais |
|
F | Data e hora estendidas, locais |
|
X | Data e hora abreviadas, UTC |
|
x | Data e hora estendidas, UTC |
|
U | Data e hora universais completas, UTC |
|
p | Data abreviada, local |
|
P | Data estendida, local |
|
d | Data abreviada, UTC |
|
D | Data estendida, UTC |
|
t | Hora abreviada, local |
|
T | Hora estendida, local |
|
h | Hora abreviada, UTC |
|
H | Hora estendida, UTC |
|
Formato | Descrição | Exemplo |
---|---|---|
d | Numérico, sem separador de milhares. Após o espaço reservado de formato, o número de casas decimais é configurado com um inteiro (sem preenchimento). |
|
n | Numérico, com separador de milhares. Após o espaço reservado de formato, o número de casas decimais é configurado com um inteiro (sem preenchimento). |
|
e | Notação exponencial. Após o espaço reservado de formato, o número de números significativos é configurado com um inteiro. |
|
f | Notação de ponto fixo. Após o espaço reservado de formato, o número exato de casas decimais é configurado com um inteiro. |
|
p | Porcentagem. Após o espaço reservado de formato, um inteiro é usado para configurar o número de casas decimais. |
|
x | Notação hexadecimal. | 255 ► ff |
b | Notação binária. | 107 ► 1101011 |
o | Notação octal. | 56 ► 70 |
Formato | Descrição | Exemplo |
---|---|---|
c | Formato constante. |
|
g | Formato abreviado geral. |
|
G | Formato geral estendido. |
|
Formato | Descrição | Exemplo |
---|---|---|
l | Todas minúsculas. | grüßEN ► grüßen |
u | Todas maiúsculas. | grüßEN ► GRÜSSEN |
t | Todas as primeiras letras maiúsculas. | grüßEN ► GRÜSSEN |
f | Independente de maiúsculas ou minúsculas. | grüßEN ► grüssen |
Formato | Descrição | Exemplo |
---|---|---|
sql_identifier | Formata uma determinada String ou LocalizedText como um identificador de tabela ou coluna. | - |
sql_literal | Formata o valor de uma variável como um valor literal SQL ( Número , String , data , hora e assim por diante). | - |
Exemplos de consultas SQL
Parametrize o nome da coluna interna com a condição:
SELECT * FROM Table1 WHERE {0:sql_identifier} > 5
Comparação com uma variável de dados:
SELECT * FROM AlarmsDatalogger WHERE Time > {0:sql_literal}
Parametrize o operador
LIKE
:SELECT * FROM AlarmsDatalogger WHERE Name LIKE '{0}'
Parametrize uma parte de uma consulta com um espaço reservado:
SELECT * FROM Table1 {0}
O espaço reservado com índice
0
é vinculado a uma variável de string do projeto e parametriza uma coluna; O espaço reservado com índice 1
é vinculado a uma variável numérica que representa o valor do operador de comparação >
:SELECT * FROM {0:sql_identifier} WHERE Column1 > {1:sql_literal}
Parametrize o nome da tabela, a coluna e o operador
LIKE
:SELECT {0:sql_identifier} FROM {1:sql_identifier} WHERE {0:sql_identifier} LIKE '{2}'
Formatação de caminho
Considere estes recursos de formatação de caminho:
- Para formatar uma string como um caminho de arquivo, você pode usar esta sintaxe:{index,alignment:.filepath}
- Input
- ns=5;%PROJECTDIR%/Logo.svg
- Output
- C:\Users\UserName\AppData\Local\Rockwell Automation\FactoryTalk Optix\Emulator\Projects\ProjectName\ProjectFiles\Logo.svg
- Para formatar uma string como um URI, você pode usar esta sintaxe:{index,alignment:.uri}
- Input
- ns=5;%PROJECTDIR%/Logo.svg
- Output
- file:///C:/Users/UserName/AppData/Local/Rockwell Automation/FactoryTalk Optix/Emulator/Projects/ProjectName/ProjectFiles/Logo.svg
- Para formatar uma parte de um caminho, você pode usar esta sintaxe:file:///C:/Reports/Report.{0}.pdf
Formatação inversa
O recurso de formatação inversa permite modificar um valor formatado em tempo de execução para substituir o valor por um novo valor que o aplicativo exibe com a mesma formatação em tempo de execução.
O recurso de formatação inversa requer as seguintes configurações para operar corretamente:
- OModode vínculo dinâmico do conversor deve serLer/Gravar.
- O campoFormatodeve ter apenas um espaço reservado ou origem. O espaço reservado pode ter um sufixo e/ou prefixo e ser definido com uma string de formato, como{0:n}.
Output
A string inserida na propriedade
Formato
, com base nas regras de formatação com valores no lugar do espaço reservado ou espaços reservados.Exemplo
Dê sua opinião