dl-breadcrumbs__homedl-breadcrumb-item__separatorConfiguration and programmingdl-breadcrumb-item__separatorProgramming with CODESYSdl-breadcrumb-item__separator...dl-breadcrumb-item__separatorCODESYS Visualizationdl-breadcrumb-item__separatorReference: Programming dl-breadcrumb-item__separatorPlaceholders with Format Definition dl-breadcrumb-item__separatorDate and time
dl-pagination__prev-inactivedl-pagination__prev-activedl-pagination__next-inactivedl-pagination__next-active
Date and time dl-permalink__symbolPermalink

Compatibility Notice

Compatibility Notice

In order to get the usual display, in V3.5 SP17 and higher, as a rule three digits are used for the output of fractions of a second (ms/µs/ns). Example: In ‎%t[dd-HH:mm:ss:ms]‎, ‎ms‎ is specified with three digits for the milliseconds. A zero is prepended to the two-digit ‎ms‎ number.If a two-digit output is desired (like before V3.5 SP17), then a special compiler define has to be set in the compiler properties of the application: ‎VISU_MILLISEC_NOLEADING_ZERO‎.

Recommended data types for date and time definitions: ‎DATE‎, ‎DATE_AND_TIME‎, ‎DT‎, ‎LDATE‎, ‎LDATE_AND_TIME‎, ‎LDT‎, ‎LTOD‎, ‎TIME_OF_DAY‎, ‎TOD‎

By default, the names of the days and months are displayed in English. When localized texts are used, the ‎System‎ text list has to be supplemented. This text list is automatically created in the “POUs” view when the ‎%t‎ placeholder is used. The English terms have to be used as the IDs here. The localization can be done for both the abbreviated names and full names.

The format string for a date and time definition has the following format:

‎%t[ <date and time unit> ]‎

Syntax

Example

Description

Example in Visualization

<date and time unit>

Required

Identification for date and time units

Filters from the time value (data type: date and time) the value for the specified unit (year, month, day, hour, minute, milliseconds)

For 64-bit date and time values, also microseconds and nanoseconds

‎yyyy‎

‎%t[yyyy]‎

Year with century

Code: ‎dateBy : DATE := DATE#2020-1-1;‎

“Text” property: ‎By the year %t[yyyy]‎

“Text variable” property: ‎PLC_PRG.dateBy‎

Output: ‎By the year 2020‎

‎yy‎

‎%t[yy]‎

Year without century (00–99)

Code: ‎dateSince : DATE := DATE#2000-1-1;‎

“Text” property: ‎Since: %t[yy]‎

“Text variable” property: ‎PLC_PRG.dateSince‎

Output: ‎Since: 00‎

‎y‎

‎%t[y]‎

Year without century (0–99)

Code: ‎dateSince : DATE := DATE#2000-1-1;‎

“Text” property: ‎Since: %t[y]‎

“Text variable” property: ‎PLC_PRG.dateSince‎

Output: ‎Since: 0‎

‎MMMM‎

‎%t[MMMM]‎

Month as full name

Code: ‎dateMonth : DATE := DATE#2016-1-1;‎

“Text” property: ‎Month: %t[MMMM]‎

“Text variable” property: ‎PLC_PRG.dateMonth‎

Output: ‎Month: January‎

‎MMM‎

‎%t[MMM]‎

Month as abbreviated name

Code: ‎dateMonth : DATE := DATE#2016-1-1;‎

“Text” property: ‎Month: %t[MMM]‎

“Text variable” property: ‎PLC_PRG.dateMonth‎

Output: ‎Month: Jan‎

‎MM‎

‎%t[MM]‎

Month as number (01–12)

Code: ‎dateMonth : DATE := DATE#2016-1-1;‎

“Text” property: ‎Month: %t[MM]‎

“Text variable” property: ‎PLC_PRG.dateMonth‎

Output: ‎Month: 01‎

‎M‎

‎%t[M]‎

Month as number (1–12)

Code: ‎dateMonth : DATE := DATE#2016-1-1;‎

“Text” property: ‎Month: %t[M]‎

“Text variable” property: ‎PLC_PRG.dateMonth‎

Output: ‎Month: 1‎

‎ddddd‎

‎%t[ddddd]‎

Day of week as number (1 = Monday – 7 = Sunday)

Code: ‎iDay : INT := 7;‎

“Text” property: ‎Day: %t[ddddd]‎

“Text variable” property: ‎PLC_PRG.iDay‎

Output: ‎Day: 7‎

‎dddd‎

