td_week_of_month
Purpose
Returns the nth full week from the beginning of the month to the specified date.
Syntax
where:
Syntax element… |
Specifies… |
SYSLIB |
the name of the database where the function is located. |
expression |
an expression that results in a DATE, TIMESTAMP, or TIMESTAMP WITH TIME ZONE value. |
ANSI Compliance
This is a Teradata extension to the ANSI SQL:2011 standard.
Argument Types
td_week_of_month is an overloaded scalar function. It is defined with the following parameter data types:
If the argument passed to the function does not match one of these declared data types, an error is returned indicating that the function does not exist.
For more information on overloaded functions, see “Function Name Overloading” in SQL External Routine Programming.
Result
The result is an INTEGER value from 0 to 5, representing the nth full week from the beginning of the month, where the first partial week is 0.
Usage Notes
The td_week_of_month function provides improved performance compared to using the Sys_Calendar.Calendar system view to obtain similar results.
For more information about the CALENDAR system view, see Data Dictionary.
Example
If the current date is May 01, 2010, the following queries return the value 0 as the result since May 01, 2010 falls on the first partial week of May.
SELECT td_week_of_month(CURRENT_DATE);
SELECT td_week_of_month(DATE '2010-05-01');