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

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