はじめに
関数リファレンス
- 関数の構成要素
定数
演算子
日付
関数
- 関数の概要
  - Aggregate関数
    - フィルタ条件
  - 変換関数
  - データクレンジング関数
  - 日付関数
  - エンコード関数
  - 財務関数
  - 水平拡張関数
  - 数値関数
  - 科学関数
  - 特殊関数
  - 文字列関数
  - テスト関数
  - ウィンドウ関数
    - ウィンドウ関数としての集計関数
    - ウィンドウ関数としてのネストされた集計関数
- 関数のクイックリファレンス
- 詳細モードの機能
- %OPR_CONCAT%
- %OPR_CONCATDELIM%
- %OPR_IIF%
- %OPR_SUM%
- ABORT
- ABS
- ADD_TO_DATE
- AES_DECRYPT
- AES_ENCRYPT
- AES_GCM_DECRYPT
- AES_GCM_ENCRYPT
- ASCII
- AVG
- CEIL
- CHOOSE
- CHR
- CHRCODE
- COMPRESS
- CONCAT
- CONVERT_BASE
- COS
- COSH
- COUNT
- CRC32
- CUME
- DATE_COMPARE
- DATE_DIFF
- DEC_BASE64
- DECODE
- DECOMPRESS
- ENC_BASE64
- ERROR
- EXP
- FIRST
- FLOOR
- FV
- GET_DATE_PART
- GREATEST
- IIF
- IN
- INDEXOF
- INITCAP
- INSTR
- IS_DATE
- IS_NUMBER
- IS_SPACES
- ISNULL
- LAG
- LAST
- LAST_DAY
- LEAD
- LEAST
- LENGTH
- LN
- LOG
- 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 (Numbers)
- RPAD
- RTRIM
- SET_DATE_PART
- SETCOUNTVARIABLE
- SETMAXVARIABLE
- SETMINVARIABLE
- SETVARIABLE
- SHA256
- SIGN
- SIN
- SINH
- SOUNDEX
- SQRT
- STDDEV
- SUBSTR
- SUM
- Systimestamp
- TAN
- TANH
- TO_BIGINT
- TO_CHAR (Dates)
- TO_CHAR（数値）
- TO_DATE
- TO_DECIMAL
- TO_FLOAT
- TO_INTEGER
- TRUNC (Dates)
- TRUNC（Numbers）
- UPPER
- VARIANCE
システム変数
データ型リファレンス

関数リファレンス

前へ次へ

TO_CHAR (Dates)

日付を文字列に変換します。TO_CHARは、数値を文字列に変換することもできます。TO_CHARフォーマット文字列を使用して、日付を任意の形式に変換できます。

構文

TO_CHAR( date [,format] )

引数	必須/ オプション	説明
date	必須	Date/Timeデータ型。文字列に変換したい日付値を渡します。有効な式を必要に応じて入力できます。
format	オプション	正しいTO_CHARフォーマット文字列を入力します。このフォーマット文字列は戻り値の形式を定義するものであり、date引数の値の形式を定義するものではありません。フォーマット文字列を省略すると、関数はデフォルト日付形式（MM/DD/YYYY HH24:MI:SS）の文字列を返します。

戻り値

文字列。

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

例

次の式は、DATE_PROMISEDカラム内の日付をMON DD YYYY形式のテキストに変換します。

TO_CHAR( DATE_PROMISED, 'MON DD YYYY' )

DATE_PROMISED	RETURN VALUE
Apr 1 1998 12:00:10AM	'Apr 01 1998'
Feb 22 1998 01:31:10PM	'Feb 22 1998'
Oct 24 1998 02:12:30PM	'Oct 24 1998'
NULL	NULL

format_string
引数を省略すると、TO_CHARはデフォルト日付形式の文字列を返します。

TO_CHAR( DATE_PROMISED )

DATE_PROMISED	RETURN VALUE
Apr 1 1998 12:00:10AM	'04/01/1997 00:00:01'
Feb 22 1998 01:31:10PM	'02/22/1997 13:31:10'
Oct 24 1998 02:12:30PM	'10/24/1997 14:12:30'
NULL	NULL

次の式は、カラム内の各日付の曜日を返します。

TO_CHAR( DATE_PROMISED, 'D' )

DATE_PROMISED	RETURN VALUE
04-01-1997 12:00:10AM	'3'
02-22-1997 01:31:10PM	'7'
10-24-1997 02:12:30PM	'6'
NULL	NULL

