DTFORMATPLCopen motion icon

FunctionClosedA function calculates a result according to the current value of its inputs. A function has no internal data and is not linked to declared instances. - Format the current date/time to a string with a custom format.

Inputs

FMT: STRING  Format string

Outputs

Q : STRING    String containing formatted date or time


  • The real-time clock may not be available on all controller hardware models. Please consult the controller hardware specifications for real-time clock availability.

Remarks

The format string may contain any character. Some special markers beginning with the '%' character indicates a date/time information:

%Y  Year including century (e.g. 2006)
%y  Year without century (e.g. 06)
%m  Month (1..12)
%d  Day of the month (1..31)
%H  Hours (0..23)
%M  Minutes (0..59)
%S  Seconds (0..59)

Example

(* let's say we are at July 04th 2006, 18:45:20 *)

   Q := DTFORMAT ('Today is %Y/%m/%d - %H:%M:%S');

(* Q is 'Today is 2006/07/04 - 18:45:20 *)

ST Language

Q := DTFORMAT (FMT);

FBD Language

FFLD Language

(* The function is executed only if EN is TRUE *)
(* ENO keeps the same value as EN *)

IL Language

Op1: LDClosed"Ladder diagram"
Ladder logic is a method of drawing electrical logic schematics. It is now a very popular graphical language for programming Programmable Logic Controllers (PLCs). It was originally invented to describe logic made from relays. The name is based on the observation that programs in this language resemble ladders, with two vertical "rails" and a series of horizontal "rungs" between them FMT
DTFORMAT
ST Q

See also

DAY_TIME