TIMESTAMP - 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™

C Data Type Definition

typedef struct TimeStamp
{
    DECIMAL4 seconds;
    SMALLINT year;
    BYTEINT  month;
    BYTEINT  day;
    BYTEINT  hour;
    BYTEINT  minute;
} TimeStamp;

Usage

The seconds member is laid out as a DECIMAL(8,6) numeric field, which can represent up to two digits of whole seconds and six digits of fractional seconds.

The range of values defined for the SQL TIMESTAMP type applies to the input arguments and return argument of a function. A value outside the valid range of values produces an error. For details on the TIMESTAMP type, see Teradata Vantage™ - Data Types and Literals, B035-1143.

All TIMESTAMP values passed to a UDF are in Universal Coordinated Time (UTC), and all TIMESTAMP values that are returned from a UDF must be in UTC.

Here is an example using TIMESTAMP in a UDF definition and C function declaration.

SQL Function Definition Equivalent C Function Declaration
CREATE FUNCTION F1 (
  A TIMESTAMP )
RETURNS TIMESTAMP
 ...;
void f1( TimeStamp *a,
         TimeStamp *result,
   ... )
{  ... }