📝 Commit Details:

backend/node_modules/date-fns/formatISO9075.js

@@ -0,0 +1,86 @@
+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;