Skip to main content

Platzhalter mit Formatangabe

Der Ausgabetext eines Elements kann mit Hilfe eines Platzhalters % mit Formatangabe den Wert einer Variablen ausgeben. Bei Ausgabe des Textes wird an Stelle des Platzhalters der Wert der Variablen eingefügt. Der Datentyp der Formatangabe und der Variablen müssen konform sein.

Die Zeichenfolge, die ausgegeben wird, steht in der Elementeigenschaft Text . Die Variable steht in der Eigenschaft Textvariable.

Visualisierungsbenutzer können in einem Element einen Text eingeben, der beispielsweise als Textausgabevariable gespeichert und dargestellt wird. Die Benutzereingabe muss dem Eingabeformat entsprechen. Der Datentyp der Textausgabevariablen muss dem Datentyp entsprechen, der beim Eingabeformat definiert wird.

Die Formatangabe für den Eingabetext steht im Dialog Eingabekonfiguration in der Eingabeaktion Variable schreiben in Texteingabe. Die Variable steht in der in der Eigenschaft Textvariable.

Ganze Zahl

Die Formatangabe für eine ganze Zahl folgt folgendem Schema:

% <flags> <minimum number of digits> <type>

Empfohlene Datentypen: BYTE | WORD | DWORD | LWORD | SINT | USINT | INT | UINT | DINT | UDINT | LINT | ULINT

Syntax

Beispiel

Beschreibung

Beispiel Visualisierung

<flags>

Optional und kombinierbar

Code: iValue : INT := -12;

Eigenschaft Textvariable: PLC_PRG.iCounter

-

%-5d

Ausrichtung linksbündig, bezogen auf die Mindestbreite der Zahl (angegeben in Mindestanzahl an Stellen)

Eigenschaft Text: Value: %-5d

+

%+d

Ausgabe immer mit Vorzeichen

Eigenschaft Text: Value: %+d

Ausgabe: Value: -12

0

%05d

Stellen werden mit 0 aufgefüllt, bis die Mindestanzahl an Stellen (inklusive Vorzeichen) erreicht ist

Eigenschaft Text: Value: %05d

<minimum number of digits>

%5d

Optional

Mindestanzahl an Stellen

Syntax

Beispiel

Beschreibung

Beispiel Visualisierung

<type>

Erforderlich

d

i

%d

Ausgabe als ganzzahlige Dezimalzahl

Code: iValue : INT := -12;

Eigenschaft Text: Value: %d

Eigenschaft Textvariable: PLC_PRG.iCounter

Ausgabe: Value: -12

%+05d

Code: iValue : INT := -12;

Eigenschaft Text: Value: %+05d

Eigenschaft Textvariable: PLC_PRG.iCounter

Ausgabe: Value: -0012

b

%08b

Ausgabe als vorzeichenlose, ganzzahlige Dualzahl ohne Präfix

Code: byCode : BYTE := 255;

Eigenschaft Text: Coding: %08b

Eigenschaft Textvariable: PLC_PRG.byCode

Ausgabe: Coding: 11111111

o

%04o

Ausgabe als vorzeichenlose, ganzzahlig Oktalzahl ohne Präfix

Code: byCode : BYTE := 8#377;

Eigenschaft Text: Oktalzahl: %04o

Eigenschaft Textvariable: PLC_PRG.byCode

Ausgabe: Oktalzahl: 0377

x

%04x

Ausgabe als vorzeichenlose 32-Bit-Hexadezimalzahl mit Ziffern a-f (in Kleinbuchstaben) ohne Präfix und ohne Trennzeichen

Code: wCode : WORD := 16#1;

Eigenschaft Text: Coding: 16#%04x

Eigenschaft Textvariable: PLC_PRG.dwCode

Ausgabe: Coding: 16#0001

X

%08X

Ausgabe als vorzeichenlose 32-Bit-Hexadezimalzahl mit den Ziffern A-F (in Großbuchstaben) ohne Präfix und ohne Trennzeichen

