Formattatore stringa

Modificare la formattazione di uno o più valori in base a una regola personalizzabile.
MANCIA: Utilizzando il formattatore stringa, è possibile, ad esempio:
  • Aggiungere caratteri prima o dopo un valore, se il valore della variabile sorgente è numerico.
  • Formattare e parametrizzare query SQL da utilizzare sugli oggetti del database
  • Collegare più stringhe insieme in una serie
  • Applicare formattazione, come cifre dopo la virgola o arrotondamento dei valori float, ai numeri

Proprietà

Proprietà
Descrizione
Formato
La regola di formattazione per il riferimento delle variabili:
  • Index. Un numero di indice che identifica una variabile di input. Per ogni segnaposto {index} nella regola di formattazione, viene visualizzato un nuovo campo che indica l'origine.
  • Alignment. Un numero intero che rappresenta il numero di caratteri del valore di origine formattato in base alla regola.
  • Format. La formattazione da applicare alle variabili di input.
    Il segnaposto del formato accetta un sottogruppo di valori richiesti dalla notazione .NET Framework per il metodo
    String.Format
    . I segnaposto devono usare la sintassi
    {index,alignment:format}
    .
    MANCIA:
    Per formattare un percorso (ad esempio,
    ns=5;%PROJECTDIR%/Logo.svg
    ), è possibile utilizzare:
    • {index,alignment:
      filepath
      }
      . Formattare una stringa come percorso di file.
      Esempio:
      C:\Users\
      UserName
      \AppData\Local\Rockwell Automation\FactoryTalk Optix\Emulator\Projects\
      ProjectName
      \ProjectFiles\Logo.svg
    • {index,alignment:
      uri
      }
      . Formattare una stringa come URI.
      Esempio:
      file:///C:/Users/
      UserName
      /AppData/Local/Rockwell Automation/FactoryTalk Optix/Emulator/Projects/
      ProjectName
      /ProjectFiles/Logo.svg
Modalità
La direzione del collegamento dinamico:
  • Lettura dal nodo sorgente all'elemento padre.
  • Scrittura dall'elemento padre al nodo sorgente.
  • Lettura dal nodo sorgente all'elemento padre e scrittura dall'elemento padre al nodo sorgente.

Sorgente

Una o più variabili, identificate da un segnaposto con un numero di indice nel formato {index} seguente. Il numero dell'indice è progressivo e deve essere un numero intero maggiore di zero {0}.
MANCIA: I segnaposto possono essere visualizzati in qualsiasi ordine nella regola di formattazione. Ad esempio, la sintassi "il valore minimo tra {3}, {0} e {2} è {1}" è valido.

Tipi di dati

Dati di esempio: 23/04/2021 17:25:31, sessione con offset TimeZone di 60 minuti.
DateTime
Formato
Descrizione
Esempio
g
Data e ora brevi, locale
  • (en-US): 4/23/21, 06:25 PM
  • (it-IT): 23/04/21, 18:25
F
Data e ora estese, locale
  • (en-US): Apr 23, 2021, 6:25:31 PM
  • (it-IT): 23 apr 2021, 18:25:31
X
Data e ora brevi, UTC
  • (en-US): 4/23/21, 4:25 PM (UTC)
  • (it-IT): 23/04/21, 16:25 (UTC)
x
Data e ora estese, UTC
  • (en-US): Apr 23, 2021, 4:25:31 PM (UTC)
  • (it-IT): 23 apr 2021, 16:25:31 (UTC)
U
Data e ora completa universale, UTC
  • (en-US): April 23, 2021 4:25:31 PM GMT (UTC)
  • (it-IT): 23 aprile 2021 16:25:31 GMT (UTC)
p
Data breve, locale
  • (en-US): 4/23/21
  • (it-IT): 23/04/21
P
Data estesa, locale
  • (en-US): April 23, 2021
  • (it-IT): 23 apr 2021
d
Data breve, UTC
  • (en-US): 4/23/21 (UTC)
  • (it-IT): 23/04/21 (UTC)
D
Data estesa, UTC
  • (en-US): Apr 23, 2021 (UTC)
  • (it-IT): 23 apr 2021 (UTC)
t
Ora breve, locale
  • (en-US): 6:25 PM
  • (it-IT): 18:25
T
Ora estesa, locale
  • (en-US): 6:25:31 PM
  • (it-IT): 18:25:31
h
Ora breve, UTC
  • (en-US): 4:25 PM (UTC)
  • (it-IT): 16:25 (UTC)
H
Ora estesa, UTC
  • (en-US): 4:25:31 PM (UTC)
  • (it-IT): 16:25:31 (UTC)
