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
g
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
g
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 a runtime per sostituirlo con un nuovo valore visualizzato dall'applicazione con la stessa formattazione a 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.