用于格式化和解析的数字模式
描述
诸如 to_number 和 to_char 之类的函数支持在字符串和 Decimal 类型的值之间进行转换。这些函数接受格式字符串，指示如何在这些类型之间进行映射。
语法
数字格式字符串支持以下语法
{ ' [ MI | S ] [ $ ]
[ 0 | 9 | G | , ] [...]
[ . | D ]
[ 0 | 9 ] [...]
[ $ ] [ PR | MI | S ] ' }
元素
每个数字格式字符串可以包含以下元素（不区分大小写）
-
0或9指定一个预期在
0和9之间的数字。格式字符串中的 0 或 9 序列与大小相同或更小的数字序列匹配。如果 0/9 序列以 0 开头并且位于小数点之前，则它要求精确匹配数字数量：在解析时，它只匹配大小相同的数字序列；在格式化时，结果字符串在数字序列的左侧添加零填充以达到相同的大小。否则，0/9 序列在解析时匹配任何大小相同或更小的数字序列，并在格式化时在结果字符串中用空格（如果在小数点之前）或零（如果在小数点之后）填充数字序列。请注意，如果大小大于 0/9 序列，则数字序列在格式化时将变为“#”序列。
-
.或D指定小数点的位
在解析时，输入字符串不需要包含小数点。
-
,或G指定
,分组（千位）分隔符的位置。每个分组分隔符的左侧和右侧必须有一个
0或9。在解析时，输入字符串必须与与数字大小相关的分组分隔符匹配。 -
$指定
$货币符号的位置。此字符只能指定一次。 -
S指定可选的“+”或“-”符号的位置。此字符只能指定一次。
-
MI指定可选的“-”符号的位置（没有“+”）。此字符只能指定一次。
在格式化时，它会为正值打印一个空格。
-
PR将负输入值映射到对应字符串中的包裹尖括号 (
<1>)。正输入值不会收到包裹尖括号。
函数类型和错误处理
to_number函数接受一个输入字符串和一个格式字符串参数。它要求输入字符串与提供的格式匹配，否则会引发错误。然后，该函数返回相应的 Decimal 值。try_to_number函数接受一个输入字符串和一个格式字符串参数。它的工作方式与to_number函数相同，只是如果输入字符串与给定的数字格式不匹配，它会返回 NULL 而不是引发错误。to_char函数接受一个输入十进制数和一个格式字符串参数。然后，该函数返回相应的字符串值。- 如果给定的格式字符串无效，所有函数都将失败。
示例
以下示例使用 to_number、try_to_number 和 to_char SQL 函数。
请注意，这些示例中大多数使用的格式字符串期望
- 开头有一个可选的符号，
- 后面跟着一个美元符号，
- 后面跟着一个 3 到 6 位的数字，
- 千位分隔符，
- 小数点后最多两位数字。
to_number 函数
-- The negative number with currency symbol maps to characters in the format string.
> SELECT to_number('-$12,345.67', 'S$999,099.99');
-12345.67
-- The '$' sign is not optional.
> SELECT to_number('5', '$9');
Error: the input string does not match the given number format
-- The plus sign is optional, and so are fractional digits.
> SELECT to_number('$345', 'S$999,099.99');
345.00
-- The format requires at least three digits.
> SELECT to_number('$45', 'S$999,099.99');
Error: the input string does not match the given number format
-- The format requires at least three digits.
> SELECT to_number('$045', 'S$999,099.99');
45.00
-- MI indicates an optional minus sign at the beginning or end of the input string.
> SELECT to_number('1234-', '999999MI');
-1234
-- PR indicates optional wrapping angel brakets.
> SELECT to_number('9', '999PR')
9
try_to_number 函数
-- The '$' sign is not optional.
> SELECT try_to_number('5', '$9');
NULL
-- The format requires at least three digits.
> SELECT try_to_number('$45', 'S$999,099.99');
NULL
to_char 函数
> SELECT to_char(decimal(454), '999');
"454"
-- '99' can format digit sequence with a smaller size.
> SELECT to_char(decimal(1), '99.9');
" 1.0"
-- '000' left-pads 0 for digit sequence with a smaller size.
> SELECT to_char(decimal(45.1), '000.00');
"045.10"
> SELECT to_char(decimal(12454), '99,999');
"12,454"
-- digit sequence with a larger size leads to '#' sequence.
> SELECT to_char(decimal(78.12), '$9.99');
"$#.##"
-- 'S' can be at the end.
> SELECT to_char(decimal(-12454.8), '99,999.9S');
"12,454.8-"
> SELECT to_char(decimal(12454.8), 'L99,999.9');
Error: cannot resolve 'to_char(Decimal(12454.8), 'L99,999.9')' due to data type mismatch:
Unexpected character 'L' found in the format string 'L99,999.9'; the structure of the format
string must match: [MI|S] [$] [0|9|G|,]* [.|D] [0|9]* [$] [PR|MI|S]; line 1 pos 25