17.10 - INTERVAL SECOND - Advanced SQL Engine - Teradata Database

Teradata Vantage™ - SQL External Routine Programming

Product
Advanced SQL Engine
Teradata Database
Release Number
17.10
Release Date
July 2021
Content Type
Programming Reference
Publication ID
B035-1147-171K
Language
English (United States)

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,
   ... )
{  ... }