Code: dwCode : DWORD := 16#FFFFFFFF;

Eigenschaft Text: Coding: %08X

Eigenschaft Textvariable: PLC_PRG.dwCode

Ausgabe: Coding: FFFFFFFF

llx

%016llx

Ausgabe als vorzeichenlose 64-Bit-Hexadezimalzahl mit den Ziffern a-f (in Kleinbuchstaben) ohne Präfix und ohne Trennzeichen

Hinweis: llx bedeutet „long long hexadecimal“

Empfohlene Datentypen: LWORD | LINT | ULINT

Code: lwCode : LWORD := 16#4FFF_3FFF_2FFF_1FFF;

Eigenschaft Text: Coding: 16#%016llx

Eigenschaft Textvariable: PLC_PRG.lwCode

Ausgabe: Coding: 16#4fff3fff2fff1fff

llX

%016llX

Ausgabe als vorzeichenlose 64-Bit-Hexadezimalzahl mit den Ziffern A-F (in Großbuchstaben) ohne Präfix und ohne Trennzeichen

Empfohlene Datentypen: LWORD | LINT | ULINT

Code: lwCode : LWORD := 16#4FFF_3FFF_2FFF_1FFF;

Eigenschaft Text: Coding: %016llX

Eigenschaft Textvariable: PLC_PRG.lwCode

Ausgabe: Coding: 4FFF3FFF2FFF1FFF

u

%5u

Ausgabe als vorzeichenlose, ganzzahlige Dezimalzahl

Empfohlene Datentypen: USINT | UINT | UDINT | ULINT

Code: uiNumber : UINT := 1234;

Eigenschaft Text: Number: %u

Eigenschaft Textvariable: PLC_PRG.uiNumber

Ausgabe: Number: 1234

Gleitpunktzahl in Festpunktschreibweise

Gleitpunktzahlen können in Festpunktschreibweise als Dezimalzahl dargestellt werden. Die Formatangabe dafür folgt folgendem Schema:

% <flags> <minimum number of digits> . <accuracy> f

Empfohlene Datentypen für eine solche Platzhaltervariable: REAL | LREAL

Syntax

Beispiel

Beschreibung

Beispiel Visualisierung

<flags>

Optional und kombinierbar

-

%-12.9f

Ausrichtung linksbündig, bezogen auf die Mindestanzahl an Stellen

+

%+f

Immer mit Vorzeichen, auch bei positiven Zahlen

Code: lrVar : LREAL := 1.234567E-003;

Eigenschaft Text: lrVar: %+f

Eigenschaft Textvariable: PLC_PRG.lrVar

Ausgabe: lrVar: +0.001235

0

%012.3f

Stellen werden mit 0 aufgefüllt, bis die Mindestanzahl an Stellen inklusive Vorzeichen und Punkt erreicht ist

Code: lrVar : LREAL := 1.234567E-003;

Eigenschaft Text: lrVar: %012.3f

Eigenschaft Textvariable: PLC_PRG.lrVar

Ausgabe: lrVar: 00000000.001

<minimum number of digits> . <accuracy>

Optional

Wenn die Angabe fehlt, erfolgt die Ausgabe im Standardformat 1.6

<minimum number of digits>

%012.3f

Mindestanzahl an Stellen inklusive Vorzeichen und Punkt

Beispiel: 12

Code: lrVar : LREAL := 1.234567E-003;

Eigenschaft Text: lrVar: %012.3f

Eigenschaft Textvariable: PLC_PRG.lrVar

Ausgabe: lrVar: 000000000000.001

<accuracy>

%1.3f

Genauigkeit in Stellen nach dem Punkt

Beispiel: 3

Code: lrVar : LREAL := 1.234567E-003;

Eigenschaft Text: lrVar: %1.3f

Eigenschaft Textvariable: PLC_PRG.lrVar

Ausgabe: lrVar: 0.001

f

%f

Erforderlich

Formatbezeichner für Dezimalzahldarstellung mit Punkt

