apache > db
Apache DB Project
 
Font size:      

CAST

CAST

CAST converts a value from one data type to another and provides a data type to a dynamic parameter (?) or a NULL value.

CAST expressions are permitted anywhere expressions are permitted.

Syntax

CAST ( [ Expression | NULL | ? ]
    AS Datatype)

The data type to which you are casting an expression is the target type. The data type of the expression from which you are casting is the source type.

CAST Conversions Among SQL-92 Data Types

The following table shows valid explicit conversions between source types and target types for SQL data types.

Table 3. Explicit conversions between source types and target types for SQL data types

This table shows which explicit conversions between data types are valid. The first column on the table lists the source types, while the first row lists the target types. A "Y" indicates that the source to the target is a valid conversion.
TypesS
M
A
L
L
I
N
T
I
N
T
E
G
E
R
B
I
G
I
N
T
D
E
C
I
M
A
L
R
E
A
L
D
O
U
B
L
E
F
L
O
A
T
C
H
A
R
V
A
R
C
H
A
R
L
O
N
G


V
A
R
C
H
A
R

C
H
A
R


F
O
R


B
I
T


D
A
T
A

V
A
R
C
H
A
R


F
O
R


B
I
T


D
A
T
A

L
O
N
G


V
A
R
C
H
A
R


F
O
R


B
I
T


D
A
T
A

C
L
O
B
B
L
O
B
D
A
T
E
T
I
M
E
T
I
M
E
S
T
A
M
P
SMALLINTYYYYYYYY--------------------
INTEGERYYYYYYYY--------------------
BIGINTYYYYYYYY--------------------
DECIMALYYYYYYYY--------------------
REALYYYYYYY----------------------
DOUBLEYYYYYYY----------------------
FLOATYYYYYYY----------------------
CHARYYYY------YYY------Y--YYY
VARCHARYYYY------YYY------Y--YYY
LONG VARCHAR--------------YYY------Y--------
CHAR FOR BIT DATA--------------------YYYYY------
VARCHAR FOR BIT DATA--------------------YYYYY------
LONG VARCHAR FOR BIT DATA--------------------YYYYY------
CLOB--------------YYY------Y--------
BLOB----------------------------Y------
DATE--------------YY------------Y--Y
TIME--------------YY--------------YY
TIMESTAMP--------------YY------------YYY

If a conversion is valid, CASTs are allowed. Size incompatibilities between the source and target types might cause runtime errors.

Notes

In this discussion, the Derby SQL-92 data types are categorized as follows:

  • numeric
    • exact numeric (SMALLINT, INTEGER, BIGINT, DECIMAL, NUMERIC)
    • approximate numeric (FLOAT, REAL, DOUBLE PRECISION)
  • string
  • date/time

Conversions from Numeric Types

A numeric type can be converted to any other numeric type. If the target type cannot represent the non-fractional component without truncation, an exception is raised. If the target numeric cannot represent the fractional component (scale) of the source numeric, then the source is silently truncated to fit into the target. For example, casting 763.1234 as INTEGER yields 763.

Conversions from and to Bit Strings

Bit strings can be converted to other bit strings, but not character strings. Strings that are converted to bit strings are padded with trailing zeros to fit the size of the target bit string. The BLOB type is more limited and requires explicit casting. In most cases the BLOB type cannot be casted to and from other types.

Conversions of Date/Time Values

A date/time value can always be converted to and from a TIMESTAMP. If a DATE is converted to a TIMESTAMP, the TIME component of the resulting TIMESTAMP is always 00:00:00. If a TIME data value is converted to a TIMESTAMP, the DATE component is set to the value of CURRENT_DATE at the time the CAST is executed. If a TIMESTAMP is converted to a DATE, the TIME component is silently truncated. If a TIMESTAMP is converted to a TIME, the DATE component is silently truncated.

Example

SELECT CAST (miles AS INT)
FROM Flights
-- convert timestamps to text
INSERT INTO mytable (text_column)
VALUES (CAST (CURRENT_TIMESTAMP AS VARCHAR(100)))
-- you must cast NULL as a data type to use it
SELECT airline
FROM Airlines
UNION ALL
VALUES (CAST (NULL AS CHAR(2)))
-- cast a double as a decimal
SELECT CAST (FLYING_TIME AS DECIMAL(5,2))
FROM FLIGHTS
-- cast a SMALLINT to a BIGINT
VALUES CAST (CAST (12 as SMALLINT) as BIGINT)


Previous Page
Next Page
Table of Contents
Index