Version Information
Release Notes, Update information, Certifications and Frequently Asked Questions.
Concepts
Your first step into modern and powerful process visualization.
Deployment
Topics, you need to know, before using WinCC OA.
Security
Go beyond the norm in cybersecurity.
Engineering
Powerful tools for easy or complex engineering tasks.
Data Management
Classify, structure and archive your data.
Business Logic / Control
Endless possibilities in data processing for your projects.
- Introduction to CTRL
  An introduction to the product's own programming language Control(CTRL).
- Control Classes
  The overview of classes available in Control.
- Types of Control Functions
  An overview of the types of functions distinguished within Control.
- Control graphics
- CONTROL Functions
  - Funtions A
  - Funtions B
  - Funtions C
  - Funtions D
  - Functions E
  - Functions F
    - fclose()
      Closes a file.
    - folderSelector()
      Opens the folder selector dialog and writes the name of the selected folder to the string variable "path".
    - fileSelector()
      Opens the file selection dialog and returns the selected file name.
    - fscanfPL()
      Reads a file similar to fscanf() except changes to the current WinCC OA language before converting.
    - floor()
      Rounds down to an integer.
    - findExecutable()
      The function searches for the given executable and returns the full path to it or an empty string if not found.
    - fwrite()
      Writes a number of bytes from a blob variable to a file.
    - fprintfPL()
      Writes to a file similar to fprintf() except changes to the current WinCC OA language before converting.
    - fseek()
      Sets the pointer of the file f from the position whence to the position defined by the offset.
    - fontAdjust()
      This function adjusts the font attributes (specified via the mapping parameter) for the given font (specified via the font string).
    - fontToMapping()
      The function returns a mapping for a specified font string.
    - formatTimeUTC()
      Returns the UTC time in a particular format.
    - fabs()
      Returns the absolute value of x.
    - fflush()
      Writes data to a file.
    - fprintf()
      Writes to a file.
    - fswAddPath()
      The functions add a path for monitoring to the FileSystemWatcher.
    - formatDebug()
      Similar to the function Debug() but instead of writing to the log viewer returns the debug messages as string,.
    - fmod()
    - formatTime()
      Returns the time in a particular format.
    - fscanf()
      Reads a file.
    - fillSelector()
      Opens the filling pattern selector and writes the selection to a variable.
    - fileToString()
      This function loads an ASCII file and writes the contents into a string variable.
    - fontSelector()
      Opens the font type selector and writes the selection to a variable.
    - fopen()
      Opens a file.
    - feof()
      Examines whether an end of file has been noted.
    - formatSelector()
      Opens the format selector and writes the string format that has been selected on the format string variable.
    - fread()
      Reads a number of bytes from a file to a blob variable.
    - fscanfUL()
      Reads a file like fscanf(), but change to the current Windows user language before converting.
    - fileEditor()
      Opens text files such as .txt and .doc files in an editor. You can edit both plain and rich text.
    - fputs()
      Writes a string to a file.
    - fprintfUL()
      Writes to a file similar to fprintf() except changes to the current Windows user language before converting.
    - fgets()
      Returns a string from a file.
    - ftell()
      The ftell function obtains the current value of the file position indicator for the stream pointed to by f.
    - ferror()
      Examines whether a file error has been noted.
    - fswRemovePath()
      The function removes a path from the monitoring of the FileSystemWatcher.
  - Functions G
  - Functions H
  - Functions I
  - Functions J
  - Functions K
  - Functions L
  - Functions M
  - Functions N
  - Functions O
  - Functions P
  - Functions Q
  - Functions R
  - Functions S
  - Functions T
  - Functions U
  - Functions V
  - Functions W
  - Functions X
  - Functions Y
  - Functions Z
- CtrlExtension
  The CtrlExtension allows the addition of custom C++ code.
- CTRL Debugger
  You can use the CTRL debugger to debug the Control programming language. The debugger can be used via its own panel, which also enables the monitoring and setting of variable values during the execution of a script.
- SQL in CONTROL
  The database functions enable you to quickly carry out value queries on data points and elements.
- API Manager
  The WinCC OA API (Application Programming Interface) offers a number of functions adding special Managers to this process control system.
- NextGen Archiver Backend-API
  This chapter describes the NextGen Archiver Backend API
Data Visualization
User interfaces, Trends and Reports for every purpose and device.
Southbound Interfaces
The process connection to the actual machines/sensors.
Northbound Interfaces
Your portal to the cloud or supervising systems.
Web Connectivity / Network Interfaces
Data exchange, APIs and web technologies
User Management
All about authorization, authentication and login-customization.
Availability
How to get your system uptime to the maximum.
Reporting
Create state of the art project reports without limits.
Addons
Useful tools and enhancements for special demands.
Reference Tables
Detailed and extensive content for special project adaptation.
Videos & Tutorials
Explore the capabilities of WinCC OA with our carefully selected collection of video tutorials and guides.
WinCC OA Documentation
Basic information about terms and functions within the documentation.
Disclaimer
A brief clarification of liability exclusions or legal notices.

formatTimeUTC()

Returns the UTC time in a particular format.

Synopsis

string formatTimeUTC(string format, time t[, string milliFormat]);

Parameters


Parameter	Description
format	Output format (without milliseconds) or in HTTP or ISO format. If you specify the " HTTP" format, the function returns the UTC time in HTTP format and the milliseconds (string milliFormat) are ignored (see RFC 2616). if you specify the "ISO" format returns the UTC time in ISO format in a dateTime string.
t	time
milliFormat	Output format for the milliseconds

Return value

The function returns the UTC time format as a string or in the event of errors an empty string.

Error

With incorrect variable types or invalid arguments

Description

The function formatTimeUTC() determines the UTC time of the given time t in a format defined by the arguments format and milliFormat. The string format contains the formatting with an accuracy of seconds. The parameters available for this are those of the function strftime() of the ANSI C standard (see formatTime()).

The format fprintf() is used in the optional string milliFormat to specify milliseconds. The corresponding output will be appended to the expression generated by the first format specification.

Example

The following example outputs the week in the year, date and time in the local time (localTime) and UTC time (utcTime).

main()
{
  time t1;
  string localTime;
  string utcTime;
  setTime(t1,2010,6,1,15);
  localTime = formatTime("%W; %c", t1, " ms: %04d");
  utcTime = formatTimeUTC("%W; %c", t1, " ms: %04d");
  DebugN("Local: ", localTime);
  //Output: ["Local: "]["22; 6/1/2010 3:00:00 PM ms: 0000"]
  DebugN("UTC: ", utcTime);
  //Output: ["UTC: "]["22; 6/1/2010 1:00:00 PM ms: 0000"]
}

The following example returns a UTC dateTime string in ISO and in HTTP formats.

main()
{
  string dt1, dt2;
  dt1 = formatTimeUTC("ISO", makeTime(2014, 6, 30, 18, 30, 3,
  7));
  dt2 = formatTimeUTC("HTTP", makeTime(2014, 6, 30, 18, 30, 3,
  7));
  DebugN("format time UTC/ISO:", dt1);
  DebugN("format time UTC/HTTP:", dt2);
}

As of the version 3.20 ISO projects cannot be created anymore. Create UTF-8 projects instead.

Assignment

Time function

Availability

CTRL