📝 Commit Details:

backend/node_modules/date-fns/formatISO.cjs

@@ -0,0 +1,106 @@
+"use strict";
+exports.formatISO = formatISO;
+var _index = require("./_lib/addLeadingZeros.cjs");
+var _index2 = require("./toDate.cjs");
+
+/**
+ * The {@link formatISO} function options.
+ */
+
+/**
+ * @name formatISO
+ * @category Common Helpers
+ * @summary Format the date according to the ISO 8601 standard (https://support.sas.com/documentation/cdl/en/lrdict/64316/HTML/default/viewer.htm#a003169814.htm).
+ *
+ * @description
+ * Return the formatted date string in ISO 8601 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 (in local time zone)
+ *
+ * @throws `date` must not be Invalid Date
+ *
+ * @example
+ * // Represent 18 September 2019 in ISO 8601 format (local time zone is UTC):
+ * const result = formatISO(new Date(2019, 8, 18, 19, 0, 52))
+ * //=> '2019-09-18T19:00:52Z'
+ *
+ * @example
+ * // Represent 18 September 2019 in ISO 8601, short format (local time zone is UTC):
+ * const result = formatISO(new Date(2019, 8, 18, 19, 0, 52), { format: 'basic' })
+ * //=> '20190918T190052'
+ *
+ * @example
+ * // Represent 18 September 2019 in ISO 8601 format, date only:
+ * const result = formatISO(new Date(2019, 8, 18, 19, 0, 52), { representation: 'date' })
+ * //=> '2019-09-18'
+ *
+ * @example
+ * // Represent 18 September 2019 in ISO 8601 format, time only (local time zone is UTC):
+ * const result = formatISO(new Date(2019, 8, 18, 19, 0, 52), { representation: 'time' })
+ * //=> '19:00:52Z'
+ */
+function formatISO(date, options) {
+  const date_ = (0, _index2.toDate)(date, options?.in);
+
+  if (isNaN(+date_)) {
+    throw new RangeError("Invalid time value");
+  }
+
+  const format = options?.format ?? "extended";
+  const representation = options?.representation ?? "complete";
+
+  let result = "";
+  let tzOffset = "";
+
+  const dateDelimiter = format === "extended" ? "-" : "";
+  const timeDelimiter = format === "extended" ? ":" : "";
+
+  // Representation is either 'date' or 'complete'
+  if (representation !== "time") {
+    const day = (0, _index.addLeadingZeros)(date_.getDate(), 2);
+    const month = (0, _index.addLeadingZeros)(date_.getMonth() + 1, 2);
+    const year = (0, _index.addLeadingZeros)(date_.getFullYear(), 4);
+
+    // yyyyMMdd or yyyy-MM-dd.
+    result = `${year}${dateDelimiter}${month}${dateDelimiter}${day}`;
+  }
+
+  // Representation is either 'time' or 'complete'
+  if (representation !== "date") {
+    // Add the timezone.
+    const offset = date_.getTimezoneOffset();
+
+    if (offset !== 0) {
+      const absoluteOffset = Math.abs(offset);
+      const hourOffset = (0, _index.addLeadingZeros)(
+        Math.trunc(absoluteOffset / 60),
+        2,
+      );
+      const minuteOffset = (0, _index.addLeadingZeros)(absoluteOffset % 60, 2);
+      // If less than 0, the sign is +, because it is ahead of time.
+      const sign = offset < 0 ? "+" : "-";
+
+      tzOffset = `${sign}${hourOffset}:${minuteOffset}`;
+    } else {
+      tzOffset = "Z";
+    }
+
+    const hour = (0, _index.addLeadingZeros)(date_.getHours(), 2);
+    const minute = (0, _index.addLeadingZeros)(date_.getMinutes(), 2);
+    const second = (0, _index.addLeadingZeros)(date_.getSeconds(), 2);
+
+    // If there's also date, separate it with time with 'T'
+    const separator = result === "" ? "" : "T";
+
+    // Creates a time string consisting of hour, minute, and second, separated by delimiters, if defined.
+    const time = [hour, minute, second].join(timeDelimiter);
+
+    // HHmmss or HH:mm:ss.
+    result = `${result}${separator}${time}${tzOffset}`;
+  }
+
+  return result;
+}