DATECONVERT

説明

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

戻り値

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

カテゴリ

日付および時刻関数

関数のシンタックス

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

関連項目

GetTimeZoneInfo、CreateDateTime、DatePart

パラメータ

使用方法

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

メモ:

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>

DATE

日付と時刻の文字列、または日付と時刻の文字列を含む変数です。
これを作成するには、CreateDateTime を使用します。

CONVERSION-TYPE