INTERVAL YEAR TO MONTH Data Type | Data Types and Literals | Teradata Vantage - INTERVAL YEAR TO MONTH Data Type - Advanced SQL Engine - Teradata Database

SQL Data Types and Literals

Product
Advanced SQL Engine
Teradata Database
Release Number
17.05
17.00
Published
June 2020
Language
English (United States)
Last Update
2021-01-22
dita:mapPath
zsn1556242031050.ditamap
dita:ditavalPath
lze1555437562152.ditaval
dita:id
B035-1143
lifecycle
previous
Product Category
Teradata Vantage™

Identifies a field as an INTERVAL value defining a period of time in years and months.

Syntax

INTERVAL YEAR [ ( precision ) ] TO MONTH [ attributes [...] ]
precision
The permitted range of digits for YEAR, ranging from one to four.
The default is two.
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 YEAR TO MONTH is ANSI SQL:2011 compliant.

Internal Representation of INTERVAL YEAR TO MONTH

Conceptually, INTERVAL YEAR TO MONTH is a record with two fields.

Field Name Storage Format Total Length
YEAR SMALLINT 4 bytes
MONTH SMALLINT

External Representation of INTERNAL YEAR TO MONTH

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

Type Format
CHARACTER(precision + 4) '-y(precision)-mm'

An example value for INTERVAL YEAR(3) TO MONTH is ' 013-11'.

Range of Values

The range of values for the INTERVAL YEAR TO MONTH is as follows.

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

Implicit and Explicit INTERVAL YEAR TO MONTH 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 YEAR TO MONTH Data Type

The following statement creates a table with an INTERVAL YEAR TO MONTH column:

CREATE TABLE TimeInfo
  (Id INTEGER
  ,Offset INTERVAL YEAR (4) TO MONTH);