LSDATEFORMAT | |
Description
Formats the date part of a date/time value in a locale-specific format. |
|
Returns
A formatted date/time value. If no mask is specified, the value is formatted according to the locale setting of the client computer. |
|
Category
Date and time functions, Display and formatting functions, International functions |
|
Function syntaxLSDateFormat(date [, mask ]) |
|
See also
LSParseDateTime, LSTimeFormat, DateFormat, SetLocale; "Handling data in ColdFusion MX" in Chapter 17, "Developing Globalized Applications," in ColdFusion MX Developer's Guide |
|
History
ColdFusion MX:
|
|
Parameters
|
|
Usage
This function uses Java standard locale formatting rules on all platforms. When passing date/time value as a string, enclose it in quotation marks. Otherwise, it is interpreted as a number representation of a date/time object. To calculate a difference between time zones, use the GetTimeZoneInfo function. |
|
Example<h3>LSDateFormat Example</h3> <p>LSDateFormat formats the date part of a date/time value using the locale convention. <!--- loop through a list of locales; show date values for Now()---> <cfloop list = "#Server.Coldfusion.SupportedLocales#" index = "locale" delimiters = ","> <cfset oldlocale = SetLocale(locale)> <cfoutput><p><B><I>#locale#</I></B><br> #LSDateFormat(Now(), "mmm-dd-yyyy")#<br> #LSDateFormat(Now(), "mmmm d, yyyy")#<br> #LSDateFormat(Now(), "mm/dd/yyyy")#<br> #LSDateFormat(Now(), "d-mmm-yyyy")#<br> #LSDateFormat(Now(), "ddd, mmmm dd, yyyy")#<br> #LSDateFormat(Now(), "d/m/yy")#<br> #LSDateFormat(Now())#<br> <hr noshade> </cfoutput> </cfloop> |
DATE | |
MASK | |