Table of Contents
Advertisement
320
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
<H3>DateConvert Example</H3>
<!--- This part of the example shows the conversion of the current date
<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")>
bgcolor="#FFFFD5">
and time to UTC time and back again. --->
CFML Language Reference
Advertisement
Table of Contents
Need help?
Do you have a question about the COLDFUSION 4.5-CFML LANGUAGE and is the answer not in the manual?
Questions and answers