SYSTEMTIME_TO_ISO8601

SYSTEMTIME_TO_ISO8601 1:

The function converts the Windows system time structure into a string in ISO 8601 format.

The result corresponds to the following scheme: YYYY-MM-DDThh:mm:ss.xxxTZD

FUNCTION SYSTEMTIME_TO_ISO8601 : STRING(39)

SYSTEMTIME_TO_ISO8601 2: Inputs

VAR_INPUT
    systemTime  : TIMESTRUCT;  (* Input time in system time format (struct) *)
    nBias       : INT;         (* Specifies the current bias, in minutes, for local time translation on this computer.
                                The bias is the difference between Coordinated Universal Time (UTC) and local time.
                                UTC = local time + bias *)    
    bUTC        : BOOL;        (* Specifies whether the systemTime is UTC or local time. *)
    nPrecision  : USINT(0..9); (* Precision. Number of decimal places of seconds. (0..9) *)
END_VAR

Name

Type

Description

systemTime

TIMESTRUCT

The structure with the Windows system time to be converted

nBias

INT

Indicates the current time offset in minutes between Coordinated Universal Time (UTC) and the local time. The following applies: UTC = local time + time offset.

bUTC

BOOL

Indicates whether the time specified at the input corresponds to UTC or local time.

nPrecision

USINT(0..9)

Specifies the accuracy of the seconds display as the number of decimal places.

Requirements

Development environment

Target platform

PLC libraries to be integrated (category group)

TwinCAT v3.1.4024

PC or CX (x86, x64, ARM)

Tc2_Utilities (System) >= 3.3.46.0