A custom-formatted time value. If no mask is specified, returns a time value using the hh:mm tt
format. For international time formatting, see LSTimeFormat.
Date and time functions, Display and formatting functions
TimeFormat(time [, mask ])
CreateTime,
Now,
ParseDateTime
New in ColdFusion MX: This function processes extra characters within the mask
value differently than in earlier releases, as follows:
TimeFormat(now(), "hh:mm:ss dog")
returns 8:17:23 d'o'g
.
8:17:23 dog
.
If the extra characters are single-quoted (for example, hh:mm:ss 'dog')
, ColdFusion 5 and ColdFusion MX return the time format and the extra characters: 8:17:23 dog
.
New in ColdFusion MX: This function supports the short
, medium
, long
, and full
mask
attribute options.
When passing a date/time value as a string, you must enclose it in quotation marks. Otherwise, it is interpreted as a number representation of a date/time object.
Database query results for date and time values can vary in sequence and formatting unless you use functions to format the results. To ensure that dates and times display with appropriate formatting, and that users of your ColdFusion application are not confused by dates and times displayed, Macromedia recommends that you use the DateFormat
and TimeFormat
functions to format date and time values from queries. For more information and examples, see TechNote 22183, "ColdFusion Server (5 and 4.5.x) with Oracle: Formatting Date and Time Query Results," at http://www.coldfusion.com/Support/KnowledgeBase/SearchForm.cfm.
<cfset todayDate = #Now()#> <body> <h3>TimeFormat Example</h3> <p>Today's date is <cfoutput>#todayDate#</cfoutput>. <p>Using Timeformat, we can display the value in different ways: <cfoutput> <ul> <li>#TimeFormat(todayDate)# <li>#TimeFormat(todayDate, "hh:mm:ss")# <li>#TimeFormat(todayDate, "hh:mm:sst")# <li>#TimeFormat(todayDate, "hh:mm:sstt")# <li>#TimeFormat(todayDate, "HH:mm:ss")# </ul> </cfoutput> </body>