最終更新日 :
2021年4月28日
説明
日付と時刻の形式設定規則を使用して、日付時刻値を形式設定します。
戻り値
形式設定された日付時刻値。
履歴
ColdFusion 10:この関数が追加されました。
シンタックス
dateTimeFormat (date) dateTimeFormat (date [, mask]) dateTimeFormat (date [, mask, timeZone])
プロパティ
パラメーター |
説明 |
---|---|
date |
必須です。日付時刻オブジェクトです。値の範囲は西暦 100 ~ 9999 年です。 |
mask |
オプション。ColdFusion で日付表示に使用される文字です。
以下のマスクは、日付時刻全体の形式設定を指定するものです。他のマスクと組み合わせることはできません。
JDK7 と JDK8 では、w、ww、W および WW の各マスクが導入されています。 |
timeZone |
タイムゾーン情報です。次のいずれかの形式で指定できます。
|
例
<cfset todayDateTime = Now()> <body> <h3>DateTimeFormat Example</h3> <p>Today's date and time are <cfoutput>#todayDateTime#</cfoutput>. <p>Using DateTimeFormat, we can display that date and time in different ways: <cfoutput> <ul> <li>#DateTimeFormat(todayDateTime)# <li>#DateTimeFormat(todayDateTime, "yyyy.MM.dd G 'at' HH:nn:ss z")# <li>#DateTimeFormat(todayDateTime, "EEE, MMM d, ''yy")# <li>#DateTimeFormat(todayDateTime, "h:nn a")# <li>#DateTimeFormat(todayDateTime, "hh 'o''clock' a, zzzz")# <li>#DateTimeFormat(todayDateTime, "K:nn a, z")# <li>#DateTimeFormat(todayDateTime, "yyyyy.MMMMM.dd GGG hh:nn aaa")# <li>#DateTimeFormat(todayDateTime, "EEE, d MMM yyyy HH:nn:ss Z")# <li>#DateTimeFormat(todayDateTime, "yyMMddHHnnssZ", "GMT")# </ul> </cfoutput>
w、ww、W、WW のマスクを使用した例
<cfscript> dateTime = createDate(2016,2,1); writeOutput(dateTimeFormat(dateTime, "w")); writeOutput(' ' & dateTimeFormat(dateTime, "ww")); writeOutput(' ' & dateTimeFormat(dateTime, "W")); writeOutput(' ' & dateTimeFormat(dateTime, "WW")); </cfscript>
上記のコードサンプルの出力は次のようになります。
6 06 1 01