@qc/date-round

    0.0.0 • Public • Published

    @qc/date-round

    Rounds a date to the nearest interval from 1 milliseconds up to 24 hours.

    Installation

    npm install @qc/date-round
     
    # or 
    yarn add @qc/date-round

    Usage

    import { round } from '@qc/date-round'
     
    let dateIn = new Date(Date.UTC(2000, 0, 1, 2, 34, 56))
    let interval = 60 * 60 * 1000
    let dateOut = round(dateIn, interval)
    dateIn === dateOut; // false

    Examples

    Nearest Hour

    import { round } from '@qc/date-round'
     
    let date = new Date(Date.UTC(2000, 0, 1, 2, 34, 56))
    console.log(date) // 2000-01-01T02:34:56
    let interval = 60 * 60 * 1000
    date = round(date, interval)
    console.log(date) // 2000-01-01T03:00:00

    Nearest Half Hour

    import { round } from '@qc/date-round'
     
    let date = new Date(Date.UTC(2000, 0, 1, 2, 34, 56))
    console.log(date) // 2000-01-01T02:34:56
    let interval = 30 * 60 * 1000
    date = round(date, interval)
    console.log(date) // 2000-01-01T02:30:00

    Nearest 15 Minutes

    import { round } from '@qc/date-round'
     
    let date = new Date(Date.UTC(2000, 0, 1, 2, 34, 56))
    console.log(date) // 2000-01-01T02:34:56
    let interval = 15 * 60 * 1000
    date = round(date, interval)
    console.log(date) // 2000-01-01T02:30:00

    Nearest Ten Minutes

    import { round } from '@qc/date-round'
     
    let date = new Date(Date.UTC(2000, 0, 1, 2, 34, 56))
    console.log(date) // 2000-01-01T02:34:56
    let interval = 10 * 60 * 1000
    date = round(date, interval)
    console.log(date) // 2000-01-01T02:30:00

    Nearest Five Minutes

    import { round } from '@qc/date-round'
     
    let date = new Date(Date.UTC(2000, 0, 1, 2, 34, 56))
    console.log(date) // 2000-01-01T02:34:56
    let interval = 5 * 60 * 1000
    date = round(date, interval)
    console.log(date) // 2000-01-01T02:35:00

    Nearest Minute

    import { round } from '@qc/date-round'
     
    let date = new Date(Date.UTC(2000, 0, 1, 2, 34, 56))
    console.log(date) // 2000-01-01T02:34:56
    let interval = 60 * 1000
    date = round(date, interval)
    console.log(date) // 2000-01-01T02:35:00

    Nearest Second

    import { round } from '@qc/date-round'
     
    let date = new Date(Date.UTC(2000, 0, 1, 2, 34, 56))
    date.setMilliseconds(789)
    console.log(date) // 2000-01-01T02:34:56.789
    let interval = 1000
    date = round(date, interval)
    console.log(date) // 2000-01-01T02:35:57

    Nearest 250 Milliseconds

    import { round } from '@qc/date-round'
     
    let date = new Date(Date.UTC(2000, 0, 1, 2, 34, 56))
    date.setMilliseconds(789)
    console.log(date) // 2000-01-01T02:34:56.789
    let interval = 250
    date = round(date, interval)
    console.log(date) // 2000-01-01T02:35:57.75

    Install

    npm i @qc/date-round

    DownloadsWeekly Downloads

    82

    Version

    0.0.0

    License

    ISC

    Unpacked Size

    5.19 kB

    Total Files

    4

    Last publish

    Collaborators

    • dhurlburtusa
    • qc