Parameter Lists in Functions that User Period Types - Analytics Database - Teradata Vantage

SQL External Routine Programming

Deployment
VantageCloud
VantageCore
Edition
Enterprise
IntelliFlex
VMware
Product
Analytics Database
Teradata Vantage
Release Number
17.20
Published
June 2022
ft:locale
en-US
ft:lastEdition
2025-03-30
dita:mapPath
iiv1628111441820.ditamap
dita:ditavalPath
qkf1628213546010.ditaval
dita:id
qnu1472247494689
lifecycle
latest
Product Category
Teradata Vantage™

UDFs can define Period arguments and return values. A UDF passes a Period argument by a handle.

Here is an example of how to declare a scalar function that uses Period types:

/*****  C source file name: udfsamp.c  *****/
   
#define SQL_TEXT Latin_Text
#include <sqltypes_td.h>
   
void do_something( PDT_HANDLE          *aPDT,
                  PDT_HANDLE          *resultPDT,
                  char                sqlstate[6] )
{
     ...
}

The corresponding CREATE FUNCTION statement looks like this:

CREATE FUNCTION DO_SOMETHING(A PERIOD(TIMESTAMP))
        RETURNS PERIOD(DATE)
        LANGUAGE C
        NO SQL
        PARAMETER STYLE TD_GENERAL
        EXTERNAL NAME 'CS!udfsamp!td_udf/udfsamp.c';

For details on the PDT_HANDLE C data type, see C Data Types.