LSDATEFORMAT  
説明

ロケール固有の形式を使用して、日付時刻文字列の日部分の形式を設定します。

 
戻り値

形式設定された日付時刻値。マスクが指定されていない場合、この値はクライアントコンピュータのロケールの設定に従って形式が設定されます。

 
カテゴリ

日付および時刻関数、表示および書式制御関数、各国語対応関数

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

LSParseDateTime、LSTimeFormat、DateFormat、SetLocale、『ColdFusion MX 開発ガイド』の第17章の「グローバル化アプリケーションの開発」 の「ColdFusion MX でのデータ処理」

 
ヒストリ

ColdFusion MX:

  • 形式設定の動作の変更 : この関数では、以前のリリースと異なる形式で結果が返される場合があります。この関数では、すべてのプラットフォームで Java 標準のロケール形式設定ルールが使用されます。
  • 次の mask パラメータオプションのサポートを追加 : short、medium、long、および full。
 
パラメータ

 
使用方法

この関数では、すべてのプラットフォームで Java 標準のロケール形式設定ルールが使用されます。

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

タイムゾーン間の時差を計算するには、GetTimeZoneInfo 関数を使用します。

 
<h3>LSDateFormat の例</h3>
<p>LSDateFormat は、ロケール表記規則を使用して、日付時刻値の日付部分を形式設定します。 
<!--- ロケールのリスト全体をループし、Now() の日付値を表示します。--->
<cfloop list = "#Server.Coldfusion.SupportedLocales#"
index = "locale" delimiters = ",">
   <cfset oldlocale = SetLocale(locale)>

   <cfoutput><p><B><I>#locale#</I></B><br>
      #LSDateFormat(Now(), "mmm-dd-yyyy")#<br>
      #LSDateFormat(Now(), "mmmm d, yyyy")#<br>
      #LSDateFormat(Now(), "mm/dd/yyyy")#<br>
      #LSDateFormat(Now(), "d-mmm-yyyy")#<br>
      #LSDateFormat(Now(), "ddd, mmmm dd, yyyy")#<br>
      #LSDateFormat(Now(), "d/m/yy")#<br>
      #LSDateFormat(Now())#<br>      
      <hr noshade>
   </cfoutput>
</cfloop>
DATE  
日付時刻オブジェクトです。値の範囲は西暦 100 〜 9999 年です。
MASK  
日付の表示方法を指定する文字のセットです。次の形式を組み合わせて指定します。
  • d: 月の日。数字で表した日です。1 桁の場合は先頭に 0 が付きません。
  • dd: 月の日。数字で表した日です。1 桁の場合は先頭に 0 が付きます。
  • ddd: 曜日。短縮形で表します。
  • dddd: 曜日。完全なつづりで表します。
  • m: 月。数字で表した月です。1 桁の場合は先頭に 0 が付きません。
  • mm: 月。数字で表した月です。1 桁の場合は先頭に 0 が付きます。
  • mmm: 月。短縮形で表します (適切な場合)。
  • mmmm: 月。完全なつづりで表します。
  • y: 年。下 2 桁の数字で表した年です。1 桁の場合は先頭に 0 が付きません。
  • yy: 年。下 2 桁の数字で表した年です。1 桁の場合は先頭に 0 が付きます。
  • yyyy: 年。4 桁の数字で表した年です。
  • gg: 年代および年号の文字列。処理されません。この形式は将来の使用のために予約されています。
以下の指定は、Java のロケール固有の時刻エンコード標準に適合した形式です。厳密な形式はロ ケールによって異なります。
  • short: dd、mm、および yy を / 記号で区切ったもの。
  • medium: mmm、d、および yyyy を使用したテキスト形式。
  • long: mmmm、d、および yyyy を使用したテキスト形式。
  • full: dddd、mmmm、d、および yyyy を使用したテキスト形式。
デフォルト値は medium です。
形式の詳細については、LSParseDateTimeを参照してください。