User Guide

556 Chapter 3: ColdFusion Functions

DateFormat

Description

Formats a date value using U.S. date formats. For international date support, use LSDateFormat.

Returns

A text string representing the date formatted according to the mask. If no mask is specified,

returns the value in dd-mmm-yy format.

See also

Now

, CreateDate, LSDateFormat, LSParseDateTime, LSTimeFormat, TimeFormat,

ParseDateTime

History

ColdFusion MX: Added support for the following mask parameter options: short, medium, long,

and

full.

Parameters

Parameter Description

date Date/time object, in the range 100 AD–9999 AD.

mask Characters that show how ColdFusion displays a date:

• d: Day of the month as digits; no leading zero for single-digit days.

• dd: Day of the month as digits; 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; no leading zero for single-digit months.

• mm: Month as digits; leading zero for single-digit months.

• mmm: Month as a three-letter abbreviation.

• mmmm: Month as its full name.

• yy: Year as last two digits; leading zero for years less than 10.

• yyyy: Year represented by four digits.

• gg: Period/era string. Ignored. Reserved.

The following masks tell how to format the full date and cannot be combined with

other masks:

• short: equivalent to m/d/y

• medium: equivalent to mmm d, yyyy

• long: equivalent to mmmm d, yyyy

• full: equivalent to dddd, mmmm d, yyyy