Formateador de cadenas

Modifique el formato de uno o varios valores según una regla personalizable.
CONSEJO: Con el formateador de cadenas, puede, por ejemplo:
  • 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, como posiciones decimales o redondeos flotantes, a números

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}
    .
    CONSEJO:
    Para formatear una ruta (por ejemplo,
    ns=5;%PROJECTDIR%/Logo.svg
    ), puede utilizar:
    • {index,alignment:
      filepath
      }
      . Formatee una cadena como ruta de archivo.
      Ejemplo:
      C:\Users\
      UserName
      \AppData\Local\Rockwell Automation\FactoryTalk Optix\Emulator\Projects\
      ProjectName
      \ProjectFiles\Logo.svg
    • {index,alignment:
      uri
      }
      . Formatee una cadena como un URI.
      Ejemplo:
      file:///C:/Users/
      UserName
      /AppData/Local/Rockwell Automation/FactoryTalk Optix/Emulator/Projects/
      ProjectName
      /ProjectFiles/Logo.svg
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

Una o más variables, identificadas por un marcador de posición con un número de índice en el siguiente formato {index}. El número de índice es progresivo y debe ser un entero mayor que cero {0}.
CONSEJO: Los marcadores pueden aparecer en cualquier orden en la regla de formato. Por ejemplo, la sintaxis "el valor mínimo de {3}, {0} y {2} es {1}" es válida.

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.).
-

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 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

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}'
Entregue su opinión
¿Tiene dudas o comentarios acerca de esta documentación? Por favor deje su opinión aquí.