NT_GetTime

Mit dem Funktionsbaustein NT_GetTime kann die lokale Windows-Systemzeit eines TwinCAT-Systems ermittelt werden (die lokale Windows-Systemzeit wird in der Taskleiste eingeblendet). Das Jahr, Monat, Tag, Wochentag, Stunde, Minute, Sekunde und Millisekunde werden in den Variablen der Struktur TIMESTRUCT abgelegt.

Eingänge

VAR_INPUT
    NETID  : T_AmsNetId;
    START  : BOOL;
    TMOUT  : TIME := DEFAULT_ADS_TIMEOUT;
END_VAR

Name	Typ	Beschreibung
NETID	T_AmsNetID	Hier kann die Netzwerkadresse des TwinCAT-Rechners angegeben werden, dessen lokale Windows-Systemzeit ermittelt werden soll. Für den lokalen Rechner kann auch ein Leerstring angegeben werden.
START	BOOL	Über eine positive Flanke an diesem Eingang wird der Baustein aktiviert.
TMOUT	TIME	Timeout-Zeit, die bei der Ausführung des ADS-Kommandos nicht überschritten werden darf.

Ausgänge

VAR_OUTPUT
    BUSY         : BOOL;
    ERR          : BOOL;
    ERRID        : UDINT;
    TIMESTR      : TIMESTRUCT;
END_VAR

Name	Typ	Beschreibung
BUSY	BOOL	Bei der Aktivierung des Funktionsbausteins wird dieser Ausgang gesetzt und bleibt gesetzt, bis eine Rückmeldung erfolgt.
ERR	BOOL	Sollte ein Fehler bei der Übertragung des Kommandos erfolgen, dann wird dieser Ausgang gesetzt, nachdem der BUSY-Ausgang zurückgesetzt wurde.
ERRID	ADS-Fehlernummer	Liefert bei einem gesetzten ERR-Ausgang den Fehlercode.
TIMESTR	TIMESTRUCT	Struktur mit der lokalen Windows-Systemzeit.

Beispiel:

Siehe: Beispiel: Software-Uhren (RTC, RTC_EX, RTC_EX2).

Weitere Zeit-, Zeitzone-Funktionen und -Funktionsbausteine:

Voraussetzungen

Entwicklungsumgebung	Zielplattform	Einzubindende SPS-Bibliotheken (Kategoriegruppe)
TwinCAT v3.1.0	PC oder CX (WES7/Win7/Win10: TC RT x86/x64, WEC6/7: TC RT x86, WEC7: TC CE7 ARMV7, TC/BSD: TC RT x64, TC OS ARMT2)	Tc2_Utilities (System)