16.20 - INTERVAL DAY TO MINUTE Data Type - Teradata Vantage NewSQL Engine

Teradata Vantage™ Data Types and Literals

prodname
Teradata Database
Teradata Vantage NewSQL Engine
vrm_release
16.20
category
Programming Reference
featnum
B035-1143-162K

Purpose

Identifies a field as an INTERVAL value defining a period of time in days, hours, and minutes.

Syntax



precision
The permitted range of digits for DAY, ranging from one to four.
The default is two.
HOUR is always two digits and MINUTE is always two digits.
attributes
Appropriate data type, column storage, or column constraint attributes.
See Core Data Type Attributes and Storage and Constraint Attributes for specific information.

ANSI Compliance

INTERVAL DAY TO MINUTE is ANSI SQL:2011 compliant.

Internal Representation of INTERVAL DAY TO MINUTE

Conceptually, INTERVAL DAY TO MINUTE is a record that has the following fields.

Field Name Storage Format Total Length
DAY SMALLINT 8 bytes (with 2 pad bytes)
HOUR SMALLINT
MINUTE SMALLINT

External Representation of INTERVAL DAY TO MINUTE

INTERVAL DAY TO MINUTE types are imported and exported in record and indicator modes as CHARACTER data using the client character set.

Type Format
CHARACTER(precision + 7) '-d(precision) hh:mm'

For example, for INTERVAL DAY (3) TO MINUTE, the value might be something like '-127 12:37'.

Range of Values

The range of values for INTERVAL DAY TO MINUTE is as follows.

Type and Precision Minimum Value Maximum Value
INTERVAL DAY(1) TO MINUTE -'9 23:59' '9 23:59'
INTERVAL DAY(2) TO MINUTE -'99 23:59' '99 23:59'
INTERVAL DAY(3) TO MINUTE -'999 23:59' '999 23:59'
INTERVAL DAY(4) TO MINUTE -'9999 23:59' '9999 23:59'
Decimal values are not allowed for Interval data types except for second intervals.

Implicit and Explicit INTERVAL DAY TO MINUTE Conversion

Teradata Database performs implicit conversion from one Interval data type to another Interval type in some cases. You can also use CAST to explicitly convert one Interval type to another.

Conversions are possible only within the same INTERVAL family. For example, you may convert a YEAR interval to months, but not to days or hours.

For more information, see “Data Type Conversions” in Teradata Vantage™ SQL Functions, Expressions, and Predicates, B035-1145.

Example: INTERVAL DAY TO MINUTE Data Type

The following statement creates a table with an INTERVAL DAY TO MINUTE column:

CREATE TABLE TimeInfo
  (Id INTEGER
  ,Offset INTERVAL DAY (4) TO MINUTE);