15.00 - td_weekday_of_month - Teradata Database

Teradata Database SQL Functions, Operators, Expressions, and Predicates

Product
Teradata Database
Release Number
15.00
Content Type
Programming Reference
Publication ID
B035-1145-015K
Language
English (United States)
Last Update
2018-09-24

td_weekday_of_month

Purpose  

Returns the nth occurrence of the weekday in the month for 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_weekday_of_month is an overloaded scalar function. It is defined with the following parameter data types:

  • DATE
  • TIMESTAMP
  • TIMESTAMP WITH TIME ZONE
  • 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 1 to 5, representing the nth occurrence of the weekday in the month.

    Usage Notes

    The td_weekday_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 1 as the result since May 01, 2010 falls on the first Saturday of the month.

       SELECT td_weekday_of_month(CURRENT_DATE);
     
       SELECT td_weekday_of_month(DATE '2010-05-01');