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:
  • Índice
    . Número de índice que identifica una variable de entrada. Por cada marcador de posición
    {index}
    en la regla de formato, aparece un nuevo campo que indica el origen.
  • Alineación
    . Un entero que representa el número de caracteres del valor de origen con formato según la regla.
  • Formato
    . El formato que se aplicará a las variables de entrada.
    El marcador de formato acepta un subconjunto de valores requeridos por la notación .NET Framework del método
    String.Format
    . Los marcadores de posición deben utilizar la sintaxis
    {index,alignment:format}
    .
Modo
La dirección del vínculo dinámico:
  • Se lee del nodo de origen al primario.
  • Se escribe de un elemento primario en el nodo de origen.
  • Se lee del nodo de origen al primario y se escribe del primario en el nodo de origen.

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

Datos de ejemplo: 23/04/2021 17:25:31, sesión con desplazamiento de TimeZone de 60 minutos.
DateTime
Formato
Descripción
Ejemplo
g
Fecha y hora formato corto, local
  • (en-US): 4/23/21, 06:25 p. m.
  • (it-IT): 23/04/21, 18:25
F
Fecha y hora formato extendido, local
  • (en-US): 23 abr, 2021, 6:25:31 p. m.
  • (it-IT): 23 abr 2021, 18:25:31
X
Fecha y hora formato corto, UTC
  • (en-US): 4/23/21, 4:25 p. m. (UTC)
  • (it-IT): 23/04/21, 16:25 (UTC)
x
Fecha y hora formato extendido, UTC
  • (en-US): 23 abr, 2021, 4:25:31 p. m. (UTC)
  • (it-IT): 23 abr 2021, 16:25:31 (UTC)
U
Fecha y hora universal completa, UTC
  • (en-US): 23 abril de 2021 4:25:31 p. m. GMT (UTC)
  • (it-IT): 23 abril de 2021 16:25:31 GMT (UTC)
p
Fecha formato corto, local
  • (en-US): 4/23/21
  • (it-IT): 23/04/21
P
Fecha extendida, local
  • (en-US): 23 abril, 2021
  • (it-IT): 23 abr 2021
d
Fecha formato corto, UTC
  • (en-US): 4/23/21 (UTC)
  • (it-IT): 23/04/21 (UTC)
D
Fecha formato extendido, UTC
  • (en-US): 23 abr 2021 (UTC)
  • (it-IT): 23 abr 2021 (UTC)
t
Hora formato corto, local
  • (en-US): 6:25 p. m.
  • (it-IT): 18:25
T
Hora formato extendido, local
  • (en-US): 6:25:31 p. m.
  • (it-IT): 18:25:31
h
Hora formato corto, UTC
  • (en-US): 4:25 p. m. (UTC)
  • (it-IT): 16:25 (UTC)
H
Hora formato extendido, UTC
  • (en-US): 4:25:31 p. m. (UTC)
  • (it-IT): 16:25:31 (UTC)
Numérico (Double Float Int16 Int32 Int64 Integer UInt16 UInt32 UInt64 UInteger)
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).
  • d
    : -1234 ► -1234
  • d
    : 5.618 ► 5618
  • d2
    : 1,234.239 ► 1234.24
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).
  • n1
    : -1234.23 ► -1,234.2
  • n2
    : 5804.236 ► 5,804.24
  • n3
    : -1234.23 ► -1,234.2
e
Notación exponencial.
Después del marcador de formato, el número de números significativos se configura con un entero.
  • e10
    : 12345.6789 ► 1.234567890E4
  • e2
    : 2665.778 ► 2.7E3
f
Notación de punto fijo.
Después del marcador de formato, se configura el número exacto de lugares decimales con un entero.
  • f3
    : 123 ► 123.000
  • f3
    : 123.23 ► 123.230
  • f4
    : -1898300.678 ► -1,898,300.6780
  • f3
    : 123.4 ► 123.400
p
Porcentaje.
Después del marcador de formato, se utiliza un entero para configurar el número de lugares decimales.
  • p
    : 1 ► 100%
  • p3
    : -0.397481 ► -39.748%
x
Notación hexadecimal.
255 ► ff
b
Notación binaria.
107 ► 1101011
o
Notación octal.
56 ► 70
Duración e intervalo de tiempo
Formato
Descripción
Ejemplo
c
Formato de constante:
[-][d’.’]hh’:’mm’:’ss[‘.’fffffff]
  • 3.17:25:30.5000000
  • 4:30:00 a. m.
g
Formato corto general:
[-][d’.’]hh’:’mm’:’ss[‘.’fffffff]
  • (en-US): 1:3:16:50.5
  • (en-US): 5:15:09:00
  • (fr-FR): 2:9:02:00,0200000
  • (fr-FR): 15:12:20:00
  • (en-US): 5:12:00
  • (fr-FR): 20:10:00
G
Formato general extendido:
[-][d’.’]hh’:’mm’:’ss[‘.’fffffff]
  • (en-US): 12:08:30 a. m.:00.0000000
  • (fr-FR): 12:08:30 a. m.:00.0000000
  • (en-US): 12:18:20 a. m.:00.0000000
  • (fr-FR): 12:17:30 a. m.:00.0000000
Cadena
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
ANSI SQL
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ámico
    Modo
    del convertidor debe ser
    Lectura/Escritura
    .
  • El campo
    Formato
    solo 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
¿Tiene dudas o comentarios acerca de esta documentación? Por favor deje su opinión aquí.