はじめに
関数リファレンス
- 関数の構成要素
定数
演算子
日付
関数
- 関数の概要
  - 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
システム変数
データ型リファレンス

関数リファレンス

前へ次へ

ADD_TO_DATE

指定された量をDate/Time値の一部に加算し、関数に渡した日付と同じ形式の日付を返します。

ADD_TO_DATEには、正または負の整数値を入力できます。ADD_TO_DATEを使用して、日付の以下の部分を変更することができます。

年: amount
引数に正または負の整数を入力します。年のフｫーマット文字列として、Y、YY、YYY、YYYYのいずれかを使用できます。例えば、SHIP_DATEカラムのすべての日付に10年を加えるには、式
ADD_TO_DATE( SHIP_DATE, 'YY', 10 )
を使用します。
月: amount
引数に正または負の整数を入力します。月のフォーマット文字列として、MM、MON、MONTHのいずれかを使用できます。例えば、SHIP_DATEカラムのすべての日付から10ヶ月を引くには、式
ADD_TO_DATE( SHIP_DATE, 'MONTH', -10 )
を使用します。
日: amount
引数に正または負の整数を入力します。日のフォーマット文字列として、D、DD、DDD、DY、DAYのいずれかを使用できます。例えば、SHIP_DATEカラムのすべての日付に10日を加えるには、式
ADD_TO_DATE( SHIP_DATE, 'DD', 10 )
を使用します。
時間: amount
引数に正または負の整数を入力します。時間のフｫーマット文字列として、HH、HH12、HH24のいずれかを使用できます。例えば、SHIP_DATEカラムのすべての日付に14時間を加えるには、式
ADD_TO_DATE( SHIP_DATE, 'HH', 14 )
を使用します。
分: amount
引数に正または負の整数を入力します。分の設定にはフォーマット文字列MIを使用します。例えば、SHIP_DATEカラムのすべての日付に25分を加えるには、式
ADD_TO_DATE( SHIP_DATE, 'MI', 25 )
を使用します。
秒: amount
引数に正または負の整数を入力します。秒の設定にはSSフォーマット文字列を使用します。例えば、SHIP_DATEカラムのすべての日付に59秒を加えるには、以下の式を使用します。
ADD_TO_DATE( SHIP_DATE, 'SS', 59 )

構文

ADD_TO_DATE( date, format, amount )

引数	必須/ オプション	説明
date	必須	Date/Timeデータ型。変更したい値を渡します。有効な式を必要に応じて入力できます。
format	必須	日付値の中で変更したい場所を指定するフォーマット文字列。フォーマット文字列は'mm'のように一重引用符で囲みます。フォーマット文字列は大文字と小文字を区別しません。
amount	必須	日付値を変更する値として、年数、月数、日数、時間数などを指定する整数値。整数を求める有効な式を必要に応じて入力できます。

戻り値

関数に渡した日付と同じ形式の日付。

関数に引数としてNULL値が渡された場合には、NULLです。

例

以下の式はすべて、DATE_SHIPPEDカラムの各日付に1か月を加算します。特定の月に存在しない日を作成する値を渡すと、

データ統合

ではその月の最後の日が返されます。例えば、1998年1月31日に1か月を追加すると、

データ統合

では1998年2月28日が返されます。

また、ADD_TO_DATEはうるう年を認識し、Jan 29 2000に1か月を加えます。

ADD_TO_DATE( DATE_SHIPPED, 'MM', 1 )
ADD_TO_DATE( DATE_SHIPPED, 'MON', 1 )
ADD_TO_DATE( DATE_SHIPPED, 'MONTH', 1 )

DATE_SHIPPED	RETURN VALUE
Jan 12 1998 12:00:30AM	Feb 12 1998 12:00:30AM
Jan 31 1998 6:24:45PM	Feb 28 1998 6:24:45PM
Jan 29 2000 5:32:12AM	Feb 29 2000 5:32:12AM (Leap Year)
Oct 9 1998 2:30:12PM	Nov 9 1998 2:30:12PM
NULL	NULL

以下の式はすべて、DATE_SHIPPEDカラムの各日付から10日を減算します。

ADD_TO_DATE( DATE_SHIPPED, 'D', -10 )
ADD_TO_DATE( DATE_SHIPPED, 'DD', -10 )
ADD_TO_DATE( DATE_SHIPPED, 'DDD', -10 )
ADD_TO_DATE( DATE_SHIPPED, 'DY', -10 )
ADD_TO_DATE( DATE_SHIPPED, 'DAY', -10 )

DATE_SHIPPED	RETURN VALUE
Jan 1 1997 12:00:30AM	Dec 22 1996 12:00AM
Jan 31 1997 6:24:45PM	Jan 21 1997 6:24:45PM
Mar 9 1996 5:32:12AM	Feb 29 1996 5:32:12AM (Leap Year)
Oct 9 1997 2:30:12PM	Sep 30 1997 2:30:12PM
Mar 3 1996 5:12:20AM	Feb 22 1996 5:12:20AM
NULL	NULL

以下の式はすべて、DATE_SHIPPEDカラムの各日付から15時間を減算します。

ADD_TO_DATE( DATE_SHIPPED, 'HH', -15 )
ADD_TO_DATE( DATE_SHIPPED, 'HH12', -15 )
ADD_TO_DATE( DATE_SHIPPED, 'HH24', -15 )

DATE_SHIPPED	RETURN VALUE
Jan 1 1997 12:00:30AM	Dec 31 1996 9:00:30AM
Jan 31 1997 6:24:45PM	Jan 31 1997 3:24:45AM
Oct 9 1997 2:30:12PM	Oct 8 1997 11:30:12PM
Mar 3 1996 5:12:20AM	Mar 2 1996 2:12:20PM
Mar 1 1996 5:32:12AM	Feb 29 1996 2:32:12PM (Leap Year)
NULL	NULL