CURDATE

現在の日付を返す、スカラ日付/時間関数です。

Synopsis

{fn CURDATE()}
{fn CURDATE}

概要

CURDATE は引数を持たず、DATE 型として日付を返します。引数の括弧はオプションです。

既定では、CURDATE は以下の形式で日付を返します。

mm/dd/yyyy

異なる日付形式を指定するには、TO_DATE 関数を使用します。既定の日付形式を変更するには、DATE_FORMAT、YEAR_OPTION、または DATE_SEPARATOR オプションで SET OPTION コマンドを使用します。

現在の日付のみを返すには、CURDATE または CURRENT_DATE を使用します。これらの関数は、その値を DATE データ型で返します。現在の日付と時間を TIMESTAMP データ型で返す場合は、CURRENT_TIMESTAMP 関数、GETDATE 関数、および NOW 関数を使用できます。

埋め込み SQL を使用するときは、これらのデータ型の動作が異なります。DATE データ型は $HOROLOG 形式の整数として値を格納し、SQL で表示されるときは日付表示形式に変換され、埋め込み SQL から返されるときは整数として返されます。TIMESTAMP データ型は、同じ形式で値を格納および表示します。日付および時刻のデータ型は、CONVERT 関数を使用して変更できます。

例

以下の例は、ともに現在の日付を返します。

SELECT DISTINCT {fn CURDATE()} AS Today
FROM Sample.Person

SELECT DISTINCT {fn CURDATE} AS Today
FROM Sample.Person

以下の埋め込み SQL の例は、現在の日付を返します。この日付は $HOROLOG 形式で格納されるため、整数として返されます。

  &sql(SELECT {fn CURDATE()}
  INTO :a
  FROM Sample.Person)
  WRITE !,"Current date is: ",a

以下の例は、現在の日付以降の出荷日を示すすべてのレコードを返すために、CURDATE が SELECT 文でどのように使用されるかを示します。

SELECT * FROM Orders 
     WHERE ShipDate >= {fn CURDATE()}