LGF_GetCalendarWeek_US (FC / V3.0.1)

Overview

Author: Siemens Digital Industry

Short description

This function uses the specified date to calculate the calendar week and the number of days that have passed since the beginning of the year for the USA and many other countries.

Block Interface

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

Input parameter

IdentifierData type Description
dateDTL Date used to calculate the calendar week and days since 1 January

Output parameter

IdentifierData type Description
Ret_ValDInt Number of the calendar week.
calendarDayDInt Days past since January 1st on given date
errorBool FALSE: No error / TRUE: An error occurred during the execution of the FB
statusWord 16#0000-16#7FFF: Status of the FB / 16#8000-16#FFFF: Error identification (see following Table)

Status & Error codes

Code / ValueIdentifier / Description
16#0000STATUS_NO_ERROR
Status: no error occurred
16#8201ERR_LIM_DATE
Date out of the range, has to be greater than <1970-01-01 ; 2262-04-11>

Functional description

####### Counting method for the USA and many other countries

Change log

Version & DateChange description
01.00.00Simatic Systems Support
13.11.2019First release
based on spli from LGF_CalenderWeek (previously LGF_CalenderWeek_ISO)
03.00.00Simatic Systems Support
23.04.2020Set version to V3.0.0, harmonize the version of the whole library
03.00.01Simatic Systems Support
19.01.2020Insert documentation