parse-interval v0.1.5

Parse Interval

Parse time intervals of the form DD.HH:MM:SS.FFFFFFFFF

The days and fractional second fields are optional. Fractional seconds can range from 1 to 9 digit accuracy.

Installation

$ npm install parse-interval

Usage

pi = require 'parse-interval'

ti = pi.parse "1.02:03:04.123456789"
console.log "Days:         #{ti.days}"
console.log "Hours:        #{ti.hours}"
console.log "Minutes:      #{ti.minutes}"
console.log "Seconds:      #{ti.seconds}"
console.log "Milliseconds: #{ti.milliseconds}"
console.log "Nanoseconds:  #{ti.nanoseconds}"

# use totalMilliseconds() to help set intervals
setInterval ->
  console.log "hello world"
, ti.totalMilliseconds()

Other totals available:

ti.totalHours()
ti.totalMinutes()
ti.totalSeconds()
ti.totalNanoseconds()

Parse-interval also has .toString() functionality. toString() is intelligent and will yield the correct string for overflowing time places.

ti = pi.create() # create a blank time interval object
ti.days = 1
ti.hours = 2
ti.minutes = 3
ti.seconds = 4
ti.milliseconds = 123
ti.toString()

#> "1.02:03:04.123"

ti = pi.create()
ti.seconds = 93784
ti.toString()

#> "1.02:03:04.123"

Uptime

parse-interval conveniently provides the system uptime as a time interval:

pi = require 'parse-interval'
up = pi.uptime()
up.toString()
#> '2.06:17:46'

Testing

$ npm test

License

MIT