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' )