Adobe ColdFusion 8

DayOfWeek

Description

Determines the day of the week, in a date.

Returns

The ordinal for the day of the week, as an integer in the range 1 (Sunday) to 7 (Saturday).

Category

Date and time functions

Function syntax

DayOfWeek("date")

See also

Day, DayOfWeekAsString, DayOfYear, DaysInMonth, DaysInYear, FirstDayOfMonth

Parameters

Parameter

Description

date

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

Usage

When passing a date/time object as a string, you must enclose it in quotation marks. Otherwise, it is interpreted as a numeric representation of a date/time object.

Note: You can pass the CreateDate function or Now function as the date parameter of this function; for example, #DayOfWeek(CreateDate(2001, 3, 3))#

Example

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