Numerico (Double Float Int16 Int32 Int64 Integer UInt16 UInt32 UInt64 UInteger)
Formato
Descrizione
Esempio
d
Numerico, senza separatore delle migliaia.
Dopo il segnaposto del formato, con un numero intero si configura il numero di posizioni decimali (senza padding).
  • d
    : -1234 ► -1234
  • d
    : 5.618 ► 5618
  • d2
    : 1,234.239 ► 1234.24
n
Numerico, con separatore delle migliaia.
Dopo il segnaposto del formato, con un numero intero si configura il numero di posizioni decimali (senza padding).
  • n1
    : -1234.23 ► -1.234,2
  • n2
    : 5804.236 ► 5.804,24
  • n3
    : -1234.23 ► -1.234,2
e
Notazione esponenziale.
Dopo il segnaposto del formato, con un numero intero si configura il numero di cifre significative.
  • e10
    : 12345,6789 ► 1,234567890E4
  • e2
    : 2665,778 ► 2,7E3
f
Notazione a punto fisso.
Dopo il segnaposto del formato, con un numero intero si configura il numero esatto di posizioni decimali.
  • f3
    : 123 ► 123,000000
  • f3
    : 123,23 ► 123,230000
  • f4
    : -1898300,678 ► -1.898.300,6780
  • f3
    : 123,4 ► 123,400
p
Percentuale.
Dopo il segnaposto del formato, con un numero intero si configura il numero di posizioni decimali.
  • p
    : 1 ► 100%
  • p3
    : -0,397481 ► -39,748%
x
Notazione esadecimale.
255 ► ff
b
Notazione binaria.
107 ► 1101011
o
Notazione ottale.
56 ► 70
Durata e intervallo temporale
Formato
Descrizione
Esempio
c
Formato costante:
[-][d’.’]hh’:’mm’:’ss[‘.’fffffff]
  • 3.17:25:30.5000000
  • 4:30:00 AM
g
Formato breve generale:
[-][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 generale esteso:
[-][d’.’]hh’:’mm’:’ss[‘.’fffffff]
  • (en-US): 12:08:30 AM:00.0000000
  • (fr-FR): 12:08:30 AM:00.0000000
  • (en-US): 12:18:20 AM:00.0000000
  • (fr-FR): 12:17:30 AM:00.0000000
Stringa
Formato
Descrizione
Esempio
l
Tutte minuscole.
grüßEN ► grüßen
u
Tutte maiuscole.
grüßEN ► GRÜSSEN
t
Tutte le prime lettere maiuscole.
grüßEN ► GRÜSSEN
f
Indipendente da minuscolo e maiuscolo.
grüßEN ► grüssen
SQL ANSI
Formato
Descrizione
Esempio
sql_identifier
Formatta un dato
String
 o
LocalizedText
 in identificatore di tabella o di colonna.
-
sql_literal
Formatta il valore di una variabile come un valore SQL letterale (
Number
,
String
,
date
,
time
, ecc.).
-

Formattazione inversa

La funzione di formattazione inversa consente di modificare un valore formattato al runtime per sostituirlo con un nuovo valore visualizzato dall'applicazione con la stessa formattazione al runtime.
La funzione di formattazione inversa richiede che le seguenti impostazioni funzionino correttamente:
  • La
    Modalità
     di collegamento dinamico del convertitore deve essere di
    Lettura/Scrittura
    .
  • Il campo
    Formato
     deve avere un solo segnaposto o origine. Il segnaposto può avere un suffisso e/o prefisso e può essere impostato con una stringa di formato come {0:n}.

Output

La stringa immessa nella proprietà
Formato
, in base alle regole di formattazione con valori al posto dei segnaposto.

Rappresentazione logica

Esempio di conversione logica nell'
Editor dei collegamenti dinamici avanzati:

Esempi di query SQL

Parametrizzare il nome della colonna interna alla condizione:
SELECT * FROM Table1 WHERE {0:sql_identifier} > 5
Confronto con una variabile di tipo data:
SELECT * FROM AlarmsDatalogger WHERE Time > {0:sql_literal}
Parametrizzare l'operatore
LIKE
:
SELECT * FROM AlarmsDatalogger WHERE Name LIKE '{0}'
Parametrizzare una parte di una query con un segnaposto:
SELECT * FROM Table1 {0}
Il segnaposto con indice
0
 è collegato a una variabile stringa di progetto e parametrizza una colonna; il segnaposto con indice
1
 è collegato a una variabile numerica che rappresenta il valore per l'operatore di confronto
>
:
SELECT * FROM {0:sql_identifier} WHERE Column1 > {1:sql_literal}
Parametrizzare il nome della tabella, la colonna e anche l'operatore
LIKE
:
SELECT {0:sql_identifier} FROM {1:sql_identifier} WHERE {0:sql_identifier} LIKE '{2}'
Fornire un feedback
Hai domande o feedback su questa documentazione? invia il tuo feedback qui.