Ask Ben: Getting the Previous Day In ColdFusion, Excluding Saturday And Sunday

Posted July 22, 2007 at 1:32 PM

Tags: ColdFusion, Ask Ben

The question is too long to list here, but basically someone contacted me looking for help with a file review system. The part that was causing issue was the fact that he needed to review the files from the previous day. In order figure out the previous day Tuesday-Friday, it was fine. When it comes to weekend, changing of the month, or changing of the year, he was doing a whole lot of crazy date alterations.

No problem - we've all been there. Until you realize how much Date/Time functionality ColdFusion has built-in, you usually do take it upon yourself to figure out all the logic required to handle things like weekends and year cross-overs. Thankfully, ColdFusion plays very nicely with date math, and when date math is not enough, ColdFusion's DateAdd() function can really pick up the slack. In addition to that, ColdFusion also has Year(), Month(), and Day() functions for parsing out parts of the date/time stamp.

Long story-short, getting the previous day (excluding weekends) is as easy as calling ColdFusion's DateAdd() function with the "w" date part. The "w" date part stands for Weekday. For a long time, I didn't understand the difference between Day and Weekday in the context of DateAdd(). They do basically the same thing, most of the time. The difference, which can be subtle depending on what date you are looking at, is that adding or subtracting Weekdays to and from a date will hop over the weekends. Therefore, if you add a weekday to Friday, it will return the next Monday. Similarly, if you subtract a Weekday from a Monday, it will return the previous Friday.

This being said, getting the previous weekday is quite a simple task. To demonstrate, we will get the previous 10 weekdays (excluding Saturday and Sunday):

 Launch code in new window » Download code as text file »

  • <!---
  • Get the current DATE. Fix()'ing the date will chop
  • off the time portion of the date/time stamp.
  • Caution: This will result in a NUMERIC date, not
  • a standard date.
  • --->
  • <cfset dtNow = Fix( Now() ) />
  •  
  • <!---
  • Now, let's loop over the past 10 WEEKDAYS. This is
  • different from days. Weekday math does not include
  • weekends in its calculations.
  • --->
  • <cfloop
  • index="intOffset"
  • from="0"
  • to="10"
  • step="1">
  •  
  • <!--- Get the WEEKDAY that we want to show. --->
  • <cfset dtDay = DateAdd( "w", -intOffset, dtNow ) />
  •  
  • <!---
  • Output the full date so we can see BOTH the day
  • of the week and the day-date.
  • --->
  • #DateFormat( dtDay, "full" )#<br />
  •  
  • </cfloop>

Running the above code, we get the following output:

Monday, July 23, 2007
Friday, July 20, 2007
Thursday, July 19, 2007
Wednesday, July 18, 2007
Tuesday, July 17, 2007
Monday, July 16, 2007
Friday, July 13, 2007
Thursday, July 12, 2007
Wednesday, July 11, 2007
Tuesday, July 10, 2007
Monday, July 9, 2007

Notice that neither Saturday nor Sunday are showing up in this list. ColdFusion makes life easy.

Download Code Snippet ZIP File

Post Comment  |  Ask Ben  |  Permalink  |  Other Searches  |  Print Page





Reader Comments

Adam Cameron
Jul 23, 2007 at 8:34 AM // reply »
64 Comments

Hi Ben.
I originally saw this question here: http://www.adobe.com/cfusion/webforums/forum/messageview.cfm?forumid=1&catid=3&threadid=1285943&enterthread=y

Note my - purposely abrupt - response to it. Thankfully the OP realised it was for emphasis rather than anything else.

So this is my moment for "I've learned something today". I had no idea that dateAdd() had a "weekday" option.

It would be great if you could post something on the Adobe forums pointing to your post here (or just replicate the answer), lest anyone accidentally stumble across the issue and decide either Frank's or my suggested solution is the best way forward.

Cheers.

--
Adam


Jul 23, 2007 at 8:41 AM // reply »
6,371 Comments

@Adam,

I have posted a link on the Adobe Forums. It's funny, I never use the Adobe forums, and this is like the second or third time that I have been asked the same exact question as one on the forums. At least, this time it was the same person who contacted me (Frank) as the person who posted on the forums.

For the longest time I knew that WeekDay was there as an option, but I could not for the life of me figure out what HECK was the difference between a Day and Weekday???? I mean what other kind of day is there? A MonthDay??? It wasn't until I was working with an event calendar that I realized what the Weekday actually did.