‎%t[dddd]‎

Day of week as full name

Code: ‎iDay : INT := 7;‎

“Text” property: ‎Day: %t[dddd]‎

“Text variable” property: ‎PLC_PRG.iDay‎

Output: ‎Day: Sunday‎

‎ddd‎

‎%t[ddd]‎

Day of week as abbreviated name

Code: ‎iDay : INT := 7;‎

“Text” property: ‎Day: %t[ddd]‎

“Text variable” property: ‎PLC_PRG.iDay‎

Output: ‎Day: Sun‎

‎dd‎

‎%t[dd]‎

Day of month as number (01–31)

Code: ‎iDay : INT := 1;‎

“Text” property: ‎Day: %t[dd]‎

“Text variable” property: ‎PLC_PRG.iDay‎

Output: ‎Day: 01‎

‎d‎

‎%t[d]‎

Day of month as number (1–31)

Code: ‎iDay : INT := 1;‎

“Text” property: ‎Day: %t[d]‎

“Text variable” property: ‎PLC_PRG.iDay‎

Output: ‎Day: 1‎

‎jjj‎

‎%t[jjj]‎

Day of year as number (001–366)

Code: ‎dateOfNoReturn : DATE := DATE#2016-09-01;‎

“Text” property: ‎Day of no return: %t[jjj]‎

“Text variable” property: ‎PLC_PRG.dateOfNoReturn‎

Output: ‎Day of no return: 245‎

‎HH‎

‎%t[HH]‎

Hour in 24-hour format (00–23)

Example

  • ‎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;‎

“Text” property: ‎Ends at: %t[HH]:00‎

“Text variable” property: ‎PLC_PRG.todEnd‎

Output: ‎Ends at 17:00‎

‎hh‎

‎%t[hh]‎

Hour in 12-hour format (01–12)

Example

  • ‎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;‎

“Text” property: ‎Ends at: %t[hh] o'clock‎

“Text variable” property: ‎PLC_PRG.todEnd‎

Output: ‎Ends at: 05 o'clock‎

‎t‎

‎%t[t]‎

Abbreviation A or P in 12-hour format

A for ‎00 <= hh <= 11‎

P for ‎12 <= hh <= 23‎

Example

  • ‎hh = 11‎: 11 A

  • ‎hh = 12‎: 12 P (midday)

  • ‎hh = 13‎: 01 P

  • ‎hh = 23‎:11 P

  • ‎hh = 00‎: 12 A (midnight)

  • ‎hh = 01‎: 01

Code: ‎tClosed : TOD := TOD#17:17:17.17;‎

“Text” property: ‎Closed at %t[hh:mm t]‎

“Text variable” property: ‎PLC_PRG.tClosed‎

Output: ‎Closed at 05:17 P‎

‎tt‎

‎%t[tt]‎

Abbreviation AM or PM in 12-hour format

AM for ‎00 <= hh <= 11‎

PM for ‎12 <= hh <= 23‎

Example

  • ‎hh = 11‎: 11 AM

  • ‎hh = 12‎: 12 PM (midday)

  • ‎hh = 13‎: 01 PM

  • ‎hh = 23‎: 11 PM

  • ‎hh = 00‎: 12 AM (midnight)

  • ‎hh = 01‎: 01 AM

Code: ‎tClosed : TOD := TOD#17:17:17.17;‎

“Text” property: ‎Closed at %t[hh:mm tt]‎

“Text variable” property: ‎PLC_PRG.tClosed‎

Output: ‎Closed at 05:17 PM‎

Inside the brackets, identifications for date and time units can occur any number of times and can be interchanged with any strings.

Syntax

Example

Description

Example in Visualization

‎%t[yyyy-MM-dd dddd]‎

Date and day of the week with separators in between

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

“Text” property: ‎Date: %t[yyyy-MM-dd dddd]‎

“Text variable” property: ‎PLC_PRG.dateSet‎

Output: ‎Date: 2/12/2021 Friday‎

‎%t[HH:mm:ss:ms]‎

Time of day

Code: ‎dwTime : DWORD := 4294967295;‎

“Text” property: ‎Time: %t[HH:mm:ss:ms]‎

“Text variable” property: ‎PLC_PRG.dwTime‎

Output: ‎Time: 23:59:59:999‎

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

If strings should be output which correspond to a format definition, then these have to be represented in single straight quotation marks.

“Text” property: ‎%t['Time' HH 'h' mm 'm'ss 's' ms 'ms']‎

Output: ‎Time: 23 h 59 m 59 s 999 ms‎