Formateador de cadenas
Modifique el formato de uno o varios valores según una regla personalizable.
Puede usar el formateador de cadenas para:
- Agregar caracteres antes o después de un valor si el valor de la variable de origen es numérico.
- Dar formato y asignar parámetros a las consultas SQL para usarlas en objetos de la base de datos.
- Vincular varias cadenas juntas en una serie.
- Aplicar formato numérico, como posiciones decimales o redondeos flotantes.
Propiedades
Propiedad | Descripción |
---|---|
Formato | Regla de formato de la referencia de variables:
|
Modo | La dirección del vínculo dinámico:
|
Origen
Origen es una o varias variables, identificadas por un marcador de posición con un
{index number}
. El número de índice es progresivo y debe ser un entero mayor que cero {0}
. Puede utilizar los marcadores de posición en cualquier orden en la regla de formato. Por ejemplo, the minimum value of {3}, {0} and {2} is {1}
es una sintaxis válida.Puede anidar marcadores de posición en la cadena
{index,alignment:format}
de formato para cambiar dinámicamente el formato de los datos que se muestran.Ejemplos de marcadores de posición anidados:
- {0:f{1}}
- El valor de la variable vinculada con{1}define el número de decimales.
- {0:{1}{2}}
- El valor de la variable vinculada con{1}define el tipo de datos numérico.
- El valor de la variable vinculada con{2}define el número de decimales.
- {0,{1}:{2}{3}}
- El valor de la variable vinculado con{1}define la alineación.
- El valor de la variable vinculada con{2}define el tipo de datos numérico.
- El valor de la variable vinculada con{2}define el número de decimales.
Tipos de datos
Formato | Descripción | Ejemplo |
---|---|---|
g | Fecha y hora formato corto, local |
|
F | Fecha y hora formato extendido, local |
|
X | Fecha y hora formato corto, UTC |
|
x | Fecha y hora formato extendido, UTC |
|
U | Fecha y hora universal completa, UTC |
|
p | Fecha formato corto, local |
|
P | Fecha extendida, local |
|
d | Fecha formato corto, UTC |
|
D | Fecha formato extendido, UTC |
|
t | Hora formato corto, local |
|
T | Hora formato extendido, local |
|
h | Hora formato corto, UTC |
|
H | Hora formato extendido, UTC |
|
Formato | Descripción | Ejemplo |
---|---|---|
d | Numérico, sin separador de miles. Después del marcador de formato, el número de posiciones decimales se configura con un entero (sin relleno). |
|
n | Numérico, con separador de miles. Después del marcador de formato, el número de posiciones decimales se configura con un entero (sin relleno). |
|
e | Notación exponencial. Después del marcador de formato, el número de números significativos se configura con un entero. |
|
f | Notación de punto fijo. Después del marcador de formato, se configura el número exacto de lugares decimales con un entero. |
|
p | Porcentaje. Después del marcador de formato, se utiliza un entero para configurar el número de lugares decimales. |
|
x | Notación hexadecimal. | 255 ► ff |
b | Notación binaria. | 107 ► 1101011 |
o | Notación octal. | 56 ► 70 |
Formato | Descripción | Ejemplo |
---|---|---|
c | Formato de constante: [-][d’.’]hh’:’mm’:’ss[‘.’fffffff] |
|
g | Formato corto general: [-][d’.’]hh’:’mm’:’ss[‘.’fffffff] |
|
G | Formato general extendido: [-][d’.’]hh’:’mm’:’ss[‘.’fffffff] |
|
Formato | Descripción | Ejemplo |
---|---|---|
l | Todas minúsculas. | grüßEN ► grüßen |
u | Todas mayúsculas. | grüßEN ► GRÜSSEN |
t | Todas las primeras letras en mayúscula. | grüßEN ► GRÜSSEN |
f | No distingue entre mayúsculas y minúsculas. | grüßEN ► grüssen |
Formato | Descripción | Ejemplo |
---|---|---|
sql_identifier | Da formato a una String o LocalizedText determinado como una tabla o un identificador de columna. | - |
sql_literal | Da formato al valor de una variable como un valor literal de SQL ( Número , Cadena , fecha , hora , etc.). | - |
Ejemplos de consultas SQL
Asigne un parámetro al nombre de la columna interna con la condición:
SELECT * FROM Table1 WHERE {0:sql_identifier} > 5
Comparación con una variable de datos:
SELECT * FROM AlarmsDatalogger WHERE Time > {0:sql_literal}
Asigne un parámetro al operador
LIKE
:SELECT * FROM AlarmsDatalogger WHERE Name LIKE '{0}'
Asigne un parámetro a una parte de una consulta con un marcador de posición:
SELECT * FROM Table1 {0}
El marcador con índice
0
está vinculado a una variable de cadena del proyecto y asigna el parámetro a una columna. El marcador con índice 1
está vinculado a una variable numérica que representa el valor del operador de comparación >
:SELECT * FROM {0:sql_identifier} WHERE Column1 > {1:sql_literal}
Asigne un parámetro al nombre de la tabla, la columna y también al operador
LIKE
:SELECT {0:sql_identifier} FROM {1:sql_identifier} WHERE {0:sql_identifier} LIKE '{2}'
Formato de la ruta de acceso
Tenga en cuenta estas funcionalidades de formato de la ruta de acceso:
- Para formatear una cadena como una ruta de archivo, puede utilizar esta sintaxis:{index,alignment:.filepath}
- Entrada
- ns=5;%PROJECTDIR%/Logo.svg
- Output
- C:\Users\UserName\AppData\Local\Rockwell Automation\FactoryTalk Optix\Emulator\Projects\ProjectName\ProjectFiles\Logo.svg
- Para formatear una cadena como un URI, puede usar esta sintaxis:{index,alignment:.uri}
- Entrada
- ns=5;%PROJECTDIR%/Logo.svg
- Output
- archivo:///C:/Users/UserName/AppData/Local/Rockwell Automation/FactoryTalk Optix/Emulator/Projects/ProjectName/ProjectFiles/Logo.svg
- Para aplicar formato a una parte de una ruta de acceso, puede usar esta sintaxis:file:///C:/Reports/Report.{0}.pdf
Formato inverso
La función de formato inverso le permite modificar un valor con formato en tiempo de ejecución para reemplazarlo con un nuevo valor que la aplicación muestra con el mismo formato en tiempo de ejecución.
La función de formato inverso requiere la siguiente configuración para que funcione correctamente:
- El vínculo dinámicoMododel convertidor debe serLectura/Escritura.
- El campoFormatosolo debe tener un marcador o un origen. El marcador de posición puede tener un sufijo o prefijo, y se puede establecer con una cadena de formato, como{0:n}.
Salida
La cadena especificada en la propiedad
Formato
, según las reglas de formato con valores en lugar de los marcadores de posición.Ejemplo
Entregue su opinión