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. Intern wird eine Instanz des ADSREAD-Funktionsbausteins aufgerufen.
VAR_INPUT
VAR_INPUT
NETID :T_AmsNetId;
START :BOOL;
TMOUT :TIME := DEFAULT_ADS_TIMEOUT;
END_VAR
NETID: Hier kann die AmsNetId des TwinCAT-Rechners angegeben werden, dessen lokale Windows-Systemzeit ermittelt werden soll. Für den lokalen Rechner kann auch ein Leerstring angegeben werden.
START: Über eine positive Flanke an diesem Eingang wird der Baustein aktiviert.
TMOUT: Gibt die Timeout-Zeit an, die bei der Ausführung des ADS-Kommandos nicht überschritten werden darf.
VAR_OUTPUT
VAR_OUTPUT
BUSY :BOOL;
ERR :BOOL;
ERRID :UDINT;
TIMESTR :TIMESTRUCT;
END_VAR
BUSY: Bei der Aktivierung des Funktionsbausteins wird dieser Ausgang gesetzt und bleibt gesetzt, bis eine Rückmeldung erfolgt.
ERR: Sollte ein ADS-Fehler bei der Übertragung des Kommandos erfolgen, dann wird dieser Ausgang gesetzt, nachdem der BUSY-Ausgang zurückgesetzt wurde.
ERRID: Liefert bei einem gesetzten ERR-Ausgang die ADS-Fehlernummer.
TIMESTR: Struktur mit der lokalen Windows-Systemzeit.
Weitere Zeit-, Zeitzone-Funktionen und -Funktionsbausteine:
FB_TzSpecificLocalTimeToSystemTime, FB_TzSpecificLocalTimeToFileTime, FB_SystemTimeToTzSpecificLocalTime, FB_FileTimeTimeToTzSpecificLocalTime, FB_GetTimeZoneInformation, FB_SetTimeZoneInformation, NT_SetLocalTime, NT_GetTime, NT_SetTimeToRTCTime, F_TranslateFileTimeBias, FB_LocalSystemTime
Voraussetzungen
Entwicklungsumgebung | Zielplattform | Einzubindende SPS Bibliotheken |
|---|---|---|
TwinCAT v2.7.0 | PC or CX (x86) | TcPlcUtilities.Lib; Standard.Lib; PLCSystem.Lib; TcPLCAds.Lib; PLCHelper.Lib; |
TwinCAT v2.8.0 | PC or CX (x86) | TcUtilities.Lib |
TwinCAT v2.10.0 Build >= 1301 | CX (ARM) |