chai-datetime
    DefinitelyTyped icon, indicating that this package has TypeScript declarations provided by the separate @types/chai-datetime package

    1.8.0 • Public • Published

    chai-datetime

    Matchers for chai to help with common date comparison assertions against JavaScript Date objects.

    npm version Build Status

    Why?

    Comparing date objects in JavaScript is not based on value, which requires you to call getTime() to ensure the values match. These matchers remove the need to do that. Additionally when comparing getTime() values with the standard chai equality matcher you don't get very readable output because you're comparing epoch seconds.

    Better Error Messages

    Comparing date values for equality with getTime() gives unreadable error messages:

    AssertionError: expected 1369944360000 to equal 1369944300000
    

    Use chai-datetime to get something easier to read:

    AssertionError: expected Thu May 30 2013 16:06:00.000 (-04:00) to equal Thu May 30 2013 16:05:00.000 (-04:00)
    

    Usage

    Browser

    <script src="chai.js"></script>
    <script src="chai-datetime.js"></script>

    Server

    var chai = require('chai');
    chai.use(require('chai-datetime'));

    Assertions

    There are a collection of assertions that work on times and dates. Any assertion that specifies date in the name only compares the date portion of the Date object.

    • equalTime
    • closeToTime (with a configurable delta in seconds)
    • beforeTime
    • beforeOrEqualTime
    • afterTime
    • afterOrEqualTime
    • withinTime
    • equalDate
    • beforeDate
    • beforeOrEqualDate
    • afterDate
    • afterOrEqualDate
    • withinDate

    All assertions are defined for both the BDD and TDD syntaxes.

    var d1 = new Date(2013, 4, 30, 16, 5),
        d2 = new Date(2013, 4, 30, 17);
    
    d1.should.equalDate(d2)
    expect(d1).to.equalDate(d2)
    assert.equalDate(d1, d2)

    Thanks

    Thanks to @mitchlloyd for pairing with me on this to help get me started. Thanks to @rockwood for putting up with my continuous trolling.

    Thanks to the chai-fuzzy module for giving me an idea for how to structure and test a chai plugin.

    Install

    npm i chai-datetime

    DownloadsWeekly Downloads

    53,663

    Version

    1.8.0

    License

    MIT

    Unpacked Size

    54.4 kB

    Total Files

    7

    Last publish

    Collaborators

    • mguterl