TIMEFORMAT | |
説明
米国英語の時刻形式設定規則に基づいて、時刻値を形式設定します。 |
|
戻り値
カスタム形式に形式設定された時刻値。マスクが指定されていない場合は、hh:mm tt 形式で時刻値が返されます。国際時刻形式については、LSTimeFormatを参照してください。 |
|
カテゴリ
日付および時刻関数、表示および書式制御関数 |
|
関数のシンタックスTimeFormat(time [, mask ]) |
|
関連項目
CreateTime、Now、ParseDateTime、LSTimeFormat、DateFormat |
|
ヒストリ
ColdFusion MX 6.1: ミリ秒を表すマスク文字 L および l が追加されました。 ColdFusion MX:
余分な文字が一重引用符で囲まれている場合 (例 : hh:mm:ss 'foo') には、ColdFusion 5 と ColdFusion MX のいずれでも、形式設定された時刻と余分な文字がそのまま返されます。たとえば上の例では、8:17:23 foo が返されます。 |
|
パラメータ
|
|
使用方法
日付時刻値を文字列として渡すときは、その値を引用符で囲む必要があります。引用符で囲まない場合、その値は日付時刻オブジェクトの数値表現として解釈されます。 日付および時刻の形式を設定する関数を使用しないと、データベースクエリーの結果の日付および時刻は、その順序や形式がばらばらになる可能性があります。日付や時刻を適切な形式で表示され、アプリケーションのユーザーに混乱を与えないようにするには、DateFormat 関数と TimeFormat 関数を使用して、クエリーからの日付時刻値を形式設定することをお勧めします。例と詳細については、www.coldfusion.com/Support/KnowledgeBase/SearchForm.cfm の TechNote 22183、「ColdFusion Server (5 and 4.5.x) with Oracle: Formatting Date and Time Query Results」を参照してください。 |
|
例<cfset todayDate = #Now()#> <body> <h3>TimeFormat の例</h3> <p>今日の日付 : <cfoutput>#todayDate#</cfoutput> <p>TimeFormat を使用すると、さまざまな形式で値を表示できます。 <cfoutput> <ul> <li>#TimeFormat(todayDate)# <li>#TimeFormat(todayDate, "hh:mm:ss")# <li>#TimeFormat(todayDate, "hh:mm:sst")# <li>#TimeFormat(todayDate, "hh:mm:sstt")# <li>#TimeFormat(todayDate, "HH:mm:ss")# </ul> </cfoutput> <p>1997-07-16T19:20 のような標準の ISO 8601 W3C による日付と時刻の 文字列を生成するには、DateFormat 関数、文字 T、および TimeFormat 関数を 組み合わせます。 例 : dateformat(now(), "yyyy-mm-dd")#T#TimeFormat(now(), "HH:mm:ss") produces:</p> <cfoutput>#dateformat(now(), "yyyy-mm-dd")#T#TimeFormat(now(), "HH:mm:ss")#</cfoutput> </body> |
TIME | |
変換する日付時刻値または文字列です。 |
MASK | |
形式を指定するマスク文字からなる文字列です。
|