#日時間隔(<値>[, <単位>])

値を日時間隔型に変換します。

構文

#日時間隔(<値>[, <単位>])

#DTINTERVAL(<値>[, <単位>])

引数

<値>

日時を表わす文字列または秒を表わす数値または時刻を与えます。

<単位>

<値> が数値のとき，その単位を指定します。省略したときは０(秒単位)とみなされます。

例

#日時間隔('5日')	→	5日0時間0分0秒
#日時間隔('1-2-3-4')	→	1日2時間3分4秒
#日時間隔(1000)	→	0日0時間16分40秒
#日時間隔(10,3)	→	10日0時間0分0秒
#日時間隔(TIME'14:35')	→	0日14時間35分0秒

解説

• <値> は文字列型または算術型または時刻型でなければなりません。文字列型のときは，<値> を日時間隔型に変換します。これは，DTINTERVAL '<値>' と同じ結果を返します。 算術型のときは <値> を秒数を表わす数値とみなし，日時間隔型に変換します。 時刻型のときは，それを時間数とみなし，日時間隔型に変換します。日数は常にゼロです。
• <値> が数値のときは，その <単位> を指定することができます。次の表の文字列か数字で指定します。<単位> を省略したときは秒単位とみなされます。<値> が文字列型のときは無視されます。

  数値	文字	意味
  0	秒	秒単位 （既定値）
  1	分	分単位
  2	時	時単位
  3	日	日単位

戻り値

• <値> が文字列型のときは，それを日時間隔型に変換した結果を返します。<値> が算術型のときは，それを秒数や分数などとみなして日時間隔型に変換した結果を返します。<値> が時刻型のときは，それを時間数とみなして日時間隔型に変換した結果を返します。

関連項目

#年月間隔

#文字列

#秒