Have ideas to improve npm?Join in the discussion! »

    local-iso-dt

    3.1.0 • Public • Published

    local-ISO-dt — toISOString() in the local timezone

    Build Status Dependency Status devDependency Status

    Convert the most common types of dates and timestamps into datetime strings in the standard YYYY-MM-DDTHH:MM:SS format, in the local timezone. This format is called ISO8601 or RFC3339, the difference being that RFC3339 mandates a four-digit year and allows the 'T' to be replaced with a space. The library outputs the 'T' between the date and the time, which you can easily .replace('T', ' ').

    The YYYY-MM-DD date format is great because sorting alphabetically is equivalent to sorting chronologically. Other date formats, in particular the idiosyncratic m/dd/yy American format, do not have this property.

    Features

    Supports and automatically detects the parameter being a:

    • number of seconds/milliseconds/microseconds/nanoseconds since epoch
    • Date object
    • YYYY-MM-DD[THH:MM:SS] string
    • falsy value - the current date will be returned

    Install

    npm i local-iso-dt

    Usage

    • TypeScript: import { localISOdt } from 'local-iso-dt';
    • ES modules .mjs files: import { localISOdt } from 'local-iso-dt/index.mjs';
    • Old school CommonJS: const { localISOdt } = require('local-iso-dt/index.js');

    This is a hybrid npm package (created using variation 2.4.1 described on that page), with conditional exports that enable named imports even from TypeScript code generating ES Modules, which would otherwise only support default (not named) imports from the CommonJS target of this package (TypeScript doesn't support .mjs input files).

    Examples

    import { localISOdt } from 'local-iso-dt';  // or...
    // const { localISOdt } = require('local-iso-dt/index.js');
     
    // Prefix log messages with the current date in the
    // local timezone in YYYY-MM-DDTHH:MM:SS format
    console.log(localISOdt(), 'Starting job...');
     
    // 2017-07-15T05:57:36 if you're in the Pacific (-0700) timezone
    localISOdt(1500123456);

    Author

    Dan Dascalescu

    License

    MIT

    Install

    npm i local-iso-dt

    DownloadsWeekly Downloads

    85

    Version

    3.1.0

    License

    MIT

    Unpacked Size

    8.88 kB

    Total Files

    6

    Last publish

    Collaborators

    • avatar