CFLib.org – Common Function Library Project

Description:
As an alternative to traditional rounding, this UDF allows you to set the round interval for a number. So with an interval set to 25, the number would round to 0, 25, 50,...

Return Values:
Returns a number.

Example:

<cfoutput>
IntervalRound(83,25): #IntervalRound(83,25)#
IntervalRound(149,75,0): #IntervalRound(149,75,0)#
IntervalRound(149,75,1): #IntervalRound(149,75,1)#
</cfoutput>

Parameters:

Full UDF Source:

/**
 * Rounds any real number to a user specified interval.
 * 
 * @param nNumber      The number to round. (Required)
 * @param nInterval      The number to round to. (Required)
 * @param bOption      Used to calculate percentage for rounding. (Optional)
 * @return Returns a number. 
 * @author Rob Rusher (rob@robrusher.com) 
 * @version 1, July 20, 2005 
 */
function intervalRound(nNumber, nInterval){
    var nMultipler = fix(nNumber / nInterval); // How many times does the interval go into intNumber
    var bOption = 0;

    if(arrayLen(arguments) GTE 3 AND arguments[3])
        if(((nNumber mod nInterval) / nInterval) gte .5) bOption = 1; // Calculate percentage for rounding option.

    return (nInterval * nMultipler) + (bOption * nInterval);
}