User Guide
320 CFML Language Reference
DateConvert
Converts local time to Universal Coordinated Time (UTC ) or UTC to local time based
on the specified parameters. This function uses the daylight savings settings in the
executing machine to compute daylight savings time, if required.
See also GetTimeZoneInfo, CreateDateTime, and DatePart.
Syntax DateConvert(
conversion-type
,
date
)
conversion-type
There are two conversion types: “local2Utc” and “utc2Local.” The former converts
local time to UTC time. The later converts UTC time to local time.
date
Any ColdFusion date and time string. In order to create a ColdFusion date and
time, use CreateDateTime.
Usage When passing a date/time value as a string, make sure it is enclosed in quotes.
Otherwise, it is interpreted as a number representation of a date/time object, returning
undesired results.
Examples <!--- This example shows the use of DateConvert --->
<HTML>
<HEAD>
<TITLE>DateConvert Example</TITLE>
</HEAD>
<basefont face="Arial, Helvetica" size=2>
<body bgcolor="#FFFFD5">
<H3>DateConvert Example</H3>
<!--- This part of the example shows the conversion of the current date
and time to UTC time and back again. --->
<CFSET curDate = Now()>
<P><CFOUTPUT>The current date and time: #curDate#. </CFOUTPUT></P>
<CFSET utcDate = DateConvert("local2utc", curDate)>
<CFOUTPUT>
<P>The current date and time converted to UTC time: #utcDate#.</P>
</CFOUTPUT>
<!--- This code checks to see if the form was submitted.
If it was submitted the code generates the CFML date with the
CreateDateTime function. --->
<CFIF IsDefined("FORM.submit")>