Macromedia coldfusion 4.5-cfml language reference User Manual

Page of 608
Chapter 2:  ColdFusion Functions
441
LSDateFormat
Formats the date portion of a date/time value using the locale convention. Like 
DateFormat LSDateFormat returns a formatted date/time value. If no mask is 
specified, LSDateFormat returns a date value using the locale-specific format.
Syntax
LSDateFormat(
date [, mask ])
date
Date/time object in the period from 100 AD to 9999 AD.
mask
Set of characters that are used to show how ColdFusion should display the date:
d
 — Day of the month as digits with no leading zero for single-digit days. 
dd
 — Day of the month as digits with a leading zero for single-digit days. 
ddd
 — Day of the week as a three-letter abbreviation. 
dddd
 — Day of the week as its full name. 
m
 — Month as digits with no leading zero for single-digit months. 
mm
 — Month as digits with a leading zero for single-digit months. 
mmm
 — Month as a three-letter abbreviation. 
mmmm
 — Month as its full name. 
y
 — Year as last two digits with no leading zero for years less than 10. 
yy
 — Year as last two digits with a leading zero for years less than 10. 
yyyy
 — Year represented by four digits. 
gg
 — Period/era string. Currently ignored, but reserved for future use 
Usage
When passing 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 shows LSDateFormat --->
<HTML>
<HEAD>
<TITLE>LSDateFormat Example</TITLE>
</HEAD>
<BODY>
<H3>LSDateFormat Example</H3>
<P>LSDateFormat formats the date portion of a date/time
value using the locale convention.