Startseite
Business Logic / Control
Endless possibilities in data processing for your projects.
CONTROL Functions
Functions T
timedFuncEvents()
The function timedFuncEvents() returns up to a given max_count all planned start_times (occurrences) when WinCC OA timedFunc would trigger a (start-)event. This function also handles the time periods (broadcast periods) (see Timed function extension) within the range defined by ’r;valid from’ and ’r;valid until’.

Versionsinformationen
Release Notes, Update-Informationen, Zertifizierungen and häufig gestellte Fragen.
Konzepte
Ihr erster Schritt in die moderne und leistungsstarke Prozessvisualisierung.
Deployment
Topics, you need to know, before using WinCC OA.
Sicherheit
Wachsen sie in Bezug auf Cybersecurity über die Norm hinaus.
Engineering
Leistungsstarke Tools für einfache sowie komplexe Engineering-Aufgaben.
Datenmanagement
Klassifizieren, strukturieren und archivieren sie Ihre Daten.
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
  - 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
    - textEditor()
      Opens the text editor as a main window (not modally).
    - The Extension timedFuncConflicts()
      The timed function extension "timedFuncConflicts()" is designed to discover call conflicts between two or more timed functions. It compares the given parameters to analyze all conflicts and returns the result times.
    - trackZoomMode()
      Complies with the function "Rubber band zoom". After calling this function a cursor "cross" is displayed, which allows to create a window by left-clicking. The panel is scaled in accordance with the specified window size.
    - tanh()
      Calculates the hyperbolic tangent.
    - triggerAction()
      The function can be used to trigger an action from a GEDI or Script Editor extension script.
    - tan()
      Calculates the tangent.
    - tcpRead()
      Reads the data of a defined socket, which was opened with tcpOpen().
    - timedFuncEvents()
      The function timedFuncEvents() returns up to a given max_count all planned start_times (occurrences) when WinCC OA timedFunc would trigger a (start-)event. This function also handles the time periods (broadcast periods) (see Timed function extension) within the range defined by ’r;valid from’ and ’r;valid until’.
    - tr()
      The function translates the given combination (text, comment) into the requested language or the UI language if the lang argument is not given.
    - tcpShutdownOutput()
      Closes the write direction of a TCP socket.
    - timeFromGMT()
      Returns the difference between local time and GMT.
    - Timed function extension
      The timed function was extended and now provides several new functions:
    - throw()
      Signals an erroneous condition by using an error class variable.
    - tcpOpen()
      Opens the connection to a TCP/IP server socket.
    - triggerGlobalEvent()
      The function triggers a UI global event.
    - tcpWrite()
      Writes data to the defined socket.
    - timedFunc()
      Starts timed CTRL functions.
    - titleBar()
      Shows or hides the title bar in the specified module or in a child panel.
    - triggerEvent()
      The function triggers a specific event.
    - tcpClose()
      Closes a TCP/IP socket connection.
    - triggerEventWait()
      The function triggers a specific event and waits for the execution of the event.
    - throwError()
      Passes a WinCC OA error to the internal error handler.
    - tmpnam()
      Creates temporary file names.
  - Functions U
  - Functions V
  - Functions W
  - Functions X
  - Functions Y
  - Functions Z
- CtrlExtension
  Die CtrlExtension ermöglicht das Hinzufügen von benutzerdefiniertem C++-Code.
- CTRL-Debugger
  Der CTRL-Debugger ermöglicht ein Debuggen der Pogrammiersprache Control. Der Debugger kann über ein eigenes Panel verwendet werden, welches es auch erlaubt die Variablen zu beinflussen, Breakpoints zu setzen, usw.
- SQL in CONTROL
  Mit den Datenbankfunktionen besteht eine Möglichkeit, Werteabfragen von Datenpunkten und -elementen schnell durchzuführen.
- API Manager
  Das API von WinCC OA (Application Programming Interface) bietet eine Reihe von Funktionen, die es ermöglichen, dieses Prozessleitsystem um spezielle Manager zu erweitern.
