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.

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.

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

3.5.16.0

© Copyright 2021, CODESYS GmbH