Table of Contents
Advertisement
Chapter 2: ColdFusion Functions
TimeFormat
Returns a custom-formatted time value. If no mask is specified, the TimeFormat
function returns time value using the hh:mm tt format.
See also CreateTime,
Syntax
TimeFormat( time [, mask ])
time
Any date/time value or string convertible to a time value.
mask
A set of masking characters determining the format:
h
hh
H
HH
m
mm
s
ss
t
tt
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 various types of output
possible with TimeFormat --->
<HTML>
<HEAD>
<TITLE>
TimeFormat Example
</TITLE>
</HEAD>
<CFSET todayDate = #Now()#>
<BODY>
<H3>TimeFormat Example</H3>
<P>Today's date is <CFOUTPUT>#todayDate#</CFOUTPUT>.
Now,
and ParseDateTime.
— Hours with no leading zero for single-digit hours. (Uses a 12-hour clock.)
— Hours with a leading zero for single-digit hours. (Uses a 12-hour clock.)
— Hours with no leading zero for single-digit hours. (Uses a 24-hour clock.)
— Hours with a leading zero for single-digit hours. (Uses a 24-hour clock.)
— Minutes with no leading zero for single-digit minutes
— Minutes with a leading zero for single-digit minutes
— Seconds with no leading zero for single-digit seconds
— Seconds with a leading zero for single-digit seconds
— Single-character time marker string, such as A or P
— Multiple-character time marker string, such as AM or PM
541
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