1234567891011121314151617181920212223242526272829303132333435363738394041424344454647484950515253545556575859606162636465666768697071727374757677787980818283848586 |
- import { addLeadingZeros } from "./_lib/addLeadingZeros.js";
- import { isValid } from "./isValid.js";
- import { toDate } from "./toDate.js";
- /**
- * The {@link formatISO9075} function options.
- */
- /**
- * @name formatISO9075
- * @category Common Helpers
- * @summary Format the date according to the ISO 9075 standard (https://dev.mysql.com/doc/refman/5.7/en/date-and-time-functions.html#function_get-format).
- *
- * @description
- * Return the formatted date string in ISO 9075 format. Options may be passed to control the parts and notations of the date.
- *
- * @param date - The original date
- * @param options - An object with options.
- *
- * @returns The formatted date string
- *
- * @throws `date` must not be Invalid Date
- *
- * @example
- * // Represent 18 September 2019 in ISO 9075 format:
- * const result = formatISO9075(new Date(2019, 8, 18, 19, 0, 52))
- * //=> '2019-09-18 19:00:52'
- *
- * @example
- * // Represent 18 September 2019 in ISO 9075, short format:
- * const result = formatISO9075(new Date(2019, 8, 18, 19, 0, 52), { format: 'basic' })
- * //=> '20190918 190052'
- *
- * @example
- * // Represent 18 September 2019 in ISO 9075 format, date only:
- * const result = formatISO9075(new Date(2019, 8, 18, 19, 0, 52), { representation: 'date' })
- * //=> '2019-09-18'
- *
- * @example
- * // Represent 18 September 2019 in ISO 9075 format, time only:
- * const result = formatISO9075(new Date(2019, 8, 18, 19, 0, 52), { representation: 'time' })
- * //=> '19:00:52'
- */
- export function formatISO9075(date, options) {
- const date_ = toDate(date, options?.in);
- if (!isValid(date_)) {
- throw new RangeError("Invalid time value");
- }
- const format = options?.format ?? "extended";
- const representation = options?.representation ?? "complete";
- let result = "";
- const dateDelimiter = format === "extended" ? "-" : "";
- const timeDelimiter = format === "extended" ? ":" : "";
- // Representation is either 'date' or 'complete'
- if (representation !== "time") {
- const day = addLeadingZeros(date_.getDate(), 2);
- const month = addLeadingZeros(date_.getMonth() + 1, 2);
- const year = addLeadingZeros(date_.getFullYear(), 4);
- // yyyyMMdd or yyyy-MM-dd.
- result = `${year}${dateDelimiter}${month}${dateDelimiter}${day}`;
- }
- // Representation is either 'time' or 'complete'
- if (representation !== "date") {
- const hour = addLeadingZeros(date_.getHours(), 2);
- const minute = addLeadingZeros(date_.getMinutes(), 2);
- const second = addLeadingZeros(date_.getSeconds(), 2);
- // If there's also date, separate it with time with a space
- const separator = result === "" ? "" : " ";
- // HHmmss or HH:mm:ss.
- result = `${result}${separator}${hour}${timeDelimiter}${minute}${timeDelimiter}${second}`;
- }
- return result;
- }
- // Fallback for modularized imports:
- export default formatISO9075;
|