# LGF_GetClockState (FB / 1.0.0)

Übersicht

Autor: Simatic Systems Support

## Kurzbeschreibung

Diese Funktion liest die lokale Zeit, die Systemzeit und gibt den NTP-Status zurück.

### Baustein Schnittstelle

| LGF_GetClockState (FB) |
--- | --- | ---
|  |  |  |  | localTime |  |  | DTL
|  |  |  |  | systemTime |  |  | DTL
|  |  |  |  | isDaylightSavingTime |  |  | Bool
|  |  |  |  | ntpActivated |  |  | Bool
|  |  |  |  | error |  |  | Bool
|  |  |  |  | status |  |  | Word
|  |  |  |  | diagnostics |  |  | LGF_typeDiagnostics

### Output Parameter

Bezeichner | Datentyp | Beschreibung
--- | --- | ---
localTime | DTL | Lokal Zeit
systemTime | DTL | Systemzeit (UTC)
isDaylightSavingTime | Bool | Sommerzeit aktiv
ntpActivated | Bool | NTP-Client aktiviert
error | Bool | TRUE: Bei der Ausführung des FBs ist ein Fehler aufgetreten
status | Word | 16#0000 - 16#7FFF: Status des FBs, 16#8000 - 16#FFFF: Fehleridentifikation
diagnostics | LGF_typeDiagnostics | Diagnoseinformationen des FBs

### Status & Error Meldungen

Code / Wert | Bezeichner / Beschreibung
--- | ---
16#0000 | STATUS_FINISHED_NO_ERROR KEIN Fehler im Funktionsaufruf aufgetreten
16#8401 | ERR_NTP_SERVER_SYNC_MISSING Fehler: NTP-Client fehlende Zeitsynchronisation
16#8601 | ERR_READ_LOCAL_TIME Fehler: Lokalzeit lesen
16#8602 | ERR_READ_SYSTEM_TIME Fehler: Systemzeit lesen
16#8610 | ERR_READ_CLOCK_STATE Fehler: Uhrstatus lesen

## Benutzer definierte Datentypen

### LGF_typeDiagnostics (UDT / V1.0.1)

Diagnosestruktur zur Speicherung und Übertragung von Diagnoseinformationen von Blöcken über die Schnittstelle.

Bezeichner | Datentyp | Default Wert | Beschreibung
--- | --- | --- | ---
status | Word | 16#0000 | Status des Bausteins oder Fehleridentifikation beim Auftreten des Fehlers
subfunctionStatus | Word | 16#0000 | Status oder Rückgabewert von aufgerufenen FB's, FC's und Systembausteinen
stateNumber | DInt | 0 | Zustand in der Zustandsmaschine des Blocks, in dem der Fehler aufgetreten ist

## Funktionsbeschreibung

HINWEIS
  Bei aktivierter NTP-Zeit Synchronisation in der Hardware Konfiguration ist darauf zu achten, dass die Zeitzonen Einstellungen korrekt auf Ihre Lokale-Zeitzone eingestellt sind!

## Änderungshistorie

Version & Datum | Änderungsbeschreibung
--- | ---
| 1.0.0 | Simatic Systems Support
| 06.05.2025 | First released version