Code: rWeight : REAL := 0.123456789;

Eigenschaft Text: Weight: %f

Eigenschaft Textvariable: PLC_PRG.rWeight

Ausgabe: rWeight: 1.234568

Gleitpunktzahl in Exponentialschreibweise

Gleitpunktzahlen können in normierter Exponentialschreibweise mit Basis 10 dargestellt werden. Die Formatierungsangabe für Exponentialschreibweise folgt folgendem Schema:

% <flags> <minimum number of digits> . <accuracy> <type>

Empfohlene Datentypen für eine solche Platzhaltervariable: REAL | LREAL

Syntax

Beispiel

Beschreibung

Beispiel Visualisierung

<flags>

Optional und kombinierbar

-

%-12.3e

Ausrichtung linksbündig, bezogen auf die Mindestanzahl an Stellen

+

%+e

Immer mit Vorzeichen, auch bei positiven Zahlen

Code: lrVar : LREAL := 1.234567E-003;

Eigenschaft Text: lrVar: %+e

Eigenschaft Textvariable: PLC_PRG.lrVar

Ausgabe: lrVar: +1.234567e-003

0

%012.9e

Stellen werden mit 0 aufgefüllt, bis die Mindestanzahl an Stellen inklusive Vorzeichen und Punkt erreicht ist

Code: lrVar : LREAL := -1.234567E-003;

Eigenschaft Text: : %012.3f

Eigenschaft Textvariable: PLC_PRG.lrVar

Ausgabe: lrVar: -01.234e-003

<minimum number of digits> . <accuracy>

Optional

Wenn die Angabe fehlt, erfolgt die Ausgabe der Mantisse im Standardformat 1.6

<minimum number of digits>

%12.3e

Mindestanzahl an Stellen inklusive Vorzeichen (für Mantisse und Exponent), Punkt und Exponentzeichen ( E, e)

Beispiel: 12

Code: lrVar : LREAL := 1.234567E-003;

Eigenschaft Text: lrVar: %e

Eigenschaft Textvariable: PLC_PRG.lrVar

Ausgabe: lrVar: 1.234567.-003

<accuracy>

%12.3e

Genauigkeit der Mantisse in Stellen nach dem Punkt

Beispiel: 3

Code: lrVar : LREAL := -1.234567E-003;

Eigenschaft Text: %012.3e

Eigenschaft Textvariable: PLC_PRG.lrVar

Ausgabe: lrVar: -01.235e-003

<type>

Erforderlich

e

%e

Darstellung mit e

Code: rValue : REAL := 0.009876543210;

Eigenschaft Text: rValue: %e

Eigenschaft Textvariable: PLC_PRG.rValue

Ausgabe: rValue: 9.876544e-003

E

%E

Darstellung mit E

Code: rValue : REAL := 0.009876543210;

Eigenschaft Text: rValue: %E

Eigenschaft Textvariable: PLC_PRG.rValue

Ausgabe: rValue: 9.876544E-003

Zeit in ganzen Zahlen

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 eine spezielle Compiler-Define in den Übersetzungseigenschaften der Applikation gesetzt werden: VISU_MILLISEC_NOLEADING_ZERO.

Wenn der Ausgabetext in der Elementeigenschaft Text den Platzhalter %t mit einer Kennungen für eine Zeiteinheit enthält, wird eine Zeit, Zeitdauer oder ein Zeitintervall ausgegeben. Die Platzhaltervariable wird in der Eigenschaft Textvariable zugewiesen.

Der Platzhalter für eine Zeit pro Zeiteinheit folgt dem folgenden Schema:

%t[ <text> <time in unit> <text> ]

Empfohlene Datentypen: TIME, LTIME

Syntax

Beispiel

Beschreibung

Beispiel Visualisierung

<time in unit>

Erforderlich

Kennung für Zeiteinheit

Filtert aus dem Zeitwert die ganze Anzahl der angegebenen Zeiteinheit (Tage, Stunden, Minuten, Sekunden, Millisekunden)

