DateFormat

説明

米国の日付書式を使用して日付値を形式設定します。国際的な日付書式を使用する場合は、LSDateFormat を使用してください。

戻り値

指定したマスクに応じて形式設定された、日付を表す文字列。マスクを指定しないと、dd-mmm-yy の形式の値が返されます。

カテゴリ

日付および時刻関数

関数のシンタックス

関連項目

Now、CreateDate、LSDateFormat、LSParseDateTime、LSTimeFormat、ParseDateTime

履歴

ColdFusion（2021 リリース）アップデート 1：この関数のマスクに関する問題を修正しました。詳しくは、バグを参照してください。アップデート 1 に更新することをお勧めします。

ColdFusion（2021 リリース）：JVM フラグ -Dcoldfusion.datemask.useDasdayofmonth が追加されました。デフォルト値は false ですが、これを true に設定すると、マスクに D（大文字の D）が含まれている場合、マスクは値を d（小文字の d）として扱います（小文字の d はその月の何日であるかを示します）。そのため、このフラグが true に設定されている場合、dateformat(now(), "mm-D-yyyy") は dateformat(now(), "mm-d-yyyy") と同じになります。デフォルトでは、大文字の D は、その年の何日目であるかを指定するために使用されます。後述の例を参照してください。

ColdFusion（2018 リリース）アップデート 3、ColdFusion（2016 リリース）アップデート 10、ColdFusion 11 アップデート 18：入力形式 "m/d" または "d/m"（マスク m は有効な月、d は有効な日を示す）は有効な日付入力形式とは見なされなくなりました。例えば、例 2 を参照してください。

ColdFusion（2016 リリース）アップデート 3：次の変更が含まれています。

• マスク文字として小文字と大文字の両方を使用できるようになりました。
• 次のマスクが追加されました。
  • e／E：曜日。
  • f／F：その曜日がその月の何番目であるか。
  • k／K：何時であるか（1～24）。
  • w：その年の何週目であるかを表す数字 （先頭に 0 を付けない） 。
  • ww ：その年の何週目であるかを表す数字。1 桁の場合は 先頭にゼロを付ける  。

ColdFusion MX：mask パラメーターオプションの short、medium、long および full がサポートされるようになりました。

パラメーター

使用方法

日付時刻オブジェクトを文字列として渡すときは、そのオブジェクトを引用符で囲みます。引用符で囲まない場合、そのオブジェクトは日付時刻オブジェクトの数値表示として解釈されます。

日付および時刻の形式を設定する関数を使用しないと、データベースクエリの結果の日付時刻値は、その順序と形式がばらばらになる可能性があります。表示された日付および時刻をアプリケーションのユーザーが正しく理解できるようにするために、この関数と、LSDateFormat および LSTimeFormat 関数を使用して、結果セットの値を形式設定することをお勧めします。

例  1

出力

date is : 15-Nov-18
day in a week is : Thu
day of a week in a month : 3
hour in a day: 12
week of the year as a digit: 46
Week of the year as digits.Leading zero for single-digit week.: 46

例 2

上記のコードは想定どおりに動作し、次のような出力が得られます。

The date is: 04-10

ただし、次のコードでは、入力した日付が間違った形式なので、例外が発生します。

coldfusion.datemask.useDasdayofmonth

上記のフラグを D に設定した場合、次のスニペットでは、マスクを d に設定した場合と同じ出力が得られます。