TO_CHAR( DATE_PROMISED, 'DAY' )

DATE_PROMISED	RETURN VALUE
04-01-1997 12:00:10AM	'Tuesday'
02-22-1997 01:31:10PM	'Saturday'
10-24-1997 02:12:30PM	'Friday'
NULL	NULL

次の式は、カラム内の各日付の日の部分を返します。

TO_CHAR( DATE_PROMISED, 'DD' )

DATE_PROMISED	RETURN VALUE
04-01-1997 12:00:10AM	'01'
02-22-1997 01:31:10PM	'22'
10-24-1997 02:12:30PM	'24'
NULL	NULL

次の式は、カラム内の各日付に対して、その年の通算何日目になるかを返します。

TO_CHAR( DATE_PROMISED, 'DDD' )

DATE_PROMISED	RETURN VALUE
04-01-1997 12:00:10AM	'091'
02-22-1997 01:31:10PM	'053'
10-24-1997 02:12:30PM	'297'
NULL	NULL

次の式は、カラム内の各日付の時の部分を返します。

TO_CHAR( DATE_PROMISED, 'HH' )
TO_CHAR( DATE_PROMISED, 'HH12' )

DATE_PROMISED	RETURN VALUE
04-01-1997 12:00:10AM	'12'
02-22-1997 01:31:10PM	'01'
10-24-1997 02:12:30PM	'02'
NULL	NULL

TO_CHAR( DATE_PROMISED, 'HH24' )

DATE_PROMISED	RETURN VALUE
04-01-1997 12:00:10AM	'00'
02-22-1997 01:31:10PM	'13'
10-24-1997 11:12:30PM	'23'
NULL	NULL

次の式は、日付値を文字列で表されたMJD値に変換します。

TO_CHAR( SHIP_DATE, 'J')

SHIP_DATE	RETURN_VALUE
Dec 31 1999 03:59:59PM	2451544
Jan 1 1900 01:02:03AM	2415021

次の式は、日付をMM/DD/YY形式の文字列に変換します。

TO_CHAR( SHIP_DATE, 'MM/DD/RR')

SHIP_DATE	RETURN_VALUE
12/31/1999 01:02:03AM	12/31/99
09/15/1996 03:59:59PM	09/15/96
05/17/2003 12:13:14AM	05/17/03

SSSSSフォーマット文字列をTO_CHAR式で使用することもできます。例えば、次の式はSHIP_DATEカラムの日付を深夜0時からの通算秒を示す文字列に変換します。

TO_CHAR( SHIP_DATE, 'SSSSS')

SHIP_DATE	RETURN_VALUE
12/31/1999 01:02:03AM	3783
09/15/1996 03:59:59PM	86399

TO_CHAR式では、YYフォーマット文字列はRRフォーマット文字列と同じ結果を返します。

次の式は、日付をMM/DD/YY形式の文字列に変換します。

TO_CHAR( SHIP_DATE, 'MM/DD/YY')

SHIP_DATE	RETURN_VALUE
12/31/1999 01:02:03AM	12/31/99
09/15/1996 03:59:59PM	09/15/96
05/17/2003 12:13:14AM	05/17/03

次の式は、カラム内の各日付について、その月の何週目であるかを返します。

TO_CHAR( DATE_PROMISED, 'W' )

DATE_PROMISED	RETURN VALUE
04-01-1997 12:00:10AM	'01'
02-22-1997 01:31:10AM	'04'
10-24-1997 02:12:30PM	'04'
NULL	NULL

次の式は、カラム内の各日付について、その年の何週目であるかを返します。

TO_CHAR( DATE_PROMISED, 'WW' )

DATE_PROMISED	RETURN VALUE
04-01-1997 12:00:10PM	'18'
02-22-1997 01:31:10AM	'08'
10-24-1997 02:12:30AM	'43'
NULL	NULL

ヒント

TO_CHARとTO_DATEを組み合わせて次のような関数を記述すれば、月の数値を対応する月の文字列に変換することができます。

TO_CHAR( TO_DATE( numeric_month, 'MM' ), 'MONTH' )

関数

ガイドをダウンロード

ページをウォッチ

フィードバックを送信

コミュニティ

Knowledge Base

Success Portal

Rename Saved Search

目次

関数リファレンス

関数リファレンス

TO_CHAR (Dates)

TO_CHAR (Dates)

構文

戻り値

例

ヒント