Bei 64-Bit-Zeitwerten auch Mikrosekunden und Nanosekunden

Gültig für die folgenden Beispiele ist:

Code: ltTimeSpan : LTIME := LTIME#1D2H3M4S5MS6US7NS;;

Eigenschaft Textvariable: PLC_PRG.ltTimeSpan

d

%t[d]

Anzahl Tage ohne vorangestellter Null

Eigenschaft Text: Time span: %t[d] d

Ausgabe: Time span: 1 d

dd

%t[dd]

Anzahl ganzer Tage mit vorangestellter Null

Eigenschaft Text: Time span: %t[dd] days

Ausgabe: Time span: 01 days

H

%t[H]

Anzahl Stunden (0-23)

Eigenschaft Text: Time span: %t[H] h

Ausgabe: Time span: 2 h

HH

%t[HH]

Anzahl Stunden (00-23)

Eigenschaft Text: Time span: %t[HH] h

Ausgabe: Time span: 02 h

h

%t[h]

Anzahl Stunden (0-23)

Eigenschaft Text: Time span: %t[h] h

Ausgabe: Time span: 2 h

hh

%t[hh]

Anzahl Stunden (00-23)

Eigenschaft Text: Time span: %t[h] h

Ausgabe: Time span: 02 h

m

%t[m]

Anzahl Minuten (0-59) ohne vorangestellter Null

Eigenschaft Text: Time span: %t[m] m

Ausgabe: Time span: 3 m

mm

%t[mm]

Anzahl Minuten (00-59) mit vorangestellter Null

Eigenschaft Text: Period: %t[mm] m

Ausgabe: Time span: 03 m

s

%t[s]

Anzahl Sekunden (0-59) ohne vorangestellte Null

Eigenschaft Text: Time span: %t[s] s

Ausgabe: Time span: 4 s

ss

%t[ss]

Anzahl Sekunden (00-59) mit vorangestellter Null

Eigenschaft Text: Time span: %t[ss] s

Ausgabe: Time span: 04 s

ms

%t[ms]

Anzahl der Sekundenbruchteile in Millisekunden (0-999)

Eigenschaft Text: Time span: %t[ms] ms

Ausgabe: Time span: 005 ms

us

%t[us]

Anzahl der Sekundenbruchteile in Mikrosekunden (0-999)

Nur bei Datentyp LTIME

Eigenschaft Text: Time span: %t[us] µs

Ausgabe: Time span: 006 µs

Hinweis: Ein Überlauf in der höchsten Zeiteinheit einer Angabe ist erlaubt.

ns

%t[ns]

Anzahl der Sekundenbruchteile in Nanosekunden (0-999)

Nur bei Datentyp LTIME

Eigenschaft Text: Time span: %t[ns] ns

Ausgabe: Time span: 007 ns

Hinweis: Ein Überlauf in der höchsten Zeiteinheit einer Angabe ist erlaubt.

<text>

%t[ns nanoseconds]

%t[ns 'ns']

Optional

Zeichenfolgen, die innerhalb der eckigen Klammern angegeben sind, werden mit ausgegeben

Hinweis: Wenn eine Zeichenfolge ausgegeben werden soll, die einer Kennung für eine Zeiteinheit entspricht oder die Kennungen für Zeiteinheiten enthält, muss die Zeichenfolge in einfache Anführungszeichen gefasst werden.

Eigenschaft Text: %t[Time span: ns nanoseconds]

Ausgabe: Time span: 007 nanoseconds

Eigenschaft Text: %t[Time span: ns 'ns']

Ausgabe: Time span: 007 ns

Innerhalb der eckigen Klammern können Kennungen für Zeiteinheiten beliebig oft vorkommen und mit beliebigen Zeichenfolgen abwechseln.

Syntax

Beispiel

Beschreibung

Beispiel Visualisierung

%t[dd-HH.m.s.ms.us.ns]

Zeitformat für alle Zeiteinheiten, mit den üblichen Trennzeichen dazwischen

