Adobe ColdFusion 8

DayOfWeekAsString

Description

Determines the day of the week, in a date, as a string function.

Returns

The day of the week, as a string in the current locale, that corresponds to day_of_week.

Category

Date and time functions, String functions

Function syntax

DayOfWeekAsString(day_of_week [, locale])

See also

Day, DayOfWeek, DayOfYear, DaysInMonth, DaysInYear, FirstDayOfMonth

History

ColdFusion 8: Added the locale parameter.

ColdFusion MX 7: Changed behavior. The returned string is now in the language of the current locale.

Parameters

Parameter

Description

day_of_week

Integer, in the range 1 (Sunday) - 7 (Saturday).

locale

Locale to use instead of the locale of the page when processing the function

Example

The following example shows the use of the DayOfWeekAsString function. It is the action page for a form that submits year, month, and day fields.

<h3>DayOfWeekAsString Example</h3>
<cfif IsDefined("FORM.year")>
More information about your date:
<cfset yourDate = CreateDate(FORM.year, FORM.month, FORM.day)>

<cfoutput>
<p>Your date, #DateFormat(yourDate)#.
<br>It is #DayofWeekAsString(DayOfWeek(yourDate))#, day
     #DayOfWeek(yourDate)# in the week.
<br>This is day #Day(YourDate)# in the month of 
    #MonthAsString(Month(yourDate))#, which has
      #DaysInMonth(yourDate)# days.
<br>We are in week #Week(yourDate)# of #Year(YourDate)# (day #DayofYear(yourDate)#
    of #DaysinYear(yourDate)#). 
<br><cfif IsLeapYear(Year(yourDate))>This is a leap year
    <cfelse>This is not a leap year</cfif>
</cfoutput>
</cfif>