Kairos

Kairós(καιρός) is a greek word that means "the right moment". Also, in the greek mithology Kairós is the son of the personification of time itself, Chronos.

Now talking about the library, Kairos is being developed to be a non date-based time calculator. The aim is to use time expressions along with math expressions to have human time products, and also to have various representations of a time expression using the engine Gnomon(references the first solar clock ever made).

API Docs

Install

Node.js

npm install kairos

Bower

bower install kairos

Examples

Using Kairos

var time = Kairos.plus('10:10', '05:20');
console.log(time); // 15:30

time = Kairos.minus('10:00', '05:00');
console.log(time); // 05:00

time = Kairos.multiply('01:00', 20);
console.log(time); // 20:00

time = Kairos.divide('03:00', 2);
console.log(time); // 01:30

var milliseconds = Kairos.toMilliseconds('00:01');
console.log(milliseconds); // 60000

var seconds = Kairos.toSeconds('00:01');
console.log(seconds); // 60

var minutes = Kairos.toMinutes(time);
console.log(minutes); // 90

var hours = Kairos.toHours('10:30');
console.log(hours); // 10.5

var fraction = Kairos.getFraction('01:00', 2, 3);
console.log(fraction); // 00:40

var interval = Kairos.getInterval('01:00', '03:00');
console.log(interval); // 02:00

var compare = Kairos.compareTo('01:00', '03:00');
console.log(compare); // -1
compare = Kairos.compare('03:00', '03:00');
console.log(compare); // 0
compare = Kairos.compare('03:00', '01:00');
console.log(compare); // 1

var min = Kairos.min('01:00', '05:00', '00:30');
console.log(min); // 00:30

var max = Kairos.max('01:00', '05:00', '00:30');
console.log(max); // 05:00

Using Gnomon

var time = new Kairos.Gnomon('01:10:20');
console.log(time.getMilliseconds()); // 0
console.log(time.getSeconds()); // 20
console.log(time.getMinutes()); // 10
console.log(time.getHours()); // 1
console.log(time.toMilliseconds()); // 4220000
console.log(time.toSeconds()); // 4220
console.log(time.toMinutes()); // 70.333333333333
console.log(time.toHours()); // 1.172222222222

time = time.plus(new Kairos.Gnomon('01:00'));
console.log(time.getHours()); // 2
console.log(time.getExpression()); // 02:10:20

var compare = time.comparteTo(new Kairos.Gnomon('03:00'));
console.log(compare); // -1
compare = time.comparteTo(new Kairos.Gnomon('02:10:20'));
console.log(compare); // 0
compare = time.comparteTo(new Kairos.Gnomon('01:00'));
console.log(compare); // 1

Help and ideas are FREAKING welcome. Feel free to open issues, fork and contribute! ;)