FB_GetTimeZoneInformation

Mit dem Funktionsbaustein können die Zeitzonen-Einstellungen des Betriebssystems ausgelesen werden.

VAR_INPUT

VAR_INPUT
    sNetID   : T_AmsNetID;
    bExecute : BOOL;
    tTimeout : TIME := DEFAULT_ADS_TIMEOUT;
END_VAR

sNetID: Hier kann ein String mit der Netzwerkadresse des TwinCAT-Rechners angegeben werden, dessen Zeitzonen-Einstellungen ausgelesen werden sollen (Typ: T_AmsNetID). Für den lokalen Rechner kann auch ein Leerstring angegeben werden.

bExecute: Über eine positive Flanke an diesem Eingang wird der Baustein aktiviert.

tTimeout: Gibt die Timeout-Zeit an, die bei der Ausführung des ADS-Kommandos nicht überschritten werden darf.

VAR_OUTPUT

VAR_OUTPUT
    bBusy  : BOOL;
    bError : BOOL;
    nErrId : UDINT;
    tzID   : E_TimeZoneID;
    tzInfo : ST_TimeZoneInformation;
END_VAR

bBusy: Bei der Aktivierung des Funktionsbausteins wird dieser Ausgang gesetzt und bleibt gesetzt, bis eine Rückmeldung erfolgt.

bError: Sollte ein Fehler bei der Übertragung des Kommandos erfolgen, dann wird dieser Ausgang gesetzt, nachdem der bBusy-Ausgang zurückgesetzt wurde.

nErrId: Liefert bei einem gesetzten bError-Ausgang die ADS-Fehlernummer.

tzID: Zusätzliche Sommer-/ Winterzeit-Informationen (nicht immer vorhanden) (Typ: E_TimeZoneID).

tzInfo: Bei Erfolg liefert diese Strukturvariable die aktuellen Zeitzone-Informationen des Betriebssystems (Typ: ST_TimeZoneInformation).

Beispiel:

Siehe in der Beschreibung des FB_SetTimeZoneInformation-Funktionsbausteins.

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)	Tc2_Utilities (System)