Datenvisualisierung
User Interfaces, Trends und Reports für jeden Zweck und jedes Gerät.
Southbound Interfaces
Der Prozessanschluss zu den echten Maschinen/Sensoren.
Northbound Interfaces
Ihr Portal zur Cloud oder übergeordneten Systemen.
Konnektivität / Netzwerk Schnittstellen
Datenaustausch, APIs und moderne (Web) Technologien.
Benutzerverwaltung
Alles über Autorisierung, Authentifizierung und Login-Anpassung.
Verfügbarkeit
Wie sie maximale Systemverfügbarkeit erreichen können.
Reporting
Erstellen sie "State of the art"-Reports ohne Limits.
Erweiterungen
Nützliche Werkzeuge und Erweiterungen für spezielle Anforderungen.
Referenztabellen
Detaillierte und umfangreiche Inhalte für spezielle Projektanpassungen.
Videos & Tutorials
Videos zu speziellen Themen for schnelle Einblicke.
Dokumentation
Grundlegende Informationen über Bezeichnungen und Funktionsweisen innerhalb der Dokumentation.
Disclaimer
Erläuterungen zu Haftungsausschlüssen oder rechtlichen Hinweisen.

timedFuncEvents()

The function timedFuncEvents() returns up to a given max_count all planned start_times (occurrences) when WinCC OA timedFunc would trigger a (start-)event. This function also handles the time periods (broadcast periods) (see Timed function extension) within the range defined by ’r;valid from’ and ’r;valid until’.

Synopsis

timedFuncEvents(string dp, time start_check, unsigned max_count, dyn_time &occurrences);

Parameters


Parameter	Meaning
dp	Data point of type _TimedFunc that contains the schedule meaning when the timedFunc() would trigger a (start) event.
start_check	The time the check is started.
max_count	Maximum count of all planned start times.
occurrences	The start time occurrences.

Return value


Return value	Meaning
0	OK
-1	Error (lastError is set, see getLastError())

Errors

See above

EXAMPLE

Example with the following _TimedFunc DP "dp1":

Valid from: 20.9.07 17:16:36

Valid until: 1. 1.1970 1:00:00 (meaning no limit, zerohour)

Interval: 3600 (60 minutes)

Time: 70000, 77000 (times when the workFunc is called, specified as seconds since 00:00)

Mode 1: The mode 1 means Timing periods. See Timed function extension

Weekday: -2 ; -2 (meaning weekdays)

main()
{
  int rc;
  dyn_time dt;
  time tHelp;
  tHelp = makeTime(2007, 10, 10, 17 );
  rc = timedFuncEvents( "dp1", tHelp, 10, dt ); 
  /* timedFunc dp: "dp1", start_check: 10.10.07 17:00,maxCount: 
  10*/
  DebugN( rc, tHelp, dt);
}

The timedFuncEvents would return the following occurrences:

WCCOActrl2:[0][Wed Oct 10 17:00:00 2007 000][dyn_time 10 items

WCCOActrl2: 1:Wed Oct 10 19:26:40 2007 000

WCCOActrl2: 2:Wed Oct 10 20:26:40 2007 000

WCCOActrl2: 3:Wed Oct 10 21:23:20 2007 000

WCCOActrl2: 4:Thu Oct 11 19:26:40 2007 000

WCCOActrl2: 5:Thu Oct 11 20:26:40 2007 000

WCCOActrl2: 6:Thu Oct 11 21:23:20 2007 000

WCCOActrl2: 7:Fri Oct 12 19:26:40 2007 000

WCCOActrl2: 8:Fri Oct 12 20:26:40 2007 000

WCCOActrl2: 9:Fri Oct 12 21:23:20 2007 000

WCCOActrl2: 10:Mon Oct 15 19:26:40 2007 000

WCCOActrl2:]

Assignment

Miscellaneous functions

Availability

CTRL