Platzhalter mit Formatierungsangabe im Ausgabetext

Eine Zeichenfolge, die in der Visualisierung ausgegeben wird, kann den Platzhalter ‎%‎ für eine Variable enthalten. Zur Laufzeit wird der Platzhalter durch den Istwert der Variablen in der angegebenen Formatierung ersetzt. Der Datentyp in der Formatierungsangabe und der Variablen müssen konform sein. Eine Zeichenfolge darf höchstens 1 Platzhalter enthalten.

Zeichenfolgen, die ausgegeben werden, stehen unter der Eigenschaft „Text“. Die zugeordnete Variable stehen unter der Eigenschaft „Textvariable“.

Siehe auch

Für die Ausgabe von ganzen Zahlen

`‎%d‎` `‎%i‎`	Ausgabe einer Variablen (ganzzahliger Datentyp) als Dezimalzahl	Code: `‎iCounter : INT := 12;‎` Eigenschaft „Text“: `‎Value: %i‎` Eigenschaft „Textvariable“: `‎PLC_PRG.iCounter‎` Ausgabe: `‎Value: 12‎`
`‎%b‎`	Ausgabe einer Variablen (ganzzahliger Datentyp) als Dualzahl	Code: `‎byCode : BYTE := 255;‎` Eigenschaft „Text“: `‎Coding: %b‎` Eigenschaft „Textvariable“: `‎PLC_PRG.byCode‎` Ausgabe: `‎Coding: 11111111‎`
`‎%o‎`	Ausgabe einer Variablen (ganzzahliger Datentyp) als vorzeichenlose Oktalzahl ohne vorangestellte Null	Code: `‎byCode : BYTE := 8#377;‎` Eigenschaft „Text“: `‎Coding: %o‎` Eigenschaft „Textvariable“: `‎PLC_PRG.byCode‎` Ausgabe: `‎Coding: 377‎`
`‎%x‎`	Ausgabe einer Variablen (ganzzahliger Datentyp mit maximal 32 Bit) als vorzeichenlose Hexadezimalzahl ohne vorangestelltes "0x"	Code: `‎dwCode : INT := 16#FFFFFFFF;‎` Eigenschaft „Text“: `‎Coding: %x‎` Eigenschaft „Textvariable“: `‎PLC_PRG.dwCode‎` Ausgabe: `‎Coding: ffffffff‎`
`‎%llX‎` `‎%012llX‎`	Ausgabe einer 64-Bit-Variablen (`‎LWORD‎`, `‎LINT‎`, `‎ULINT‎`) als Hexadezimalzahl. Hinweis: `‎llx‎` bedeutet "long long hexadecimal"	Code: `‎lwCode : LWORD := 16#4FFF_3FFF_2FFF_1FFF;‎` Eigenschaft „Text“: `‎Coding: %llx‎` Eigenschaft „Textvariable“: `‎PLC_PRG.lwCode‎` Ausgabe: `‎Coding: 4fff3fff2fff1fff‎`
`‎%u‎`	Ausgabe einer Variablen (ganzzahliger Datentyp) als vorzeichenlose Dezimalzahl	Code: `‎uiNumber : UINT := 1234;‎` Eigenschaft „Text“: `‎Number: %u‎` Eigenschaft „Textvariable“: `‎PLC_PRG.uiNumber‎` Ausgabe: `‎Number: 1234‎`

Für die Ausgabe von Gleitpunktzahlen

Gleitpunktzahlen haben den Datentyp ‎REAL‎ oder ‎LREAL‎.