Eigenschaft Text: Value: %t[dd-HH:mm:ss:ms:us:ns]

Ausgabe: Value: 01-02:03:04:005:006:007

%t[dd-HH:mm:ss:ms:us:ns]

Format mit zusätzlichen Zeichenfolgen, die ausgegeben werden sollen, ohne dass Kennungen für Zeiteinheiten beachtet werden

Solche Zeichenfolgen werden in einfache Anführungszeichen gefasst.

Eigenschaft Text: Time span %t[dd-HH:mm:ss:ms:us:ns]

Ausgabe: Time span: 01-02:03:04:005:006:007

Zeit als Dezimalzahl

Empfohlene Datentypen: TIME, LTIME

In der Formatangabe kann die Zeitdauer <time in unit> mit der Dezimalstellenkennung <number of decimal places> gekennzeichnet werden. Das bewirkt, dass die Zeitdauer als Dezimalzahl (mit Nachkommastellen) in der angegebenen Zeiteinheit formatiert wird. Das ist bei folgenden Zeitformaten möglich: HH | H | hh | h| mm | m | ss | s | ms |us | ns. Nützlich kann das bei Benutzereingaben sein.

Der Platzhalter für eine Zeitdauer als Dezimalzahl folgt dem folgenden Schema:

%t[ <time in unit> <number of decimal places>]

Syntax

Beispiel

Beschreibung

Beispiel Visualisierung

<time in unit>

Erforderlich

Kennung für Zeiteinheit, die den Zeitwert in der angegebenen Zeiteinheit (Tage, Stunden, Minuten, Sekunden, Millisekunden) als Dezimalzahl formatiert

Bei 64-Bit-Zeitwerten auch Mikrosekunden und Nanosekunden

<number of decimal places>

Erforderlich

Maximale Anzahl an Nachkommastellen (>=0), die angezeigt oder eingegeben werden

Hinweis: Auch wenn keine Nachkommastellen für die Eingabe oder Anzeige gewünscht ist, muss zumindest die Zahl 0 angegeben werden, um eine gebrochene Eingabe zu ermöglichen.

Die Voraussetzungen gelten für die folgenden Beispiele:

Code: ltTime : LTIME;

Eigenschaft Textvariable: PLC_PRG.ltTime

HH

H

hh

h

%t[hh4]

%t[h4]

Zeitwert in Stunden als Dezimalzahl

Anzahl Stunden (0-23)

Beispiel: 4

Eigenschaft Text: %t[hh2]

Benutzereingabe: 1.25

Zeitwert: ltTime = T#1h15m

mm

m

%t[mm2]

%t[m2]

Zeitwert in Minuten als Dezimalzahl

Beispiel: 2

Benutzereingabe: 1.25

Zeitwert ltTime = T#1M15S

ss

s

%t[ss3]

Zeitwert in Sekunden als Dezimalzahl

Beispiel: 3

Benutzereingabe: 1.25

Zeitwert ltTime = T#1S250MS

%t[ss0]

Beispiel: 0

Benutzereingabe: 1000

Zeitwert ltTime = T#16M40S

ms

%t[ms3]

Zeitwert in Millisekunden als Dezimalzahl

Beispiel: 3

Benutzereingabe: 1.25

Zeitwert ltTime = T#1MS250MS

us

%t[us3]

Zeitwert in Mikrosekunden als Dezimalzahl

Beispiel: 3

Benutzereingabe: 1.25

Zeitwert ltTime = T#1US250NS

ns

%t[ns0]

Zeitwert in Nanosekunden als Dezimalzahl

Beispiel: 0

Benutzereingabe: 125

Zeitwert ltTime = T#125NS

Systemzeit

Wenn einem Platzhalter mit Formatangabe keine Variable zugeordnet ist, wird die Systemzeit ausgegeben.

Syntax

Beispiel

Beschreibung

Beispiel Visualisierung

t

%t[HH:mm:ss:ms]

Ausgabe der aktuellen Systemzeit

