Oracle TO_NCHAR(number) 函数使用指南

Oracle TO_NCHAR(number) 是一个内置函数，它使用可选的格式参数将给定的数值转换为 VARCHAR2 数据类型的值。

Oracle TO_NCHAR(number) 语法

这里是 Oracle TO_NCHAR(number) 函数的语法：

TO_NCHAR(n [, fmt [, 'nlsparam' ] ])

参数

n

必需的。要转换的数值。

fmt

可选的。格式化字符串，比如：L99G999D99MI。

nlsparam

可选的。'nlsparam' 参数指定由数字格式元素返回的这些字符：

• 十进制字符
• 组分隔符
• 本地货币符号
• 国际货币符号

此参数可以采用以下格式：

NLS_NUMERIC_CHARACTERS = ''dg''
  NLS_CURRENCY = ''text''
  NLS_ISO_CURRENCY = territory

字符 d 和 g 分别表示十进制字符和组分隔符。它们必须是不同的单字节字符。在引号括起来的字符串中，必须在参数值周围使用两个单引号。货币符号有十个字符可用。

如果省略 'nlsparam' 或任何一个参数，则此函数使用您会话的默认参数值。

返回值

Oracle TO_NCHAR(number) 函数返回。

如果任意一个参数为 NULL， TO_NCHAR(number) 将返回 NULL。

Oracle TO_NCHAR(number) 示例

这里有几个展示了 Oracle TO_NCHAR(number) 函数用法的示例。

基本用法

下面是一个简单的示例用 Oracle TO_NCHAR(number) 函数将 123456.789 转为字符类型。

SELECT TO_NCHAR(123456.789)
FROM dual;

输出：

TO_NCHAR(123456.789)
_______________________
123456.789

虽然看起来输出和输入相同，但是您可以使用 DUMP() 函数查看他们之间的区别：

SELECT
    DUMP(123456.789),
    DUMP(TO_NCHAR(123456.789))
FROM dual;

输出：

DUMP(123456.789)                   DUMP(TO_NCHAR(123456.789))
__________________________________ __________________________________________________________________
Typ=2 Len=6: 195,13,35,57,79,91    Typ=1 Len=20: 0,49,0,50,0,51,0,52,0,53,0,54,0,46,0,55,0,56,0,57

格式

Oracle TO_NCHAR(number) 函数允许您指定输出的格式：

SELECT TO_NCHAR(1234567.89, '9G999G999D99')
FROM dual;

输出：

TO_NCHAR(1234567.89,'9G999G999D99')
______________________________________
 1,234,567.89

在本示例中， 9 代表任意数字， G 代表本地化千分位， D 代表本地化小数点。

您也可使用 0 以增加签到或者尾随 0：

SELECT TO_NCHAR(1234567.89, '009G999G999D000')
FROM dual;

输出：

TO_NCHAR(1234567.89,'009G999G999D000')
_________________________________________
 001,234,567.890

或者您可以使用一个 FM 前导符号以适应不同长度的数字：

SELECT TO_NCHAR(1234567.89, 'FM999G999G999G999G999G999D99')
FROM dual;

输出：

TO_NCHAR(1234567.89,'FM999G999G999G999G999G999D99')
______________________________________________________
1,234,567.89

请参考 Oracle 数字格式模型。

结论

Oracle TO_NCHAR(number) 是一个内置函数，它使用可选的格式参数将给定的数值转换为 VARCHAR2 数据类型的值。