Adam Cameron
Jul 23, 2007 at 10:20 AM // reply »
64 Comments

If you wanted to start helping out on the Adobe forums - even occasionally - that would be cool: we need all the help we can get!

--
Adam


Jul 23, 2007 at 4:02 PM // reply »
11 Comments

Hi Ben,

Not as simple as your solution. However, I use the similar function in SQL. I dig it up after I read your blog.

http://blog.sqlauthority.com/2007/07/23/sql-server-udf-function-to-get-previous-and-next-work-day-exclude-saturday-and-sunday/

Good post Ben!

Pinal Dave


Jul 23, 2007 at 4:59 PM // reply »
6,371 Comments

Nice SQL UDF. I don't use enough SQL UDFs. They are really handy and can make the queries seem so much nicer.


Chris
Mar 13, 2008 at 7:09 PM // reply »
1 Comments

With Coldfusion 8 is the weekday option "w" now stand for weeks?


Mar 17, 2008 at 7:34 AM // reply »
6,371 Comments

@Chris,

According to the documentation, "w" still stands for weekday.


Susan
Jun 24, 2008 at 3:47 PM // reply »
1 Comments

I was using your example to deal with a scheduling app I'm writing, and notice that your output returns 11 dates - the date you started with plus the next 10.

Changing the "from" in the loop to "1" skips the date you start with and provides the next 10. Is there something I can change in the looping to give me 10 including the start date - i.e. the date I start with plus 9?

Thanks!


Jun 25, 2008 at 7:38 AM // reply »
6,371 Comments

@Susan,

Just go from 0 to 9, rather than 0 to 10.


AirJar
Aug 21, 2008 at 8:32 AM // reply »
1 Comments

This was almost exactly what I needed, thank you for posting this simple solution!

I needed to provide a select box for the next 7 days (including weekend days) so users can select what future day they desire. I modified the code in order to parse the day (string) to appear on the page and the date as the value (to insert in the db).

Here's my code if anyone is interested:

<cfoutput>
<cfset dtNow = Fix( Now() ) />

<cfloop
index="intOffset"
from="0"
to="6"
step="1">

<cfset dtDay = DateAdd( "d", intOffset, dtNow ) />

#dateformat(dtDay,"m/dd/yyyy")# #DayofWeekAsString(DayOfWeek(dtDay))#<br />

</cfloop>
</cfoutput>


Post Comment  |  Ask Ben

Recent Blog Comments
Jill
Nov 7, 2009 at 11:40 AM
How To Unformat Your Code (Like A Pro)
Derek, I think you might be right - sweet! Thanks for the link :) ... read »
Nov 7, 2009 at 11:25 AM
How To Unformat Your Code (Like A Pro)
I think it would be way easier to just use this http://www.logichammer.com/html-formatter/ He just released v3 and it rocks. ... read »
Jill
Nov 7, 2009 at 7:58 AM
How To Unformat Your Code (Like A Pro)
LMAO - this was pretty funny! I have to admit - I also love to reformat code so I can read it. My boss used to tell me to leave my OCD at home. Now I don't feel so bad after reading everyone else' ... read »
Nov 6, 2009 at 10:10 PM
How To Unformat Your Code (Like A Pro)
The timing of this post is just uncanny. I spent the last 15-20 minutes manually un-formatting my "Ben Nadel" style code within a CFC of mine. I was really digging the readability a few weeks ago, bu ... read »
Roe
Nov 6, 2009 at 5:11 PM
Passing Arrays By Reference In ColdFusion - SWEEET!
ArraySort also reorders the results of these java obj's ... read »
Nov 6, 2009 at 4:53 PM
How To Unformat Your Code (Like A Pro)
I tried to go *back* the other way. Adding formatting is actually a much more complicated problem than removing formatting. Anyway, here is what I could put together with a minimal amount of time: ... read »
Asaf
Nov 6, 2009 at 2:35 PM
ColdFusion GetPageContext() Massive Exploration
Hi, I actually found this post useful. I recently acquired a SSL certificate for my website and when I switched over to HTTPS Internet Explorer would throw an error when trying to download a dynamic ... read »
Nov 6, 2009 at 2:19 PM
How To Unformat Your Code (Like A Pro)
@Chuck, @Nathan, Well, now I feel like it's a challenge.... I accept. ... read »