Voraussetzung: Unter der Eigenschaft Textvariable ist keine Variable angegeben

Eigenschaft Text: Time: %t[HH:mm:ss:ms]

Eigenschaft Textvariable: leer

Ausgabe: Time: 08:59:59:999

Z

%t[dd:MM:yyyy HH:mm:ss:ms:Z]

Optional

Ausgabe des Offsets der lokalen Systemzeit zur Weltzeit (UTC)

Eigenschaft Text: Time: %t[dd:MM:yyyy HH:mm:ss:ms:Z]

Abhängig von der UTC-Variable VisuElems.Visu_DateTime.DisplayUTC wird folgendermaßen dargestellt:

  • TRUE -> Time: 01.08.2021 04:59:59:999:Z

  • FALSE -> Time: 01.08.2021 06:59:59:999:+02:00

Tipp

Sie können programmatisch die lokale Zeitzone der Systemzeit auf die Weltzeit (UTC) umschalten.

Wenn die Variable VisuElems.Visu_DateTime.DisplayUTC auf TRUE gesetzt ist, erfolgt die Darstellung der Systemzeit in Weltzeit (UTC). Standardmäßig ist die Variable VisuElems.Visu_DateTime.DisplayUTC auf FALSE gesetzt ist, so dass die Systemzeit in der lokalen Zeitzone dargestellt wird.

Bei der Anzeige von Datums- und Zeitwerten können Sie den zugehörigen Formatstring um die Zeitzonenkennung Z erweitern. Bei Ausgabe in lokaler Systemzeit wird dann der Offset zur Weltzeit(UTC) angezeigt. Beispielsweise bewirkt dd:MM:yyyy HH:mm:ss:ms:Z die Ausgabe 01.08.2021 12:00:00:001:+02:00. Wenn die Zeit in Weltzeit (UTC) angezeigt wird, wird die UTC-Kennung angezeigt. Beispiel: 01.08.2021 10:00:00:001:Z

Datum und Uhrzeit

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.

Empfohlene Datentypen für Datums- und Uhrzeitangaben: DATE, DATE_AND_TIME, DT, LDATE, LDATE_AND_TIME, LDT, LTOD, TIME_OF_DAY, TOD

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

Der Formatstring für eine Datums- und Uhrzeitangabe folgt folgenden Schema:

%t[ <date and time unit> ]

Syntax

Beispiel

Beschreibung

Beispiel Visualisierung

<date and time unit>

Erforderlich

Kennung für Datums- und Uhrzeiteinheiten

Filtert aus dem Zeitwert (Datums- und Uhrzeit-Datentyp) den Wert für die angegebenen Einheit (Jahr, Monat, Tag, Stunde, Minute, Millisekunden)

Bei 64-Bit-Datums- und Uhrzeitwerten auch Mikrosekunden und Nanosekunden

yyyy

%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

yy

%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

y

%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

MMMM

%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

MMM

%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

MM

%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

M

%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

ddddd

%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

dddd

%t[dddd]

Wochentag als Name

Code: iDay : INT := 7;

Eigenschaft Text:: Day: %t[dddd]

Eigenschaft Textvariable: PLC_PRG.iDay

Ausgabe: Day: Sunday

ddd

%t[ddd]

Wochentag als abgekürzter Name

Code: iDay : INT := 7;

Eigenschaft Text:: Day: %t[ddd]

Eigenschaft Textvariable: PLC_PRG.iDay

Ausgabe: Day: Sun

dd

%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

d

%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

jjj

%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

HH

%t[HH]

Stunde im 24-Stunden-Format (01-24)

Beispiel

  • hh = 11: 11

  • hh = 12: 12

  • hh = 13: 13

  • hh = 23: 23

  • hh = 00: 24

  • hh = 01: 01

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

hh

%t[hh]

Stunde im 12-Stunden-Format (01-12)

Beispiel

  • hh = 11: 11

  • hh = 12: 12

  • hh = 13: 01

  • hh = 23: 11

  • hh = 00: 12

  • hh = 01: 01

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

