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

DateConvert

現地時刻から世界標準時 (UTC : Universal Coordinated Time) への変換、または UTC から現地時刻への変換を行います。この関数は必要に応じて、実行コンピュータの夏時間設定を使用して夏時間を計算します。

UTC または現地時刻の形式が設定された時刻オブジェクト

日付および時刻関数

DateConvert("conversion-type", "date")

GetTimeZoneInfo、CreateDateTime、DatePart

パラメータ

説明

conversion-type
  • local2Utc : 現地時刻を UTC 時間に変換します。
  • utc2Local : UTC 時間を現地時刻に変換します。

date

日付と時刻の文字列、または日付と時刻の文字列を含む変数です。

これを作成するには、CreateDateTime を使用します。

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

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

<h3>DateConvert の例</h3>
<!--- ここでは、現在の日付と時刻を UTC 時間に変換し、元に戻す例を示します。 --->
<cfset curDate = Now()>
<p><cfoutput>現在の日付と時刻:#curDate# </cfoutput></p>
<cfset utcDate = DateConvert("local2utc", curDate)>
<cfoutput>
   <p>UTC 時間に変換された現在の日付と時刻:#utcDate#.</p> 
</cfoutput> 
<!--- このコードは、フォームが送信されたかどうかを確認します。送信された場合は、
CreateDateTime 関数により CFML 日付を作成します。 --->  
<cfif IsDefined("FORM.submit")>
   <cfset yourDate = CreateDateTime(FORM.year, FORM.month, FORM.day, FORM.hour,FORM.minute, FORM.second)>
   <p><cfoutput>ColdFusion の日付/時刻として表される日付の値 string:#yourdate#</cfoutput></p>
  <cfset yourUTC = DateConvert("local2utc", yourDate)>
   <p><cfoutput> 世界標準時 (UTC) に変換される日付と時刻の値 : #yourUTC#.</cfoutput></p>
   <p><cfoutput>UTC の日付と時刻を現地の日付と時刻に再変換した値:
#DateConvert("utc2local", yourUTC)#.
</cfoutput></p>
<cfelse>
   日付と時刻を入力し、Enter キーを押して変換を確認してください。
</cfif>   
<Hr size = "2" color = "#0000A0">
<form action = "dateconvert.cfm">
<p>表示する日付値として、年、月、および日を整数形式で入力します。
<table cellspacing = "2" cellpadding = "2" border = "0">
<tr>
  <td>Year</td>
  <td><input type = "Text" name = "year" value = "1998" 
validate = "integer" required = "Yes"></td></tr>
<tr>
  <td>Month</td>
  <td><input type = "Text" name = "month" value = "6" 
range = "1,12" message = "月 (1-12) を入力してください。"
validate = "integer" required = "Yes"></td></tr>
<tr>
  <td>Day</td>
  <td><input type = "Text" name = "day" value = "8" 
range = "1.31"
message = "日 (1-31) を入力してください。"
validate = "integer" required = "Yes"></td></tr>
<tr>
  <td>Hour</td>
  <td><input type = "Text" name = "hour" value = "16" 
range = "0.23"
message = "時 (0-23) を入力してください。"
validate = "integer" required = "Yes"></td></tr>
<tr>
  <td>Minute</td>
  <td><input type = "Text" name = "minute" value = "12" 
range = "0.59"
message = "分 (0-59) を入力してください。"
validate = "integer" required = "Yes"></td></tr>
<tr>
  <td>Second</td>
  <td><input type = "Text" name = "second" value = "0" 
range = "0.59"
message = "秒 (0-59) を入力してください。"
validate = "integer" required = "Yes"></td></tr>
<tr>
  <td><input type = "Submit" name = "submit" value = "送信"></td>
  <td><input type = "RESET"></td></tr>
</table>
目 次 > CFML リファレンス > ColdFusion 関数 > DateConvert O