CFLib.org – Common Function Library Project

Description:
Returns estimated download time for a 56k modem given the file size. Returns a string in the format of "xx hours xx minutes xx seconds". File size should be in bytes.

Return Values:
Returns a string.

Example:

<CFSET FileSizeExample = 260991> <!--- 255k --->

<cfoutput>
Estimated Download Time for 56k: #DownLoadTime56k(FileSizeExample)#
</cfoutput>

Parameters:

Full UDF Source:

<cfscript>
/**
 * Returns estimated download time for a 56k modem given the file size.
 * 
 * @param fileSize 	 File size in bytes. (Required)
 * @return Returns a string. 
 * @author William Steiner (&#119;&#105;&#108;&#108;&#105;&#97;&#109;&#115;&#64;&#104;&#107;&#117;&#115;&#97;&#46;&#99;&#111;&#109;) 
 * @version 1, November 1, 2002 
 */
function DownLoadTime56k(fileSize) {
	var totalSeconds = (fileSize * 10) / 57600;
	var tempstring = "";
	var tempstring2 = "";
	var hours = totalSeconds / 3600;
	var minutes = totalSeconds / 60;
	var seconds = totalSeconds MOD 60;
	var hourText = "";
	var minuteText = "";

	// if over 60 minutes...get just minutes left from hours
	if (minutes gte 60) minutes = minutes MOD 60;
	
	if (hours gte 1) {
		if (hours gt 2) hourText = " hours ";
		else hourText = " hour ";
		tempstring = Fix(hours) & hourText;
	}

	if (minutes gte 1) {
		if (minutes gt 2) minuteText = " minutes ";
		else minuteText = " minute ";
		tempstring = tempstring & Fix(minutes) & minuteText;
	}
	
	if (seconds gt 0) tempstring = tempstring & seconds & " seconds";

	return tempstring ;
}
</cfscript>