`‎%f‎`	In Dezimalzahldarstellung mit Punkt im Format 1.6	Code: `‎rWeight : REAL := 1.123456789;‎` Eigenschaft „Text“: `‎Weight: %f‎` Eigenschaft „Textvariable“: `‎PLC_PRG.rWeight‎` Ausgabe: `‎Weight: 1.123456‎`
`‎%<Ausrichtung><Mindestbreite>.<Genauigkeit>f‎`	Als Dezimalzahl im benutzerdefinierten Format `‎<Ausrichtung>‎`: `‎-‎` oder `‎+‎`, optional `‎-‎`: Ausrichtung linksbündig `‎+‎`: Ausrichtung rechtsbündig `‎<Mindestbreite>‎`: Anzahl der Stellen vor dem Komma `‎<Genauigkeit>‎`: Anzahl der Stellen hinter dem Komma.	Code: `‎rWeight : REAL := 12.1‎` Eigenschaft „Text“: `‎Weight: %2.3f‎` Eigenschaft „Textvariable“: `‎PLC_PRG.rWeight‎` Ausgabe: `‎Weight: 12.100‎`
`‎%e‎`	Ausgabe einer Gleitpunktzahl (`‎REAL‎` oder `‎LREAL‎`) in Exponentialdarstellung mit Basis `‎10‎`	Code: `‎rValue : REAL := 1.234567%e-003;‎` Eigenschaft „Text“: `‎Value: %E‎` Eigenschaft „Textvariable“: `‎PLC_PRG.rValue‎` Ausgabe: `‎Value: 1.23E-6‎`
`‎%E‎`		Code: `‎rValue : REAL := 1.234567%e-003;‎` Eigenschaft „Text“: `‎Value: %e‎` Eigenschaft „Textvariable“: `‎PLC_PRG.rValue‎` Ausgabe: `‎Value: 1.23e-6‎`

Für die Ausgabe von Text

‎%c‎

Ausgabe eines einzelnen Zeichens im Zeichensatz ASCII

Code: ‎bChar := 16#41;‎

Eigenschaft „Text“: ‎Key: %c‎

Eigenschaft „Textvariable“: ‎PLC_PRG.bChar‎

Ausgabe: ‎Key: A‎

‎%s‎

Ausgabe einer Zeichenfolge

Code: ‎strName := 'Paul Smith';‎

Eigenschaft „Text“: ‎Name: %s‎

Eigenschaft „Textvariable“: ‎PLC_PRG.strName‎

Ausgabe: ‎Name: Paul Smith‎

Für die Ausgabe des Prozentzeichens

‎%%‎

Ausgabe des Prozentzeichens in einer Zeichenfolge

Eigenschaft „Text“: ‎Valid until 90%%‎

Ausgabe: ‎Valid until 90%‎

Code: ‎iPercentage : INT := 80;‎

Eigenschaft „Text“: ‎Valid until %d%%.‎

Eigenschaft „Textvariable“: ‎PLC_PRG.iPercentage := 80;‎

Ausgabe: ‎Valid until 80%‎

Für die Ausgabe von Datum und Zeit

Wenn der Ausgabetext in der Elementeigenschaft „Text“ den Platzhalter %t enthält, wird ein Datum und/oder eine Zeit ausgegeben. Wenn unter der Eigenschaft „Textvariable“ keine Variable angegeben ist, wird die Systemzeit ausgegeben, ansonsten der Wert der Variablen.

Die Namen der Wochentage und Monate werden standardmäßig auf Englisch ausgegeben. Wenn lokalisierte Texte verwenden werden, muss die Textliste ‎System‎ ergänzt werden. Diese Textliste wird automatisch in der Ansicht „POUs“ angelegt, wenn der Platzhalter %t verwendet wird. Als ID müssen dabei die englischen Begriffe verwendet werden. Die Lokalisierung kann sowohl für die abgekürzten Namen als auch für die ausgeschriebenen Namen durchgeführt werden.

Zeitdatentypen sind ‎LTIME‎, ‎TIME‎, ‎TIME_OF_DAY‎, ‎TOD‎, ‎DATE‎, ‎DATE_AND_TIME‎ oder ‎DT‎.

Kompatibilitätshinweis