%t[t]

Abkürzung A oder P im 12-Stunden-Format

A bei 00 <= hh <= 11

P bei 12 <= hh <= 23

Beispiel

  • hh = 11: 11 A

  • hh = 12: 12 P (Mittag)

  • hh = 13: 01 P

  • hh = 23:11 P

  • hh = 00: 12 A (Mitternacht)

  • hh = 01: 01

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

tt

%t[tt]

Abkürzung AM oder PM im 12-Stunden-Format

AM von 00 <= hh <= 11

PM von 12 <= hh <= 23

Beispiel

  • hh = 11: 11 AM

  • hh = 12: 12 PM (Mittag)

  • hh = 13: 01 PM

  • hh = 23: 11 PM

  • hh = 00: 12 AM (Mitternacht)

  • hh = 01: 01 AM

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

Innerhalb der eckigen Klammern können Kennungen für Datums- und Uhrzeit-Einheiten beliebig oft vorkommen und sich mit beliebigen Zeichenfolgen abwechseln.

Syntax

Beispiel

Beschreibung

Beispiel Visualisierung

%t[yyyy-MM-dd dddd]

Datum und Wochentag mit Trennzeichen dazwischen

Code: dateSet : DATE := DATE#2021-02-12;

Eigenschaft Text: Date: %t[yyyy-MM-dd dddd]

Eigenschaft Textvariable: PLC_PRG.dateSet

Ausgabe: Date: 2021-02-12 Friday

%t[HH:mm:ss:ms]

Uhrzeit

Code: dwTime : DWORD := 4294967295;

Eigenschaft Text: Time: %t[HH:mm:ss:ms]

Eigenschaft Textvariable: PLC_PRG.dwTime

Ausgabe: Time: 23:59:59:999

%t[HH 'h' mm 'm'ss 's' ms 'ms']

Wenn Zeichenfolgen ausgegeben werden sollen, die einer Formatangabe entsprechen, müssen diese in einzelne einfache Anführungszeichen gefasst werden.

Eigenschaft Text: %t['Time' HH 'h' mm 'm'ss 's' ms 'ms']

Ausgabe: Time: 23 h 59 m 59 s 999 ms

Text

Empfohlene Datentypen der Platzhaltervariable: STRING, WSTRING

Die Formatierungsangabe für Zeichenfolgen und Strings folgt folgendem Schema:

% <type>

Syntax

Beispiel

Beschreibung

Beispiel Visualisierung

<type>

c

%c

Ausgabe eines einzelnen Zeichens im Zeichensatz ASCII

Code: byteChar : BYTE := 16#41;

Eigenschaft Text: Key: %c

Eigenschaft Textvariable: PLC_PRG.byteChar

Ausgabe: Key: A

s

%s

Ausgabe einer Zeichenfolge

Empfohlene Datentypen: STRING | WSTRING

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

Eigenschaft Text: Name: %s

Eigenschaft Textvariable: PLC_PRG.strName

Ausgabe: Name: Paul Smith

Wenn für den Datentyp STRING die Kodierung in UTF-8 aktiviert ist, dann sind sprachspezifische Zeichen sowohl bei der Eingabe als auch bei der Ausgabe erlaubt. Sprachspezifische Zeichen sind beispielsweise Umlautzeichen oder chinesische Schriftzeichen.

Für weitere Informationen siehe: Dialog: Projekteinstellungen: Compile-Optionen

Prozentzeichen

Formatangaabe für die Ausgabe eines Prozentzeichens

Syntax

Beispiel

Beschreibung

Beispiel Visualisierung

&

%d%%

Ausgabe des Prozentzeichens

Mit Platzhaltervariable:

Code: iPercentage : INT := 80;

Eigenschaft Text: Valid until %d%%.

Eigenschaft Textvariable: PLC_PRG.iPercentage := 80;

Ausgabe: Valid until 80%

Eigenschaft Text: Valid until 90%%

Ausgabe: Valid until 90%

In diesem Abschnitt: