ColdFusion MX
目 次 > CFML リファレンス > ColdFusion 関数 > DateFormat O

DateFormat

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

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

日付および時刻関数

DateFormat("date" [, "mask" ])

Now、CreateDate、LSDateFormat、LSParseDateTime、LSTimeFormat、TimeFormat、ParseDateTime

ColdFusion MX: 以下の mask 属性オプションに対応 : short、medium、long、および full。

パラメータ

説明

date

西暦 100 ～ 9999 年の期間の日付/時刻オブジェクトです。

mask

ColdFusion で日付表示に使用される文字です。

  • d : 数字で表した日です。1 桁の場合は先頭に 0 を付けません。
  • dd: 数字で表した日です。1 桁の場合は先頭に 0 を付けます。
  • ddd: 3 文字に短縮して表した曜日です。
  • dddd: つづりを短縮しないで表した曜日です。
  • m : 数字で表した月です。1 桁の場合は先頭に 0 を付けません。
  • mm: 数字で表した月です。1 桁の場合は先頭に 0 を付けます。
  • mmm: 3 文字に短縮して表した月です。
  • mmmm:つづりを短縮しないで表した月です。
  • y : 下 2 桁の数字で表した年です。1 桁の場合は先頭に 0 を付けません。
  • yy : 下 2 桁の数字で表した年です。1 桁の場合は先頭に 0 を付けます。
  • yyyy : 4 桁の数字で表した年です。
  • gg: 時代および紀元を表す文字列です。無視されます。この値は予約されています。
    以下のマスクは、日付全体の形式設定を指定するものです。他のマスクと組み合わせることはできません。
  • short: m/d/y と同等です。
  • medium: mmm d, yyyy と同等です。
  • long: mmmm d, yyyy と同等です。
  • full: dddd, mmmm d, yyyy と同等です。

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

メモ: この CreateDate 関数、または Now 関数をこの関数の date パラメータとして 渡すことができます。
例 : #DateFormat(CreateDate(2001, 3, 3))#

日付および時刻の形式を設定する関数を使用しないと、データベースクエリの結果の日付および時刻は、その順序と形式がばらばらになる可能性があります。表示された日付および時刻をアプリケーションのユーザーが正しく理解できるようにするため、この関数と、LSDateFormat、TimeFormat、および LSTimeFormat 関数を使用して、結果セットの値を形式設定することをお勧めします。 詳細と例については、テクニカルノート 22183、「ColdFusion Server (5 and 4.5.x) with Oracle: Formatting Date and Time Query Results」を参照してください。弊社 Web サイト http://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>DateFormat の例</h3>
<p>今日の日付 : <cfoutput>#todayDate#</cfoutput>
<p>DateFormat を使用すると、さまざまな方法で日付を表示できます。
<cfoutput>
<ul>
   <li>#DateFormat(todayDate)#
   <li>#DateFormat(todayDate, "mmm-dd-yyyy")#
   <li>#DateFormat(todayDate, "mmmm d, yyyy")#
   <li>#DateFormat(todayDate, "mm/dd/yyyy")#
   <li>#DateFormat(todayDate, "d-mmm-yyyy")#   
   <li>#DateFormat(todayDate, "ddd, mmmm dd, yyyy")#   
   <li>#DateFormat(todayDate, "short")#
   <li>#DateFormat(todayDate, "medium")#
   <li>#DateFormat(todayDate, "long")#
   <li>#DateFormat(todayDate, "full")#
</ul>
</cfoutput>
目 次 > CFML リファレンス > ColdFusion 関数 > DateFormat O