LGF_GetCalendarWeek_US (FC / V3.0.1)

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


DTL	date	Ret_Val	DInt
DTL	date	Ret_Val	DInt
		calendarDay	DInt
		calendarDay	DInt
		error	Bool
		error	Bool
		status	Word
		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
	01.00.00	Simatic Systems Support
	13.11.2019	First release based on spli from LGF_CalenderWeek (previously LGF_CalenderWeek_ISO)
	03.00.00	Simatic Systems Support
	23.04.2020	Set version to V3.0.0, harmonize the version of the whole library
	03.00.01	Simatic Systems Support
	19.01.2020	Insert documentation