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




Learning ColdFusion 9 - ColdFusion 9 tutorials, samples, examples, demos

Reader Comments

Adam Cameron
Jul 23, 2007 at 8:34 AM // reply »
54 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 »
5,406 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 »
54 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 »
10 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 »
5,406 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 »
5,406 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 »
5,406 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
Jason Fisher
Jul 4, 2009 at 4:35 PM
Adobe Announces That HomeSite Is Officially Dead
I'm with Mark and Tim: still the best IDE for CF, especially for those of us with years of customization which can so easily be moved from machine to machine. I just have trouble making the Eclipse ... read »
Secret Admirer
Jul 4, 2009 at 12:23 PM
Project HUGE: Huge In A Hurry - Get Big - Phase 2 / Week 3
My Poor Dreamboat :( I feel so sad when I know you are hurting. I hope you feel better soon. ... read »
Jul 4, 2009 at 9:42 AM
FLV 404 Error On Windows 2003 Server
I bookmarked this page. Thanks for given this great post.... ... read »
Jul 4, 2009 at 4:00 AM
Terms Of Service / Privacy Policy Document Generator
thanks ben, I'm not a big fan of contracts so to find your no no-nesense ToS generator has helped me no end. all the best matt ... read »
Justice
Jul 3, 2009 at 11:10 PM
Create A Running Average Without Storing Individual Values
@Ben, I think you're going about this the wrong way. You're trying to use complicated techniques when there is a simple and beautiful technique readily available (a la Gary Funk's comment). Instead ... read »
Bob
Jul 3, 2009 at 9:19 PM
Project HUGE: Huge In A Hurry - Get Big - Phase 3 / Week 1
a good technical explanation http://crossfitphoenix.typepad.com/crossfit_phoenix_forging_/the-overhead-squat.html ... read »
Jul 3, 2009 at 9:03 PM
Create A Running Average Without Storing Individual Values
If I wanted to do this and only carry two numbers, I'd keep track of the sum and N. Then you are pretty much accurate all the time. average = (sum + new_number) / (N + 1) But all this was in a for ... read »
Roland Collins
Jul 3, 2009 at 8:58 PM
Create A Running Average Without Storing Individual Values
@Martin - not just floating point though. Depending on what langauge you're working in, decimals can cause just as many headaches if they're not precise enough. But again, for most applications, th ... read »