CFLib.org – Common Function Library Project

Description:
Formats a number of minutes into "XX hours XX minutes".

Return Values:
Returns a string.

Example:

<cfset cookTime = "75">

<cfoutput>
Total cooking time: #HoursMinutes(cookTime)#
</cfoutput>

Parameters:

Full UDF Source:

/**
 * Formats a number of minutes into "XX hours XX minutes".
 * v2 Charlie Arehart found a bug if hours exactly 2, it said hour, not hours
 * 
 * @param minutes      Number of minutes to convert to hours/minutes. (Required)
 * @return Returns a string. 
 * @author Andrew Muller (rebel@daemon.com.au) 
 * @version 2, July 2, 2008 
 */
function hoursMinutes(minutes) {
    var tempstr = "";
    var strHours = minutes / 60;
    var strMinutes = minutes MOD 60;
    var hourText = "";
    if (strHours gte 1) {
        if (strHours gte 2) {
            hourText = " hours ";
        } else {
            hourText = " hour ";
        }
        tempstr = Fix(strHours) & hourText;
    }
    
    if (strMinutes gt 0) {
        tempstr = tempstr & strMinutes & " minutes";
    }
    return tempstr;
}