Um die übliche Darstellung zu erhalten, werden ab V3.5 SP17 grundsätzlich 3 Ziffern für die Anzeige der Sekundenbruchteile ms/µs/ns verwendet. Beispiel: In ‎%t[dd-HH:mm:ss:ms]‎ wird ‎ms‎ für die Millisekunden mit 3 Ziffern angegeben. Der zweistelligen ms-Anzahl wird dazu eine Null vorangestellt. Wenn eine zweistellige Anzeige wie vor V3.5 SP17 erwünscht ist, muss ein spezielles Compiler-Define in den Übersetzungseigenschaften der Applikation gesetzt werden: ‎VISU_MILLISEC_NOLEADING_ZERO‎.

Datums- und Zeitformate
`‎%t[yyyy]‎`	Jahr mit Angabe des Jahrhunderts	Code: `‎dateBy : DATE := DATE#2020-1-1;‎` Eigenschaft „Text“: `‎By the year %t[yyyy]‎` Eigenschaft „Textvariable“: `‎PLC_PRG.dateBy‎` Ausgabe: `‎By the year 2020‎`
`‎%t[yy]‎`	Jahr ohne Angabe des Jahrhunderts (00-99)	Code: `‎dateSince : DATE := DATE#2000-1-1;‎` Eigenschaft „Text“: `‎Since: %t[yy]‎` Eigenschaft „Textvariable“: `‎PLC_PRG.dateSince‎` Ausgabe: `‎Since: 00‎`
`‎%t[y]‎`	Jahr ohne Angabe des Jahrhunderts (0-99)	Code: `‎dateSince : DATE := DATE#2000-1-1;‎` Eigenschaft „Text“: `‎Since: %t[y]‎` Eigenschaft „Textvariable“: `‎PLC_PRG.dateSince‎` Ausgabe: `‎Since: 0‎`

`‎%t[MMMM]‎`	Monat als Name	Code: `‎dateMonth : DATE := DATE#2016-1-1;‎` Eigenschaft „Text“: `‎Month: %t[MMMM]‎` Eigenschaft „Textvariable“: `‎PLC_PRG.dateMonth‎` Ausgabe: `‎Month: January‎`
`‎%t[MMM]‎`	Monat als abgekürzter Namen	Code: `‎dateMonth : DATE := DATE#2016-1-1;‎` Eigenschaft „Text“:: `‎Month: %t[MMM]‎` Eigenschaft „Textvariable“: `‎PLC_PRG.dateMonth‎` Ausgabe: `‎Month: Jan‎`
`‎%t[MM]‎`	Monat als Zahl (01 – 12)	Code: `‎dateMonth : DATE := DATE#2016-1-1;‎` Eigenschaft „Text“:: `‎Month: %t[MM]‎` Eigenschaft „Textvariable“: `‎PLC_PRG.dateMonth‎` Ausgabe: `‎Month: 01‎`
`‎%t[M]‎`	Monat als Zahl (1 – 12)	Code: `‎dateMonth : DATE := DATE#2016-1-1;‎` Eigenschaft „Text“:: `‎Month: %t[M]‎` Eigenschaft „Textvariable“: `‎PLC_PRG.dateMonth‎` Ausgabe: `‎Month: 1‎`

