# LGF_GetCalendarWeek_US (FC / 3.0.1)

Übersicht

Autor: Siemens Digital Industry

## Kurzbeschreibung

Diese Funktion berechnet aus dem vorgegebenen Datum die Kalenderwoche und die Anzahl der Tage für die USA und viele anderen Länder, die seit dem Anfang des Jahres vergangen sind.

### Baustein Schnittstelle

| LGF_GetCalendarWeek_US (FC) |
--- | --- | ---
DTL |  |  | date |  | Ret_Val |  |  | DInt
|  |  |  |  | calendarDay |  |  | DInt
|  |  |  |  | error |  |  | Bool
|  |  |  |  | status |  |  | Word

### Input Parameter

Bezeichner | Datentyp | Beschreibung
--- | --- | ---
date | DTL | Datum zur Berechnung der Kalenderwoche und der Tage seit dem 1. Januar

### Output Parameter

Bezeichner | Datentyp | Beschreibung
--- | --- | ---
Ret_Val | DInt | Nummer der Kalenderwoche
calendarDay | DInt | Vergangene Tage seit 1.Januar für das angegebene Datum
error | Bool | FALSE: Kein Fehler / TRUE: Während der Ausführung des FB ist ein Fehler aufgetreten
status | Word | 16#0000-16#7FFF: Status des FB / 16#8000-16#FFFF: Fehleridentifikation (siehe folgende Tabelle)

### Status & Error Meldungen

Code / Wert | Bezeichner / Beschreibung
--- | ---
16#0000 | STATUS_NO_ERROR Status: kein Fehler aufgetreten
16#8201 | ERR_LIM_DATE Datum ausserhalb des gültigen Bereiches, es muss nach dem <1970-01-01 ; 2262-04-11> liegen

## Funktionsbeschreibung

### Zählweise für die USA und viele anderen Länder

- Kalenderwochen haben 7 Tage, beginnen an einem Sonntag und werden über das Jahr fortlaufend gezählt
- Die Kalenderwoche 1 eines Jahres ist diejenige, die den 1. Januar enthält.
- Jedes Jahr hat entweder 52 oder 53 Kalenderwochen.
- Ein Jahr hat 53 Kalenderwochen, wenn folgende Eigenschaften zutreffen:
  - Ein Gemeinjahr beginnt an einem Samstag und endet an einem Samstag.
  - Ein Schaltjahr beginnt entweder an einem Samstag und endet an einem Sonntag oder es beginnt an einem Freitag und endet an einem Samstag.
- Die Tage nach dem letzten Dezembersamstag können bereits zur ersten Kalenderwoche des Folgejahres gehören.

## Änderungshistorie

Version & Datum | Änderungsbeschreibung
--- | ---
| 1.0.0 | Simatic Systems Support
| 13.11.2019 | First release based on spli from LGF_CalenderWeek (previously LGF_CalenderWeek_ISO)
| 3.0.0 | Simatic Systems Support
| 23.04.2020 | Set version to V3.0.0, harmonize the version of the whole library
| 3.0.1 | Simatic Systems Support
| 19.01.2020 | Insert documentation