| 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 | |