Shopping Cart

Free Newsletter
Signup

Contact

FileMaker is a registered trademark of FileMaker, Inc. in the U.S. and other countries.

FileMaker Pro Custom Functions

List | Show Random | Upload | Add This to Your Site

CalculateEndDate ( startDate ; days ; wkEnds )

Rate this function:

Average rating: 3.1 (18 votes)
Discuss this Custom Function

Steve Allen, Richard Carlton Consulting, Inc.
http://www.rcconsulting.com

Calculate End Date given Start Date and number of days, inclusive; handles weekends. NOT Recursive.

Sample Input:

CalculateEndDate ( '6/4/2010' ; 8 ; 0 )

Sample Output:

6/15/2010

/* * CalculateEndDate ( startDate ; days ; wkEnds ) * * by Steve Allen * 6/9/2010 * * Params: * @Date: startDate * @Number: days * -- the number of days from the start date you want to calculate, INCLUSIVE * @Boolean: wkEnds * -- whether to include weekends (Saturday and Sunday) as part of the days count. TRUE = include them, FALSE = skip them. * -- e.g. if FALSE, "days" is "business days," not "calendar days". * * Return: * @Date */ Let ([ /* These first three variables are for testing. * To use them, copy this function body into the Data Viewer, * uncomment these, and then fiddle with their values as the inputs. wkEnds = 0 ; days = 7 ; startDate = date ( 6; 9 ; 2010 ) ;*/ gridDays = days - ( 7 - DayOfWeek ( startDate ) + 1 ) + 1 ; extras = days - gridDays ; padGrid = ( Div ( gridDays ; 5 ) + ( extras < 5 ) ) * 2 ; calDays = startDate + days - 1 ; output = calDays + (not wkEnds) * padGrid * (extras < days) ]; output )
Then copy & paste into FileMaker Advanced's Edit Custom Function window.

Click here to copy To Clip Manager if you have myFMbutler's Clip Manager installed

Description:

Allows to calculate the end of a date range, given the start of the range, and the number of days in the range.

Has a parameter for weekends. Specifying TRUE is saying "the number of days specified includes weekends", and therefore returns the calendar day range (equivalent to Start + Days - 1).

Specifying FALSE for the weekends parameter is saying "the number of days specified does NOT include weekends -- it's only business days," and so to get the correct end date, it adds the weekends in.

There are several function "out there" that do this, but this is the only one I know of that does it using Math, not recursion. In my experience with the others, this one is much faster, especially on long ranges.

Note: these functions are not guaranteed or supported by BrianDunning.com. Please contact the individual developer with any questions or problems.

This is my Custom Function and I want to edit it

Discuss:

wkEnds fields, what type must to be?
and what includes?
When i put (0) zero then functions count correctly, but when put 1 for a holidays day, then does not work

PANOS, CREECE
June 10, 2010 2:29pm

Richard,

What if you need to subtract multiple months from a date, maintaining the same "day" (ie. 15th of the month)? This seems complex since some months have more days than others.

Thanks!!

jeff@theccsgroup.net

Jeffrey E. Bloch, Fairfield, CT
February 15, 2011 3:38pm

Jeff,

The built-in Date function will allow you to do that.

Just use:

Date (
Month ( mydate ) - number_of_months_to_subtract
; Day ( mydate )
; Year ( mydate )
)

FileMaker will take care of the rest.

Thanks,

Steve Allen

Steve, Fairfield, CA
February 15, 2011 3:41pm

Hi Steven, I've found an issue with this function but not sure how to resolve it. I was trying to use it to calculate the end date after X working days excluding weekends:

Start Date = 25/7/2011 (25 July)
Days: 26
Exclude weekends

The function gives me an end date of 27/8/2011 , which is actually a saturday. The result I would expect is 29th of August which is the monday.

I have checked this manually and the final day after 26 is definitely the 29th. The function is beyond me in terms of figuring out how to fix it sorry.

Daniel Wood, New Zealand
April 21, 2011 6:02pm

I, like Daniel found a problem with this. I came up with the following, which seems to be working nicely:

Note: Unlike Steven's original function, this one always excludes week ends....

Let ([
/* Calculates startDate + days excluding week ends */
day = If(DayOfWeek(startDate)=1;7;DayOfWeek(startDate)-1)
; output = startDate + days + If(day = 6; 2 ; 0) +
(Floor ( ( days -1 + ( If(day=6;1; Mod ( day ; 6 )^1 ) ) ) /5 ) *2 )

];
output
)

Chris Wessels, Sydney, Australia
January 25, 2012 10:05pm

Make a comment about this Custom Function (please try to keep it brief & to the point). Anyone can post:

Download the Custom Function Dashboard Widget for OS X
Keep all the latest Custom Functions right at your fingertips!

Newest Custom Functions:

1.	CountWordOccurrences ( text ; searchWord )
	(Tue, Feb 07, 11:15am)
2.	indonesian_date(date)
	(Mon, Feb 06, 7:14pm)
3.	phpArrayValue ( array ; key ; pos )
	(Fri, Jan 27, 1:49pm)
4.	solfm_timeToMinutes (theTime;roundSec)
	(Fri, Jan 20, 6:26am)
5.	filterLines(filterField;filterValue;Result)
	(Sat, Jan 14, 2:20pm)
6.	getMaxValue ( theList )
	(Thu, Jan 12, 1:06pm)
7.	MiddleWordsIncPunct ( text ; startingWord ; numberOfWords )
	(Sat, Jan 07, 9:16am)
8.	WindowInfo
	(Fri, Jan 06, 12:39pm)


			[ Close Window ]
	The class that teaches you how to successfully sell your FileMaker Pro solution as a professional shrinkwrapped software application.
	Let's Meet in Person Sunday, August 13 2006, Orlando FL Courtyard Orlando International Drive
	Don't miss this most important day of the Developer Conference. Please click here for complete details and online registration.

FileMaker Pro Custom Functions

Description:

Discuss:

Let's Meet in Person