DAYNAME

与えられた日付式の曜日名を含む文字列を返す、スカラ日付/時刻関数です。

Synopsis

{fn DAYNAME(date-expression)}

引数

列の名前や、他のスカラ関数の結果、または日付やタイムスタンプ・リテラルである式。

概要

DAYNAME は、指定された日付に該当する曜日名を返します。既定として返される曜日名は、Sunday、Monday、Tuesday、Wednesday、Thursday、Friday、Saturday です。

これらの既定曜日名の値を変更するには、WEEKDAY_NAME オプションで SET OPTION コマンドを使用します。

曜日名は、日付整数または以下の形式の日付文字列に対して算出されます。

yyyy-mm-dd hh:mm:ss

年部分 (yyyy) は、1841 から 9999 までの 4 桁の整数である必要があります。この範囲外の年や実在しない日付 (例えば、2002–14–07 や 2003–02–29) が指定された場合は、NULL 文字列を返します。2 桁の年は、1900 から 1999 の範囲と想定されます。

DATENAME 関数を使用して、同じ曜日情報を取得することもできます。TO_DATE を使用すると、その他の日付要素で曜日名または曜日の省略形を検索できます。曜日名に対応する整数を返すには、DAYOFWEEK、DATEPART、または TO_DATE を使用します。

以下のメソッド・コールを使用することで、Caché ObjectScript からこの関数を呼び出すこともできます。

例

以下の 2 つの例は、指定された日付 (2004 年 2 月 25 日) の曜日が水曜日なので、Wednesday という文字列を返します。

SELECT DISTINCT {fn DAYNAME('2004-02-25')} AS Weekday
FROM Sample.Person

SELECT DISTINCT {fn DAYNAME(59590)} AS Weekday
FROM sample.person

以下の例は、今日の曜日名を返します。

SELECT DISTINCT {fn DAYNAME({fn NOW()})} AS Weekday_Now
FROM Sample.Person

SELECT DISTINCT {fn DAYNAME(CURRENT_DATE)} AS Weekday_Now
FROM Sample.Person

SELECT DISTINCT {fn DAYNAME(CURRENT_TIMESTAMP)} AS Weekday_Now
FROM Sample.Person