Calculates the time fraction from the parameters \b hours, \b minutes and \b seconds. Excel: TIME

Contents

Interface Function Documentation Page Comments

Interface

#include <codecogs/units/time/time.h>

using namespace Units::Time;

	double	time (int Hours, int Minutes, int Seconds)[inline] Calculates the time fraction from the parameters hours, minutes and seconds. Excel: TIME
	Real	cc_time (Integer Hours, Integer Minutes, Integer Seconds) This function is available as a Microsoft Excel add-in.

Function Documentation

Calculates the fraction of a day represented by the specified time (Hours, Minutes and Seconds), using the formula:

Therefore time=0 is midnight, time=0.5 is midday, and time=1 is the start of the next day.

Example:

double breakfast =time(6,15,0);    // ~0.2604
  double midday    =time(12,0,0);    // 0.5
  double lunchtime =time(13,30,0);   // ~0.5625
  double bedtime   =time(22,40,0);   // ~0.9444

Parameters:

Hours	is usually any integer number between 0 (12am) and 23 (11pm), though values outside of this range will esculate into forming a positive (or negative) number of elapsed days.
Minutes	is usually any integer between 0 and 59, where once again values outside of this range will esculate into forming additional hours.
Seconds	is usually any integer between 0 and 59, with values outside of this range esculating upto to form whole minutes.

Authors:

Will Bateman (Sep 2004)