`‎%t[ddddd]‎`	Wochentag als Zahl von 1=Montag bis 7=Sonntag	Code: `‎iDay : INT := 7;‎` Eigenschaft „Text“:: `‎Day: %t[ddddd]‎` Eigenschaft „Textvariable“: `‎PLC_PRG.iDay‎` Ausgabe: `‎Day: 7‎`
`‎%t[dddd]‎`	Wochentag als Name	Code: `‎iDay : INT := 7;‎` Eigenschaft „Text“:: `‎Day: %t[dddd]‎` Eigenschaft „Textvariable“: `‎PLC_PRG.iDay‎` Ausgabe: `‎Day: Sunday‎`
`‎%t[ddd]‎`	Wochentag als abgekürzter Name	Code: `‎iDay : INT := 7;‎` Eigenschaft „Text“:: `‎Day: %t[ddd]‎` Eigenschaft „Textvariable“: `‎PLC_PRG.iDay‎` Ausgabe: `‎Day: Sun‎`
`‎%t[dd]‎`	Tag im Monat als Zahl (01 – 31)	Code: `‎iDay : INT := 1;‎` Eigenschaft „Text“:: `‎Day: %t[dd]‎` Eigenschaft „Textvariable“: `‎PLC_PRG.iDay‎` Ausgabe: `‎Day: 01‎`
`‎%t[d]‎`	Tag im Monat als Zahl (1 – 31)	Code: `‎iDay : INT := 1;‎` Eigenschaft „Text“:: `‎Day: %t[d]‎` Eigenschaft „Textvariable“: `‎PLC_PRG.iDay‎` Ausgabe: `‎Day: 1‎`
`‎%t[jjj]‎`	Tag im Jahr als Zahl (001-366)	Code: `‎dateOfNoReturn : DATE := DATE#2016-09-01;‎` Eigenschaft „Text“:: `‎Day of no return: %t[jjj]‎` Eigenschaft „Textvariable“: `‎PLC_PRG.dateOfNoReturn‎` Ausgabe: `‎Day of no return: 245‎`

`‎%t[HH]‎`	Stunde im 24-Stunden-Format (01-24)	Code: `‎todEnd : TOD := TIME_OF_DAY#17:0:0;‎` Eigenschaft „Text“: `‎Ends at: %t[HH]:00‎` Eigenschaft „Textvariable“: `‎PLC_PRG.todEnd‎` Ausgabe: `‎Ends at 17:00‎`
`‎%t[hh]‎`	Stunde im 12-Stunden-Format (01-12)	Code: `‎todEnd : TOD := TIME_OF_DAY#17:0:0;‎` Eigenschaft „Text“: `‎Ends at: %t[hh] o'clock‎` Eigenschaft „Textvariable“: `‎PLC_PRG.todEnd‎` Ausgabe: `‎Ends at: 05 o'clock‎`

`‎%t[mm]‎`	Minuten (00-59) mit vorangestellter Null	Code: `‎tPeriod : TIME := T#5M;‎` Eigenschaft „Text“: `‎Period: %t[mm]m‎` Eigenschaft „Textvariable“: `‎PLC_PRG.tPeriod‎` Ausgabe: `‎Period: 05m‎`
`‎%t[m]‎`	Minuten (0-59) ohne vorangestellte Null	Code: `‎tPeriod : TIME := T#5m;‎` Eigenschaft „Text“: `‎Period: %t[m 'm']‎` Eigenschaft „Textvariable“: `‎PLC_PRG.tPeriod‎` Ausgabe: `‎Period: 5 m‎`
`‎%t[ss]‎`	Sekunden (00-59) mit vorangestellter Null	Code: `‎tPeriod : TIME := T#5m3s;‎` Eigenschaft „Text“: `‎Period: %t[mm'm'ss's']‎` Eigenschaft „Textvariable“: `‎PLC_PRG.tPeriod‎` Ausgabe: `‎Period: 05m03s‎`
`‎%t[s]‎`	Sekunden (0-59) ohne vorangestellte Null	Code: `‎tPeriod : TIME := T#5m3s;‎` Eigenschaft „Text“: `‎Period: %t[m'm' s's']‎` Eigenschaft „Textvariable“: `‎PLC_PRG.tPeriod‎` Ausgabe: `‎Period: 5m 3s‎`
`‎%t[ms]‎`	Millisekunden(0-999) ohne vorangestellte Null	Code: `‎tPeriod : TIME := T#500ms;‎` Eigenschaft „Text“: `‎Period: %t[ms 'ms']‎` Eigenschaft „Textvariable“: `‎PLC_PRG.tPeriod‎` Ausgabe: `‎Period: 500 ms‎`
`‎%t[us]‎`	Nur bei `‎LTIME‎`-Variablen: Mikrosekundenangabe (0-999)	Code: `‎ltPeriod :LTIME := LTIME#1000D23H44M12S34MS2US44NS;‎` Eigenschaft „Text“: `‎'Period': %t[dd.HH.m.s.ms.us.ns]‎` Eigenschaft „Textvariable“: `‎PLC_PRG.ltPeriod‎` Ausgabe: `‎Period: 1000.23.44.12.34.2.44‎` Tipp: Ein Überlauf In der höchsten Zeiteinheit einer Angabe ist erlaubt.
`‎%t[ns]‎`	Nur `‎LTIME‎`-Variablen: Nanosekundenangabe (0-999)

