iso-time-parser

iso-time-parser

ISO 8601 Time parser (not date, nor duration)

Installation

npm i iso-time-parser

Usage/Example

Full Documentation

Example:

import { parse, toLocalTime, toUTC } from 'iso-time-parser';

// Local time is Central European Summer Time (CEST) in this example
// Pulled from `new Date().getTimezoneOffset()`

parse('T11:22:33,4444Z').then(console.log);
// {
//   hours: 11,
//   minutes: 22,
//   seconds: 33,
//   fracSec: 4444,
//   rawShift: { hours: 0, minutes: 0, sign: 1 },
//   shiftInMinutes: 0
// }

parse('T11:22:33,4444Z').then(toLocalTime).then(console.log);
// {
//   hours: 13,
//   minutes: 22,
//   seconds: 33,
//   fracSec: 4444,
//   rawShift: { hours: 2, minutes: 0, sign: -1 },
//   shiftInMinutes: -120
// }

parse('T11:22:33,4444+03:45').then(toLocalTime).then(console.log);
// {
//   hours: 9,
//   minutes: 37,
//   seconds: 33,
//   fracSec: 4444,
//   rawShift: { hours: 1, minutes: 45, sign: 1 },
//   shiftInMinutes: 105
// }

parse('T11:22:33,4444+03:45').then(toUTC).then(console.log);
// {
//   hours: 7,
//   minutes: 37,
//   seconds: 33,
//   fracSec: 4444,
//   rawShift: { hours: 3, minutes: 45, sign: 1 },
//   shiftInMinutes: 225
// }

Development

Install deps

npm i

Build/bundle package

npm run build

Build docs

npx typedoc src/index.ts

Bump version

npm version {major, minor, patch}

Publish

npm publish --access public