INTERVAL SECOND - 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 IntrvlSec
{
    DECIMAL4 fract_sec;
    SMALLINT whole_sec;
} IntrvlSec;

Usage

The fract_sec member is laid out as a DECIMAL(8,6) numeric field and only contains the fractional seconds. The whole_sec member contains the number of whole seconds.

The range of values defined for the SQL INTERVAL SECOND 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 INTERVAL SECOND type, see Teradata Vantage™ - Data Types and Literals, B035-1143.

Here is an example using INTERVAL SECOND in a UDF definition and IntrvlSec in a C function declaration.

SQL Function Definition Equivalent C Function Declaration
CREATE FUNCTION F1 (
  A INTERVAL SECOND(4,6) )
RETURNS INTERVAL SECOND
 ...;
void f1( IntrvlSec *a,
         IntrvlSec *result,
   ... )
{  ... }