Neatly Positioned Magazines

    timelite
    TypeScript icon, indicating that this package has built-in type declarations

    1.0.0 • Public • Published

    Timelite Build Status npm npm JavaScript Style Guide

    String date and time utilities.

    API

    Time

    • add : Add an array of string times. Eg. add(['04:20:10', '21:15:10'])
    • str : Format an array of time values into string time. Eg. str([12, 0, 45]) => [ 12, 00, 45 ]
    • sub : Subtract an array of string times. Eg. sub(['20:05:10', '10:10:50']) => [ 9, 54, 20 ]

    Date

    • normalize : Normalize string date values returning a valid date as an unsigned integer array.
    • str : Format an array date values into a valid string date.

    Install

    Yarn

    yarn add timelite --dev

    NPM

    npm install timelite --save-dev

    UMD file is also available on unpkg:

    <script src="https://unpkg.com/timelite/timelite.umd.min.js"></script>

    You can use the library via window.timelite.

    Usage

    Time

    add

    Add an array of string time values "HH:mm:ss".

    import { add } from 'timelite/time'
     
    add(['04:20:10', '21:15:10'])
    // [ 25, 35, 2 ]
    add(['04:35:10', '21:35:10'])
    // [ 26, 10, 2 ]
    add(['30:59', '17:10'])
    // [ 48, 09, 0 ]
    add(['19:30:00', '00:30:00'])
    // [ 20, 00, 0 ]

    sub

    Subtract an array of string time values "HH:mm:ss".

    import { sub } from 'timelite/time'
     
    sub(['20:40:10', '20:10:50'])
    // [ 0, 29, 20 ]
    sub(['20:05:10', '10:10:50'])
    // [ 9, 54, 20 ]

    str

    Format an array time values into string time.

    import { str } from 'timelite/time'
     
    str([12, 10, 45])
    // "12:10:45"
    str([5, 1, 0])
    // "05:01:00"
    str([7, 22])
    // "07:22:00"

    Date

    normalize

    Normalize string date values returning a valid date as an unsigned integer array.

    import { normalize } from 'timelite/date'
     
    normalize('1980-09-02')
    // [ 1980, 9, 2 ]
    normalize('17')
    // [ 2017, 1, 1 ]
    normalize('18-04')
    // [ 2018, 4, 1 ]
    normalize('0-02-31')
    // [ 2000, 2, 28 ]

    str

    Format an array date values into a valid string date.

    import { str } from 'timelite/date'
     
    str([ 0, 0, 0 ])
    // 2000-01-01
    str([ 17, 14, 5 ])
    // 2017-12-05
    str([ 1988, 2 ])
    // 1988-02-01

    Contributions

    Feel free to send some Pull request or issue.

    License

    MIT license

    © 2018 José Luis Quintana

    Install

    npm i timelite

    DownloadsWeekly Downloads

    180

    Version

    1.0.0

    License

    MIT

    Unpacked Size

    18.9 kB

    Total Files

    14

    Last publish

    Collaborators

    • joseluisq