• 次の mask パラメータオプションのサポートを追加 : short、medium、long、および full。
  • TIMEFORMAT  
    説明

    米国英語の時刻形式設定規則に基づいて、時刻値を形式設定します。

     
    戻り値

    カスタム形式に形式設定された時刻値。マスクが指定されていない場合は、hh:mm tt 形式で時刻値が返されます。国際時刻形式については、LSTimeFormatを参照してください。

     
    カテゴリ

    日付および時刻関数、表示および書式制御関数

     
    関数のシンタックス
    TimeFormat(time [, mask ])
    
     
    関連項目

    CreateTime、Now、ParseDateTime、LSTimeFormat、DateFormat

     
    ヒストリ

    ColdFusion MX 6.1: ミリ秒を表すマスク文字 L および l が追加されました。

    ColdFusion MX:

    • 余分な文字の処理方法の変更 : この関数では、mask 値の中の余分な文字の処理方法が、以前のリリースとは変更になっています。具体的には次のとおりです。
      • ColdFusion 5 以前では、形式設定された時刻と、余分な文字のアポストロフィ区切りリストが返されます。たとえば、TimeFormat(Now(), "hh:mm:ss foo") は、8:17:23 f'o'o を返します。
      • ColdFusion MX では、形式設定された時刻と、余分な文字がそのまま返されます。たとえば上の例では、8:17:23 foo が返されます。
      • 余分な文字が一重引用符で囲まれている場合 (例 : 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  
    形式を指定するマスク文字からなる文字列です。
    • h: 時。1 桁の場合は先頭に 0 が付きません (12 時間形式)。
    • hh: 時刻。1 桁の場合は先頭に 0 が付きます (12 時間形式)。
    • H: 時。1 桁の場合は先頭に 0 が付きません (24 時間形式)。
    • HH: 時刻。1 桁の場合は先頭に 0 が付きます (24 時間形式)。
    • m: 分。1 桁の場合は先頭に 0 が付きません。
    • mm: 分。1 桁の場合は先頭に 0 が付きます。
    • s: 秒。1 桁の場合は先頭に 0 が付きません。
    • ss: 秒。1 桁の場合は先頭に 0 が付きます。
    • l または L: ミリ秒。l の場合は 3 桁です。L の場合は 2 桁です。
    • t: 午前および午後を表す 1 文字の時刻マーカー文字列 (A および P など)。
    • tt: 午前および午後を表す複数文字の時刻マーカー文字列 (AM および PM など)。
    • short: h:mm tt と同等。
    • medium: h:mm:ss tt と同等。
    • long: medium の内容の後に 3 文字のタイムゾーン。例 : 2:34:55 PM EST
    • full: long と同じ。