はじめに
トランスフォーメーション言語
定数
演算子
変数
日付
関数
- 関数の分類
  - 集計関数
  - 集計関数とNULL
    - フィルタ条件
  - バイナリ関数
  - 文字関数
  - 変換関数
  - データクレンジング関数
  - 日付関数
  - エンコード関数
  - 財務関数
  - 数値関数
  - 科学関数
  - 特殊関数
  - 文字列関数
  - テスト関数
  - 変数関数
  - ウィンドウ関数
- ABORT
- ABS
- ADD_TO_DATE
- AES_DECRYPT
- AES_ENCRYPT
- ASCII
- AVG
- BINARY_COMPARE
- BINARY_CONCAT
- BINARY_LENGTH
- BINARY_SECTION
- CEIL
- CHOOSE
- CHR
- CHRCODE
- COMPRESS
- CONCAT
- CONVERT_BASE
- COS
- COSH
- COUNT
- CRC32
- CUME
- DATE_COMPARE
- DATE_DIFF
- DEC_BASE64
- DEC_HEX
- DECODE
- DECOMPRESS
- EBCDIC_ISO88591
- ENC_BASE64
- ENC_HEX
- ERROR
- EXP
- FIRST
- FLOOR
- FV
- GET_DATE_PART
- GREATEST
- IIF
- IN
- INDEXOF
- INITCAP
- INSTR
- ISNULL
- IS_DATE
- IS_NUMBER
- IS_SPACES
- LAG
- LAST
- LAST_DAY
- LEAD
- LEAST
- LENGTH
- LN
- LOG
- LOOKUP
- LOWER
- LPAD
- LTRIM
- MAKE_DATE_TIME
- MAX (Dates)
- MAX (Numbers)
- MAX (String)
- MD5
- MEDIAN
- METAPHONE
- MIN (Dates)
- MIN (Numbers)
- MIN (String)
- MOD
- MOVINGAVG
- MOVINGSUM
- NPER
- PERCENTILE
- PMT
- POWER
- PV
- RAND
- RATE
- REG_EXTRACT
- REG_MATCH
- REG_REPLACE
- REPLACECHR
- REPLACESTR
- REVERSE
- ROUND (Dates)
- ROUND（数値）
- RPAD
- RTRIM
- SETCOUNTVARIABLE
- SET_DATE_PART
- SETMAXVARIABLE
- SETMINVARIABLE
- SETVARIABLE
- SHA256
- SIGN
- SIN
- SINH
- SOUNDEX
- SQRT
- STDDEV
- SUBSTR
- SUM
- SYSTIMESTAMP
- TAN
- TANH
- TIME_RANGE
- TO_BIGINT
- TO_CHAR (Dates)
- TO_CHAR（数値）
- TO_DATE
- TO_DECIMAL
- TO_FLOAT
- TO_INTEGER
- TRUNC (Dates)
- TRUNC（数値）
- UPPER
- VARIANCE
カスタム関数の作成
カスタム関数APIリファレンス

トランスフォーメーション言語リファレンス

10.5
- 10.4.0

前へ次へ

TO_CHAR（数値）

数値をテキスト文字列に変換します。TO_CHARは、日付を文字列にも変換します。

構文

TO_CHAR( numeric_value )

以下の表に、このコマンドの引数を示します。

引数	必須/ オプション	説明
numeric_value	必須	数値データタイプ。文字列に変換したい数値です。有効なトランスフォーメーション式を必要に応じて入力できます。

TO_CHARは、次のように倍精度浮動小数点数をテキスト文字列に変換します。

16桁までの倍精度浮動小数点数値を文字列に変換し、15桁までの精度を提供します。15桁を超える数値を渡すと、TO_CHARは数値を16桁に基づいて丸め、数値の文字列表現を科学的表記で返します。例えば、1234567890123456倍精度浮動小数点数値は、'1.23456789012346e+015'文字列値に変換されます。

（-1e16,-1e-16]および[1e-16, 1e16）の範囲の数値は、10進表記で返します。TO_CHARは、この範囲以外の数値を科学的表記で返します。例えば、10842764968208837340倍精度浮動小数点数値は、'1.08427649682088e+019'文字列値に変換されます。

TO_CHARは、次のように10進数値をテキスト文字列に変換します。

高精度モードの場合、TO_CHARは、28桁までの10進数値を文字列に変換します。28桁を超える10進数値を渡すと、TO_CHARは28桁を超える数値の科学的表記を返します。

低精度モードの場合、TO_CHARは、10進数値を倍精度浮動小数点数値として扱います。

小数点以下をTO_CHAR関数に渡し、入力値に小数点以下のスケールと一致させるための桁が足りない場合、TO_CHAR関数は値にゼロを追加します。

例えば、小数点以下のスケールが5で、行の値が7.6901の場合、TO_CHAR関数は入力値を7.69010として扱い、戻り値は「7.69010」になります。

戻り値

文字列。

関数にNULL値を渡した場合はNULLです。

倍精度浮動小数点数の変換例

次の式は、SALESポート内の倍精度浮動小数点数値を文字列に変換します。

TO_CHAR( SALES )

SALES	RETURN VALUE
1010.99	'1010.99'
-15.62567	'-15.62567'
10842764968208837340	'1.08427649682088e+019' (rounded based on the 16th digit and returns the value in scientific notation)
236789034569723	'236789034569723'
0	'0'
33.15	'33.15'
NULL	NULL

10進数値の変換例

次の式は、SALESポート内の10進数値を、高精度モードで文字列に変換します。

TO_CHAR( SALES )

SALES	RETURN VALUE
2378964536789761	'2378964536789761'
1234567890123456789012345679	'1234567890123456789012345679'
1.234578945469649345876123456	'1.234578945469649345876123456'
0.999999999999999999999999999	'0.999999999999999999999999999'
12345678901234567890123456799 （28より大きい）	'1.23456789012346e+028'