date-to-iso-8601-string/dist/commonjs/index.js

Presents a JavaScript `Date` as a string in [ISO 8601 format](https://www.loc.gov/standards/datetime/iso-tc154-wg5_n0038_iso_wd_8601-1_2016-02-16.pdf), with support for the Extended (`YYYY-MM-DD`) and Basic (`YYYYMMDD`) variants

"use strict";
Object.defineProperty(exports, "__esModule", { value: true });
exports.dateToISO8601String = exports.ISO8601DateFormat = void 0;
var ISO8601DateFormat;
(function (ISO8601DateFormat) {
    /**
     * The ISO 8601 Basic date format, `YYYYMMDD` (e.g. `20230101`)
     */
    ISO8601DateFormat[ISO8601DateFormat["Basic"] = 0] = "Basic";
    /**
     * The ISO 8601 Extended date format, `YYYY-MM-DD` (e.g. `2023-01-01`)
     */
    ISO8601DateFormat[ISO8601DateFormat["Extended"] = 1] = "Extended";
})(ISO8601DateFormat = exports.ISO8601DateFormat || (exports.ISO8601DateFormat = {}));
/**
 * Presents the supplied JavaScript `Date` as a string in ISO 8601 Basic format,
 * `YYYYMMDD` (e.g. `20230101`) (see
 * <https://www.loc.gov/standards/datetime/iso-tc154-wg5_n0038_iso_wd_8601-1_2016-02-16.pdf>).
 *
 * @param date the date to present
 */
const dateToISO8601BasicFormatString = (date) => {
    const yyyy = date.getFullYear().toString();
    const mm = (date.getMonth() + 1).toString().padStart(2, '0');
    const dd = date.getDate().toString().padStart(2, '0');
    return [yyyy, mm, dd].join('');
};
/**
 * Presents the supplied JavaScript `Date` as a string in ISO 8601 Extended format,
 * `YYYY-MM-DD` (e.g. `2023-01-01`) (see
 * <https://www.loc.gov/standards/datetime/iso-tc154-wg5_n0038_iso_wd_8601-1_2016-02-16.pdf>).
 *
 * @param date the date to present
 */
const dateToISO8601ExtendedFormatString = (date) => {
    const yyyy = date.getFullYear().toString();
    const mm = (date.getMonth() + 1).toString().padStart(2, '0');
    const dd = date.getDate().toString().padStart(2, '0');
    return [yyyy, mm, dd].join('-');
};
/**
 * Presents the supplied JavaScript `Date` as a date string in ISO 8601 format,
 * using the local time, rather than UTC. Defaults to the Extended date format
 * (`YYYY-MM-DD`).
 *
 * @param date the date to present
 * @param format the ISO 8601 format to use for presentation, defaulting to
 *               Extended format. See <https://www.loc.gov/standards/datetime/iso-tc154-wg5_n0038_iso_wd_8601-1_2016-02-16.pdf>.
 */
const dateToISO8601String = (date, format = ISO8601DateFormat.Extended) => {
    switch (format) {
        case ISO8601DateFormat.Basic:
            return dateToISO8601BasicFormatString(date);
        case ISO8601DateFormat.Extended:
            return dateToISO8601ExtendedFormatString(date);
    }
};
exports.dateToISO8601String = dateToISO8601String;