DECIMAL 型への変換
文字列からの変換
厳密モード
変換元の型が NULL 許容型の場合、NULL 許容型を返します。
変換元の型が NULL 非許容型の場合、NULL 非許容型を返します。
BNF の定義
<decimal> ::= <whitespace>* <value> <whitespace>*
<whitespace> ::= " " | "\t" | "\n" | "\r" | "\f" | "\v"
<value> ::= <sign>? <significand> <exponent>?
<sign> ::= "+" | "-"
<significand> ::= <digits> "." <digits> | <digits> | <digits> "." | "." <digits>
<digits> ::= <digit>+
<digit> ::= "0" | "1" | "2" | "3" | "4" | "5" | "6" | "7" | "8" | "9"
<exponent> ::= <e_marker> <sign>? <digits>
<e_marker> ::= "e" | "E"
規則の説明
-
十進数字のみをサポートします。
-
指数表記をサポートします。
-
丸めをサポートします。
-
文字列の前後には、" "、"\t"、"\n"、"\r"、"\f"、"\v" など、任意の空白文字を使用できます。
-
整数部がオーバーフローした場合はエラーを返します。
-
形式が無効な場合はエラーを返します。
例
| 文字列 | Decimal(18, 6) | 備考 |
|---|---|---|
| "123.1234567" | 123.123457 | 丸め |
| "12345." | 12345.000000 | |
| "12345" | 12345.000000 | |
| ".123456" | 0.123456 | |
| " \t\r\n\f\v123.456 \t\r\n\f\v" | 123.456000 | 前後に空白文字あり |
| " \t\r\n\f\v+123.456 \t\r\n\f\v" | 123.456000 | 前後に空白文字と正符号あり |
| " \t\r\n\f\v-123.456 \t\r\n\f\v" | -123.456000 | 前後に空白文字と負符号あり |
| " \t\r\n\f\v+1.234e5 \t\r\n\f\v" | 123400.000000 | 指数表記 |
| " \t\r\n\f\v+1.234e+5 \t\r\n\f\v" | 123400.000000 | 正の指数を使った指数表記 |
| " \t\r\n\f\v+1.234e-1 \t\r\n\f\v" | 0.123400 | 負の指数を使った指数表記 |
| "123.456a" | Error | 無効な形式 |
| "1234567890123.123456" | Error | オーバーフロー |
非厳密モード
常に NULL 許容型を返します。
BNF の定義
<decimal> ::= <whitespace>* <value> <whitespace>*
<whitespace> ::= " " | "\t" | "\n" | "\r" | "\f" | "\v"
<value> ::= <sign>? <significand> <exponent>
<sign> ::= "+" | "-"
<significand> ::= <digits> | <digits> "." <digits> | <digits> "." | "." <digits>
<digits> ::= <digit>+
<digit> ::= "0" | "1" | "2" | "3" | "4" | "5" | "6" | "7" | "8" | "9"
<exponent> ::= <e_marker> <sign>? <digits>
<e_marker> ::= "e" | "E"
規則の説明
-
厳密モードで有効なすべての形式をサポートします。
-
オーバーフローした場合は NULL に変換します。
-
形式が無効な場合は NULL に変換します。
例
| 文字列 | Decimal(18, 6) | 備考 |
|---|---|---|
| "123.1234567" | 123.123457 | 丸め |
| "12345." | 12345.000000 | |
| "12345" | 12345.000000 | |
| ".123456" | 0.123456 | |
| " \t\r\n\f\v123.456 \t\r\n\f\v" | 123.456000 | 前後に空白文字あり |
| " \t\r\n\f\v+123.456 \t\r\n\f\v" | 123.456000 | 前後に空白文字と正符号あり |
| " \t\r\n\f\v-123.456 \t\r\n\f\v" | -123.456000 | 前後に空白文字と負符号あり |
| " \t\r\n\f\v+1.234e5 \t\r\n\f\v" | 123400.000000 | 指数表記 |
| " \t\r\n\f\v+1.234e+5 \t\r\n\f\v" | 123400.000000 | 正の指数を使った指数表記 |
| " \t\r\n\f\v+1.234e-1 \t\r\n\f\v" | 0.123400 | 負の指数を使った指数表記 |
| "123.456a" | NULL | 無効な形式 |
| "1234567890123.123456" | NULL | オーバーフロー |
BOOL 型からの変換
true は 1 に、false は 0 に変換されます。
厳密モード
オーバーフローした場合はエラーになります（例: cast bool as decimal(1, 1)）。
変換元の型が NULL 許容型の場合、NULL 許容型を返します。
変換元の型が NULL 非許容型の場合、NULL 非許容型を返します。
非厳密モード
オーバーフローした場合は NULL に変換します。
変換元の型が NULL 許容型の場合、NULL 許容型を返します。
変換元の型が NULL 非許容型の場合:
-
オーバーフローの可能性がある場合（例:
cast bool as decimal(1, 1)）、NULL 許容型を返します。 -
それ以外の場合は NULL 非許容型を返します。
整数型からの変換
厳密モード
オーバーフローした場合はエラーになります。
変換元の型が NULL 許容型の場合、NULL 許容型を返します。
変換元の型が NULL 非許容型の場合、NULL 非許容型を返します。
例
| int | Decimal(18, 9) | 備考 |
|---|---|---|
| 123 | 123.00000000 | |
| 2147483647 | Error | オーバーフロー |
非厳密モード
オーバーフローした場合は NULL に変換します。
変換元の型が NULL 許容型の場合、NULL 許容型を返します。
変換元の型が NULL 非許容型の場合:
-
オーバーフローの可能性がある場合（例:
cast int as decimal(1, 0)）、NULL 許容型を返します。 -
それ以外の場合は NULL 非許容型を返します（例:
cast int as decimal(18, 0)）。
例
| int | Decimal(18, 9) | 備考 |
|---|---|---|
| 123 | 123.00000000 | |
| 2147483647 | NULL | オーバーフロー |
FLOAT/DOUBLE 型からの変換
丸めをサポートします。
厳密モード
変換元の型が NULL 許容型の場合、NULL 許容型を返します。
変換元の型が NULL 非許容型の場合、NULL 非許容型を返します。
-
無限大と NaN はエラーになります。
-
オーバーフローした場合はエラーになります。
例
| float/double | Decimal(18, 3) | 備考 |
|---|---|---|
| 1.1239 | 1.124 | 丸め |
| 3.40282e+38 | Error | オーバーフロー |
| Infinity | Error | |
| NaN | Error |
非厳密モード
常に NULL 許容型を返します。
-
+/-Inf は NULL に変換されます。
-
NaN は NULL に変換されます。
-
オーバーフローした場合は NULL に変換します。
例
| float/double | Decimal(18, 6) | 備考 |
|---|---|---|
| 1.123456 | 1.123456 | |
| 3.40282e+38 | NULL | オーバーフロー |
| Infinity | NULL | |
| NaN | NULL |
DECIMAL 型同士の変換
丸めをサポートします。
厳密モード
オーバーフローした場合はエラーになります。
変換元の型が NULL 許容型の場合、NULL 許容型を返します。
変換元の型が NULL 非許容型の場合、NULL 非許容型を返します。
例
| Decimal(18, 8) | Decimal(10, 6) | 備考 |
|---|---|---|
| 1234.12345678 | 1234.123457 | 丸め |
| 12345.12345678 | Error | 整数部のオーバーフロー |
非厳密モード
オーバーフローした場合は NULL に変換します。
変換元の型が NULL 許容型の場合、NULL 許容型を返します。
変換元の型が NULL 非許容型の場合:
-
オーバーフローの可能性がある場合（例:
cast decimal(18, 0) as decimal(9, 0)）、NULL 許容型を返します。 -
それ以外の場合は NULL 非許容型を返します（例:
cast decimal(9, 0) as decimal(18, 0)）。
例
| Decimal(18, 8) | Decimal(10, 6) | 備考 |
|---|---|---|
| 1234.12345678 | 1234.123457 | 丸め |
| 12345.12345678 | NULL | 整数部のオーバーフロー |
DATE 型からの変換
サポートされていません。
DATETIME 型からの変換
サポートされていません。
TIME 型からの変換
サポートされていません。
その他の型からの変換
サポートされていません。