`‎%t[t]‎`	Wenn der Wert eine Zeit < 12h ist, wird A ausgegeben, sonst wird P ausgegeben.	Code: `‎tClosed : TOD := TOD#17:17:17.17;‎` Eigenschaft „Text“: `‎Closed at %t[hh:mm t]‎` Eigenschaft „Textvariable“: `‎PLC_PRG.tClosed‎` Ausgabe: `‎Closed at 05:17 P‎`
`‎%t[tt]‎`	Wenn der Wert eine Zeit < 12h ist, wird AM ausgegeben, ansonsten wird PM ausgegeben.	Code: `‎tClosed : TOD := TOD#17:17:17.17;‎` Eigenschaft „Text“: `‎Closed at %t[hh:mm tt]‎` Eigenschaft „Textvariable“: `‎PLC_PRG.tClosed‎` Ausgabe: `‎Closed at 05:17 PM‎`

`‎%t[' ']‎`	Wenn Zeichenfolgen ausgegeben werden sollen, die einer Formatangabe entsprechen, müssen diese in einzelne einfache Anführungszeichen gefasst werden.
`‎TIME‎`- und `‎LTIME‎`-Werte können mit ganzzahligen Werten beziehungsweise mit Dezimalstellen angegeben werden:
`‎%t[<f><n>]‎`	Hinter den Buchstaben, die die Zeiteinheit definieren (<f>) folgt eine Zahl (<n>), die die Anzahl der Dezimalstellen des Zeitwerts definiert. Damit können für TIME-Werte die Stunden, Minuten und Sekunden, für LTIME-Werte zusätzlich die Mikrosekunden und Nanosekunden als Werte mit Dezimalstellen eingegeben oder angezeigt werden. Hinweis: Auch wenn keine Dezimalzahl für die Eingabe oder Anzeige gewünscht ist, muss zumindest die Zahl "0" angegeben werden, um eine gebrochene Eingabe zu ermöglichen.	Beispiele für die Formatierung: `‎%t[hh4]‎` oder `‎%t[HH4]‎`: Die Zeit kann mit einer Stundenangabe mit 4 Dezimalstellen angegeben/angezeigt werden. `‎%t[mm2]‎` oder `‎%t[m2]‎`, Die Zeit kann mit einer Minutenangabe mit 2 Dezimalstellen angegeben/angezeigt werden. Dies führt dann bei einem Wert von `‎t#1h20m15s‎` zu folgender Ausgabe: `‎80.25‎`. `‎ %t[ss0]‎`, Die Zeit kann mit einer Sekundenangabe ohne Dezimalstellen angegeben/angezeigt werden.

Die Formatangaben können aneinander gereiht werden.
`‎%t[HH:mm:ss:ms]‎`	Ausgabe der Zeit	Code: `‎dwTime : DWORD := 4294967295;‎` Eigenschaft „Text“: `‎Time: %t[HH:mm:ss:ms]‎` Eigenschaft „Textvariable“: `‎PLC_PRG.dwTime‎` Ausgabe: `‎Time: 23:59:59:999 Uhr‎`
%t[yyyy-MM-dd dddd]	Ausgabe von Datum und Wochentag	Code: `‎dateSet : DATE := DATE#2016-02-12;‎` Eigenschaft „Text“: `‎Date: %t[yyyy-MM-dd dddd]‎` Eigenschaft „Textvariable“: `‎PLC_PRG.dateSet‎` Ausgabe: `‎Date: 2016-02-12 Friday‎`

Siehe auch

‎⮫ Zeitdatentypen