CF2021～：DateFormatのマスクの指定に大文字Dを指定している場合の動作変更について

1. Home
2. » よくある質問(FAQ)
3. » タグ・関数・構文など
4. » CF2021～：DateFormatのマスクの指定に大文字Dを指定している場合の動作変更について

ColdFusion 2016 Update 3以降より、DateFormat関数のマスクの指定の際に、大文字と小文字の両穂うが使用できるようになりましたが、これに関連して、ColdFusion 2021では、マスクの指定の際に、大文字のDを指定した際の動作が変更されました。

従来のバージョンでは、マスクにDを指定してもdと同じ動作（日を数字で表示。1～31）になりましたが、ColdFusion 2021以降から、マスクに大文字のDを指定すると、その年の何日目であるかを表す数字が返されるようになりました。

2020年12月17日に下記のプログラムを実行
<cfscript>
    writeOutput(dateformat(now(), "mm-D-yyyy") & "")　// 戻り値　12-352-2020
    writeOutput(dateformat(now(), "mm-d-yyyy") & "")　// 戻り値　12-17-2020
</cfscript>

この動作の変更により、従来からのプログラムの移行において、DateFormatのマスクにDを使用していた場合には注意が必要です。

2021年4月更新

マスクに大文字の D を指定しても従来と同様の動作（ｄを指定した時と同じ動作）に戻す個別パッチ が公開され、その機能はUpdate 1以降に含まれるようになりました。そのため、以前の動作に戻したい場合は、Updateの適用を行ってください。

ColdFusion の DateFormat 関数（2021 リリース） (adobe.com)

ただし、Update 1を適用だけでは、以前の動作には切り替わりません。さらに、JVM フラグの追加が必要です。-Dcoldfusion.datemask.useDasdayofmonth=true を ColdFusion Administrator の「サーバーの設定 ＞ JavaとJVM」の「JVM引数」に追加（スペース区切りで改行は入れない）してください。その後、ColdFusion を再起動することで、従来の動作に戻すことができます。このフラグはDateFormat, DateTimeFormat関数のいずれにも有効です。

2024年2月更新

ColdFusion 2023も同様の動作となります。以前の動作に戻すには-Dcoldfusion.datemask.useDasdayofmonth=true を ColdFusion Administrator の「サーバーの設定 ＞ JavaとJVM」の「JVM引数」に追加（スペース区切りで改行は入れない）してください。その後、ColdFusion を再起動することで、従来の動作に戻すことができます。

※カテゴリを「ColdFusion 2021情報」から「タグ・関数・構文など」に変更しました

記事公開日：2020年12月17日
最終更新日：2024年02月22日