Installation in node.js
Installing npm (node package manager)
$ curl | sh
[sudo] npm install timespan
You have two options when creating a new TimeSpan object: either explicitly instantiate it using the TimeSpan constructor function or use a helper method to create from a specific length of time.
Using the new constructor
var timespan = ;var ts = ;
The constructor takes 5 parameters, all which are optional and which can be used to initialize the TimeSpan to a given value. These parameters are:
//// Initializes the TimeSpan to 4 Minutes, 16 Seconds and 0 Milliseconds.//var ts = 0164//// Initializes the TimeSpan to 3 hours, 4 minutes, 10 seconds and 0 msecs.//var ts = 010642;
Using Construction Helper Method(s)
You can initialize a new TimeSpan by calling one of these Functions:
timespan;timespan;timespan;timespan;//// This behaves differently, see below//timespan;
The first four helper methods take a single numeric parameter and create a new TimeSpan instance. e.g.
timespan.fromSeconds(45) is equivalent to
new TimeSpan(0,45). If the parameter is invalid/not a number, it will just be treated as 0 no error will be thrown.
timespan.fromDates() is different as it takes two dates. The TimeSpan will be the difference between these dates.
If the second date is earlier than the first date, the TimeSpan will have a negative value. You can pass in "true" as the third parameter to force the TimeSpan to be positive always.
var date1 = 2010 3 1 10 10 5 0;var date2 = 2010 3 1 10 10 10 0;var ts = TimeSpan;var ts2 = TimeSpan;//// -5, because we put the later date first//console;//// 5, because we passed true as third parameter//console;
Adding / Subtracting TimeSpans
There are several functions to add or subtract time:
All these functions take a single numeric parameter. If the parameter is invalid, not a number, or missing it will be ignored and no Error is thrown.
var ts = ;ts;ts;ts;//// ts will now be a timespan of 1 minute and 30 seconds//
The parameter can be negative to negate the operation
ts.addSeconds(-30) is equivalent to
Interacting with Other TimeSpan instances
These are the functions that interact with another TimeSpan:
add and subtract add/subtract the other TimeSpan to the current one:
var ts = TimeSpan;var ts2 = TimeSpan;ts;//// ts is now a TimeSpan of 2 Minutes, 30 Seconds// ts2 is unchanged//
equals checks if two TimeSpans have the same time:
var ts = TimeSpan;var ts2 = TimeSpan;var eq = ts; // truets2;var eq2 = ts; // false
Retrieving the Value of a TimeSpan
There are two sets of functions to retreive the function of the TimeSpan: those that deal with the full value in various measurements and another that gets the individual components.
Retrieve the full value
These functions convert the value to the given format and return it. The result can be a floating point number. These functions take a single parameter roundDown which can be set to true to round the value down to an Integer.
var ts = TimeSpan;console; // 90000console; // 90console; // 1.5console; // 1
Retrieve a component of the TimeSpan
These functions return a component of the TimeSpan that could be used to represent a clock.
var ts = TimeSpan;console; // 30console; // 1
Basically these value never "overflow" - seconds will only return 0 to 59, hours only 0 to 23 etc. Days could grow infinitely. All of these functions automatically round down the result:
var ts = TimeSpan;ts;console; // 2console; // 12
Remark about Backwards Compatibility
Version 0.2.x was designed to work with node.js and backwards compatibility to the browser-based usage was not considered a high priority. This will be fixed in future versions, but for now if you need to use this in the browser, you can find the 0.1.x code under