@arkyn/shared 2.0.4 → 2.2.0

package/README.md

@@ -69,6 +69,9 @@ npm install @arkyn/shared
 - **`calculateCardInstallment(total: number, installments: number): number[]`**  
   Calculates the installment values for a given total.
 
+- **`ensureQuotes(rawValue: string): string`**  
+  Ensures that a given rawValue string is enclosed in quotes.
+
 - **`maskSensitiveData(data: string): string`**  
   Masks sensitive data in a string.
 

package/dist/formats/formatDate.d.ts

@@ -1,42 +1,31 @@
 import type { FormatDateFunction } from "@arkyn/types";
 /**
- * Formats a date string from a given input format to a specified output format,
- * with optional timezone adjustment.
+ * Formats a date and time string based on the provided input and output formats.
  *
- * @param date - The date string to be formatted. It should match the specified `inputFormat`.
- * @param time - The time string in the format `hh:mm:ss` (e.g., `14:30:00`).
- * @param inputFormat - The format of the input date string. Supported formats:
- *   - `"brazilianDate"`: Expects the date in `DD/MM/YYYY` format.
- *   - `"isoDate"`: Expects the date in `YYYY-MM-DD` format.
- *   - `"timestamp"`: Expects the date as a numeric timestamp (e.g., `YYYY-MM-DD`).
- *
- * @param outputFormat - The desired format for the output date string. Supported tokens:
- *   - `YYYY`: Full year (e.g., 2023)
- *   - `YY`: Last two digits of the year (e.g., 23)
- *   - `MM`: Month (zero-padded, e.g., 01)
- *   - `DD`: Day of the month (zero-padded, e.g., 09)
- *   - `hh`: Hours (zero-padded, 24-hour format, e.g., 08)
- *   - `mm`: Minutes (zero-padded, e.g., 05)
- *   - `ss`: Seconds (zero-padded, e.g., 07)
- * @param timezone - (Optional) The timezone offset in hours to adjust the date. Defaults to `0`.
- *
- * @returns The formatted date string in the specified `outputFormat`.
- *
- * @throws Will throw an error if:
- *   - The `inputFormat` is invalid.
- *   - The `date` string does not match the expected `inputFormat`.
- *   - The `time` string is not in the format `hh:mm:ss`.
- *   - The resulting date is invalid.
+ * @param {[string, string]} dateTime - An array containing the date and optional time.
+ *   - The first element is the date string.
+ *   - The second element is the time string (default is "00:00:00").
+ * @param {"brazilianDate" | "isoDate" | "timestamp"} inputFormat - The format of the input date.
+ *   - "brazilianDate": Expects the date in "DD/MM/YYYY" format.
+ *   - "isoDate": Expects the date in "YYYY-MM-DD" format.
+ *   - "timestamp": Expects the date in "YYYY/MM/DD" format.
+ * @param {string} outputFormat - The desired output format for the date.
+ *   - Use placeholders like "YYYY", "MM", "DD", "hh", "mm", "ss" to define the format.
+ * @param {number} [timezone=0] - The timezone offset in hours to apply to the date.
+ *   - Defaults to 0 (UTC).
+ * @returns {string} The formatted date string based on the output format.
+ * @throws {Error} If the input format is invalid.
+ * @throws {Error} If the date is invalid.
  *
  * @example
- * ```typescript
- * import { formatDate } from "./formatDate";
+ * // Format a Brazilian date to ISO format
+ * formatDate(["25/12/2023", "15:30:00"], "brazilianDate", "YYYY-MM-DD hh:mm:ss");
+ * // Returns: "2023-12-25 15:30:00"
  *
- * const date = "25/12/2023";
- * const time = "14:30:00";
- * const formatted = formatDate(date, time, "brazilianDate", "YYYY-MM-DD hh:mm:ss", -3);
- * console.log(formatted); // Outputs: "2023-12-25 14:30:00"
- * ```
+ * @example
+ * // Format an ISO date to a custom format with timezone adjustment
+ * formatDate(["2023-12-25", "15:30:00"], "isoDate", "DD/MM/YYYY hh:mm:ss", -3);
+ * // Returns: "25/12/2023 12:30:00"
  */
 declare const formatDate: FormatDateFunction;
 export { formatDate };

package/dist/formats/formatDate.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"formatDate.d.ts","sourceRoot":"","sources":["../../src/formats/formatDate.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,cAAc,CAAC;AAqBvD;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAsCG;AAEH,QAAA,MAAM,UAAU,EAAE,kBAiCjB,CAAC;AAEF,OAAO,EAAE,UAAU,EAAE,CAAC"}
+{"version":3,"file":"formatDate.d.ts","sourceRoot":"","sources":["../../src/formats/formatDate.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,cAAc,CAAC;AAqBvD;;;;;;;;;;;;;;;;;;;;;;;;;;;GA2BG;AAEH,QAAA,MAAM,UAAU,EAAE,kBAgCjB,CAAC;AAEF,OAAO,EAAE,UAAU,EAAE,CAAC"}

package/dist/formats/formatDate.js

@@ -12,45 +12,34 @@ function formatDateString(date, format) {
     return format.replace(/YYYY|YY|MM|DD|hh|mm|ss/g, (match) => replacements[match]);
 }
 /**
- * Formats a date string from a given input format to a specified output format,
- * with optional timezone adjustment.
+ * Formats a date and time string based on the provided input and output formats.
  *
- * @param date - The date string to be formatted. It should match the specified `inputFormat`.
- * @param time - The time string in the format `hh:mm:ss` (e.g., `14:30:00`).
- * @param inputFormat - The format of the input date string. Supported formats:
- *   - `"brazilianDate"`: Expects the date in `DD/MM/YYYY` format.
- *   - `"isoDate"`: Expects the date in `YYYY-MM-DD` format.
- *   - `"timestamp"`: Expects the date as a numeric timestamp (e.g., `YYYY-MM-DD`).
- *
- * @param outputFormat - The desired format for the output date string. Supported tokens:
- *   - `YYYY`: Full year (e.g., 2023)
- *   - `YY`: Last two digits of the year (e.g., 23)
- *   - `MM`: Month (zero-padded, e.g., 01)
- *   - `DD`: Day of the month (zero-padded, e.g., 09)
- *   - `hh`: Hours (zero-padded, 24-hour format, e.g., 08)
- *   - `mm`: Minutes (zero-padded, e.g., 05)
- *   - `ss`: Seconds (zero-padded, e.g., 07)
- * @param timezone - (Optional) The timezone offset in hours to adjust the date. Defaults to `0`.
- *
- * @returns The formatted date string in the specified `outputFormat`.
- *
- * @throws Will throw an error if:
- *   - The `inputFormat` is invalid.
- *   - The `date` string does not match the expected `inputFormat`.
- *   - The `time` string is not in the format `hh:mm:ss`.
- *   - The resulting date is invalid.
+ * @param {[string, string]} dateTime - An array containing the date and optional time.
+ *   - The first element is the date string.
+ *   - The second element is the time string (default is "00:00:00").
+ * @param {"brazilianDate" | "isoDate" | "timestamp"} inputFormat - The format of the input date.
+ *   - "brazilianDate": Expects the date in "DD/MM/YYYY" format.
+ *   - "isoDate": Expects the date in "YYYY-MM-DD" format.
+ *   - "timestamp": Expects the date in "YYYY/MM/DD" format.
+ * @param {string} outputFormat - The desired output format for the date.
+ *   - Use placeholders like "YYYY", "MM", "DD", "hh", "mm", "ss" to define the format.
+ * @param {number} [timezone=0] - The timezone offset in hours to apply to the date.
+ *   - Defaults to 0 (UTC).
+ * @returns {string} The formatted date string based on the output format.
+ * @throws {Error} If the input format is invalid.
+ * @throws {Error} If the date is invalid.
  *
  * @example
- * ```typescript
- * import { formatDate } from "./formatDate";
+ * // Format a Brazilian date to ISO format
+ * formatDate(["25/12/2023", "15:30:00"], "brazilianDate", "YYYY-MM-DD hh:mm:ss");
+ * // Returns: "2023-12-25 15:30:00"
  *
- * const date = "25/12/2023";
- * const time = "14:30:00";
- * const formatted = formatDate(date, time, "brazilianDate", "YYYY-MM-DD hh:mm:ss", -3);
- * console.log(formatted); // Outputs: "2023-12-25 14:30:00"
- * ```
+ * @example
+ * // Format an ISO date to a custom format with timezone adjustment
+ * formatDate(["2023-12-25", "15:30:00"], "isoDate", "DD/MM/YYYY hh:mm:ss", -3);
+ * // Returns: "25/12/2023 12:30:00"
  */
-const formatDate = (date, time, inputFormat, outputFormat, timezone = 0) => {
+const formatDate = ([date, time = "00:00:00"], inputFormat, outputFormat, timezone = 0) => {
     const dateParts = date.split(/[-/]/).map(Number);
     const timeParts = time.split(":").map(Number);
     let day, month, year;

package/dist/formats/formatToDate.d.ts

@@ -0,0 +1,30 @@
+/**
+ * Converts a date and time input into a JavaScript `Date` object, formatted according to the specified input format and timezone.
+ *
+ * @param param0 - A tuple containing the date string and an optional time string.
+ *                 The date string format depends on the `inputFormat` parameter.
+ *                 The time string defaults to "00:00:00" if not provided.
+ * @param inputFormat - The format of the input date string.
+ *                      Supported formats are:
+ *                      - `"brazilianDate"`: Expects the date in `DD/MM/YYYY` format.
+ *                      - `"isoDate"`: Expects the date in `YYYY-MM-DD` format.
+ *                      - `"timestamp"`: Expects the date in `YYYY-MM-DD` format (similar to `isoDate`).
+ * @param timezone - An optional timezone offset in hours. Defaults to `0` (UTC).
+ *
+ * @returns A `Date` object representing the parsed date and time, adjusted for the specified timezone.
+ *
+ * @throws {Error} If the `inputFormat` is invalid.
+ * @throws {Error} If the provided date or time is invalid.
+ *
+ * @example
+ * ```typescript
+ * import { formatToDate } from "./formatToIsoDate";
+ *
+ * const date = formatToDate(["25/12/2023", "15:30:00"], "brazilianDate", -3);
+ * console.log(date); // Outputs a Date object for "2023-12-25T18:30:00.000Z" (UTC)
+ * ```
+ */
+import type { FormatToDateFunction } from "@arkyn/types";
+declare const formatToDate: FormatToDateFunction;
+export { formatToDate };
+//# sourceMappingURL=formatToDate.d.ts.map

package/dist/formats/formatToDate.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"formatToDate.d.ts","sourceRoot":"","sources":["../../src/formats/formatToDate.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;GAyBG;AACH,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,cAAc,CAAC;AAEzD,QAAA,MAAM,YAAY,EAAE,oBAgCnB,CAAC;AAEF,OAAO,EAAE,YAAY,EAAE,CAAC"}

package/dist/formats/formatToDate.js

@@ -0,0 +1,24 @@
+const formatToDate = ([date, time = "00:00:00"], inputFormat, timezone = 0) => {
+    const dateParts = date.split(/[-/]/).map(Number);
+    const timeParts = time.split(":").map(Number);
+    let day, month, year;
+    const [hours = 0, minutes = 0, seconds = 0] = timeParts;
+    switch (inputFormat) {
+        case "brazilianDate":
+            [day, month, year] = dateParts;
+            break;
+        case "isoDate":
+            [year, month, day] = dateParts;
+            break;
+        case "timestamp":
+            [year, month, day] = dateParts.map(Number);
+            break;
+        default:
+            throw new Error("Invalid input format");
+    }
+    const utcDate = new Date(Date.UTC(year, month - 1, day, hours - timezone, minutes, seconds));
+    if (isNaN(utcDate.getTime()))
+        throw new Error("Invalid date");
+    return utcDate;
+};
+export { formatToDate };

package/dist/index.d.ts

@@ -9,6 +9,7 @@ export { formatToCurrency } from "./formats/formatToCurrency";
 export { formatToEllipsis } from "./formats/formatToEllipsis";
 export { formatToHiddenDigits } from "./formats/formatToHiddenDigits";
 export { formatToPhone } from "./formats/formatToPhone";
+export { formatToDate } from "./formats/formatToDate";
 export { generateColorByString } from "./generators/generateColorByString";
 export { generateId } from "./generators/generateId";
 export { generateSlug } from "./generators/generateSlug";

package/dist/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,UAAU,EAAE,MAAM,sBAAsB,CAAC;AAClD,OAAO,EAAE,gBAAgB,EAAE,MAAM,4BAA4B,CAAC;AAC9D,OAAO,EAAE,gBAAgB,EAAE,MAAM,4BAA4B,CAAC;AAC9D,OAAO,EAAE,WAAW,EAAE,MAAM,uBAAuB,CAAC;AACpD,OAAO,EAAE,YAAY,EAAE,MAAM,wBAAwB,CAAC;AACtD,OAAO,EAAE,WAAW,EAAE,MAAM,uBAAuB,CAAC;AACpD,OAAO,EAAE,eAAe,EAAE,MAAM,2BAA2B,CAAC;AAC5D,OAAO,EAAE,gBAAgB,EAAE,MAAM,4BAA4B,CAAC;AAC9D,OAAO,EAAE,gBAAgB,EAAE,MAAM,4BAA4B,CAAC;AAC9D,OAAO,EAAE,oBAAoB,EAAE,MAAM,gCAAgC,CAAC;AACtE,OAAO,EAAE,aAAa,EAAE,MAAM,yBAAyB,CAAC;AAGxD,OAAO,EAAE,qBAAqB,EAAE,MAAM,oCAAoC,CAAC;AAC3E,OAAO,EAAE,UAAU,EAAE,MAAM,yBAAyB,CAAC;AACrD,OAAO,EAAE,YAAY,EAAE,MAAM,2BAA2B,CAAC;AAGzD,OAAO,EAAE,wBAAwB,EAAE,MAAM,qCAAqC,CAAC;AAC/E,OAAO,EAAE,iBAAiB,EAAE,MAAM,8BAA8B,CAAC;AACjE,OAAO,EAAE,gBAAgB,EAAE,MAAM,6BAA6B,CAAC;AAC/D,OAAO,EAAE,mBAAmB,EAAE,MAAM,gCAAgC,CAAC;AAGrE,OAAO,EAAE,WAAW,EAAE,MAAM,2BAA2B,CAAC;AACxD,OAAO,EAAE,YAAY,EAAE,MAAM,4BAA4B,CAAC;AAC1D,OAAO,EAAE,WAAW,EAAE,MAAM,2BAA2B,CAAC;AACxD,OAAO,EAAE,YAAY,EAAE,MAAM,4BAA4B,CAAC;AAC1D,OAAO,EAAE,aAAa,EAAE,MAAM,6BAA6B,CAAC;AAC5D,OAAO,EAAE,UAAU,EAAE,MAAM,0BAA0B,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,UAAU,EAAE,MAAM,sBAAsB,CAAC;AAClD,OAAO,EAAE,gBAAgB,EAAE,MAAM,4BAA4B,CAAC;AAC9D,OAAO,EAAE,gBAAgB,EAAE,MAAM,4BAA4B,CAAC;AAC9D,OAAO,EAAE,WAAW,EAAE,MAAM,uBAAuB,CAAC;AACpD,OAAO,EAAE,YAAY,EAAE,MAAM,wBAAwB,CAAC;AACtD,OAAO,EAAE,WAAW,EAAE,MAAM,uBAAuB,CAAC;AACpD,OAAO,EAAE,eAAe,EAAE,MAAM,2BAA2B,CAAC;AAC5D,OAAO,EAAE,gBAAgB,EAAE,MAAM,4BAA4B,CAAC;AAC9D,OAAO,EAAE,gBAAgB,EAAE,MAAM,4BAA4B,CAAC;AAC9D,OAAO,EAAE,oBAAoB,EAAE,MAAM,gCAAgC,CAAC;AACtE,OAAO,EAAE,aAAa,EAAE,MAAM,yBAAyB,CAAC;AACxD,OAAO,EAAE,YAAY,EAAE,MAAM,wBAAwB,CAAC;AAGtD,OAAO,EAAE,qBAAqB,EAAE,MAAM,oCAAoC,CAAC;AAC3E,OAAO,EAAE,UAAU,EAAE,MAAM,yBAAyB,CAAC;AACrD,OAAO,EAAE,YAAY,EAAE,MAAM,2BAA2B,CAAC;AAGzD,OAAO,EAAE,wBAAwB,EAAE,MAAM,qCAAqC,CAAC;AAC/E,OAAO,EAAE,iBAAiB,EAAE,MAAM,8BAA8B,CAAC;AACjE,OAAO,EAAE,gBAAgB,EAAE,MAAM,6BAA6B,CAAC;AAC/D,OAAO,EAAE,mBAAmB,EAAE,MAAM,gCAAgC,CAAC;AAGrE,OAAO,EAAE,WAAW,EAAE,MAAM,2BAA2B,CAAC;AACxD,OAAO,EAAE,YAAY,EAAE,MAAM,4BAA4B,CAAC;AAC1D,OAAO,EAAE,WAAW,EAAE,MAAM,2BAA2B,CAAC;AACxD,OAAO,EAAE,YAAY,EAAE,MAAM,4BAA4B,CAAC;AAC1D,OAAO,EAAE,aAAa,EAAE,MAAM,6BAA6B,CAAC;AAC5D,OAAO,EAAE,UAAU,EAAE,MAAM,0BAA0B,CAAC"}

package/dist/index.js

@@ -10,6 +10,7 @@ export { formatToCurrency } from "./formats/formatToCurrency";
 export { formatToEllipsis } from "./formats/formatToEllipsis";
 export { formatToHiddenDigits } from "./formats/formatToHiddenDigits";
 export { formatToPhone } from "./formats/formatToPhone";
+export { formatToDate } from "./formats/formatToDate";
 // generators
 export { generateColorByString } from "./generators/generateColorByString";
 export { generateId } from "./generators/generateId";

package/dist/services/ensureQuotes.d.ts

@@ -0,0 +1,14 @@
+import type { EnsureQuotesFunction } from "@arkyn/types";
+/**
+ * Ensures that a given rawValue string is enclosed in quotes.
+ *
+ * This function checks if the input string is already enclosed in either single
+ * quotes (`'`) or double quotes (`"`). If the string is already quoted, it is
+ * returned as-is. Otherwise, the function wraps the string in double quotes.
+ *
+ * @param url - The URL string to be checked and potentially quoted.
+ * @returns The input string, either unchanged if it is already quoted, or wrapped in double quotes.
+ */
+declare const ensureQuotes: EnsureQuotesFunction;
+export { ensureQuotes };
+//# sourceMappingURL=ensureQuotes.d.ts.map

package/dist/services/ensureQuotes.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ensureQuotes.d.ts","sourceRoot":"","sources":["../../src/services/ensureQuotes.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,cAAc,CAAC;AAEzD;;;;;;;;;GASG;AAEH,QAAA,MAAM,YAAY,EAAE,oBASnB,CAAC;AAEF,OAAO,EAAE,YAAY,EAAE,CAAC"}

package/dist/services/ensureQuotes.js

@@ -0,0 +1,19 @@
+/**
+ * Ensures that a given rawValue string is enclosed in quotes.
+ *
+ * This function checks if the input string is already enclosed in either single
+ * quotes (`'`) or double quotes (`"`). If the string is already quoted, it is
+ * returned as-is. Otherwise, the function wraps the string in double quotes.
+ *
+ * @param url - The URL string to be checked and potentially quoted.
+ * @returns The input string, either unchanged if it is already quoted, or wrapped in double quotes.
+ */
+const ensureQuotes = (rawValue) => {
+    const hasSingleQuotes = rawValue.startsWith("'") && rawValue.endsWith("'");
+    const hasDoubleQuotes = rawValue.startsWith('"') && rawValue.endsWith('"');
+    if (hasSingleQuotes || hasDoubleQuotes) {
+        return rawValue;
+    }
+    return `"${rawValue}"`;
+};
+export { ensureQuotes };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@arkyn/shared",
-  "version": "2.0.4",
+  "version": "2.2.0",
   "main": "./dist/bundle.js",
   "module": "./src/index.ts",
   "type": "module",

package/src/formats/formatDate.ts

@@ -20,48 +20,36 @@ function formatDateString(date: Date, format: string): string {
 }
 
 /**
- * Formats a date string from a given input format to a specified output format,
- * with optional timezone adjustment.
+ * Formats a date and time string based on the provided input and output formats.
  *
- * @param date - The date string to be formatted. It should match the specified `inputFormat`.
- * @param time - The time string in the format `hh:mm:ss` (e.g., `14:30:00`).
- * @param inputFormat - The format of the input date string. Supported formats:
- *   - `"brazilianDate"`: Expects the date in `DD/MM/YYYY` format.
- *   - `"isoDate"`: Expects the date in `YYYY-MM-DD` format.
- *   - `"timestamp"`: Expects the date as a numeric timestamp (e.g., `YYYY-MM-DD`).
- *
- * @param outputFormat - The desired format for the output date string. Supported tokens:
- *   - `YYYY`: Full year (e.g., 2023)
- *   - `YY`: Last two digits of the year (e.g., 23)
- *   - `MM`: Month (zero-padded, e.g., 01)
- *   - `DD`: Day of the month (zero-padded, e.g., 09)
- *   - `hh`: Hours (zero-padded, 24-hour format, e.g., 08)
- *   - `mm`: Minutes (zero-padded, e.g., 05)
- *   - `ss`: Seconds (zero-padded, e.g., 07)
- * @param timezone - (Optional) The timezone offset in hours to adjust the date. Defaults to `0`.
- *
- * @returns The formatted date string in the specified `outputFormat`.
- *
- * @throws Will throw an error if:
- *   - The `inputFormat` is invalid.
- *   - The `date` string does not match the expected `inputFormat`.
- *   - The `time` string is not in the format `hh:mm:ss`.
- *   - The resulting date is invalid.
+ * @param {[string, string]} dateTime - An array containing the date and optional time.
+ *   - The first element is the date string.
+ *   - The second element is the time string (default is "00:00:00").
+ * @param {"brazilianDate" | "isoDate" | "timestamp"} inputFormat - The format of the input date.
+ *   - "brazilianDate": Expects the date in "DD/MM/YYYY" format.
+ *   - "isoDate": Expects the date in "YYYY-MM-DD" format.
+ *   - "timestamp": Expects the date in "YYYY/MM/DD" format.
+ * @param {string} outputFormat - The desired output format for the date.
+ *   - Use placeholders like "YYYY", "MM", "DD", "hh", "mm", "ss" to define the format.
+ * @param {number} [timezone=0] - The timezone offset in hours to apply to the date.
+ *   - Defaults to 0 (UTC).
+ * @returns {string} The formatted date string based on the output format.
+ * @throws {Error} If the input format is invalid.
+ * @throws {Error} If the date is invalid.
  *
  * @example
- * ```typescript
- * import { formatDate } from "./formatDate";
+ * // Format a Brazilian date to ISO format
+ * formatDate(["25/12/2023", "15:30:00"], "brazilianDate", "YYYY-MM-DD hh:mm:ss");
+ * // Returns: "2023-12-25 15:30:00"
  *
- * const date = "25/12/2023";
- * const time = "14:30:00";
- * const formatted = formatDate(date, time, "brazilianDate", "YYYY-MM-DD hh:mm:ss", -3);
- * console.log(formatted); // Outputs: "2023-12-25 14:30:00"
- * ```
+ * @example
+ * // Format an ISO date to a custom format with timezone adjustment
+ * formatDate(["2023-12-25", "15:30:00"], "isoDate", "DD/MM/YYYY hh:mm:ss", -3);
+ * // Returns: "25/12/2023 12:30:00"
  */
 
 const formatDate: FormatDateFunction = (
-  date,
-  time,
+  [date, time = "00:00:00"],
   inputFormat,
   outputFormat,
   timezone = 0

package/src/formats/formatToDate.ts

@@ -0,0 +1,63 @@
+/**
+ * Converts a date and time input into a JavaScript `Date` object, formatted according to the specified input format and timezone.
+ *
+ * @param param0 - A tuple containing the date string and an optional time string.
+ *                 The date string format depends on the `inputFormat` parameter.
+ *                 The time string defaults to "00:00:00" if not provided.
+ * @param inputFormat - The format of the input date string.
+ *                      Supported formats are:
+ *                      - `"brazilianDate"`: Expects the date in `DD/MM/YYYY` format.
+ *                      - `"isoDate"`: Expects the date in `YYYY-MM-DD` format.
+ *                      - `"timestamp"`: Expects the date in `YYYY-MM-DD` format (similar to `isoDate`).
+ * @param timezone - An optional timezone offset in hours. Defaults to `0` (UTC).
+ *
+ * @returns A `Date` object representing the parsed date and time, adjusted for the specified timezone.
+ *
+ * @throws {Error} If the `inputFormat` is invalid.
+ * @throws {Error} If the provided date or time is invalid.
+ *
+ * @example
+ * ```typescript
+ * import { formatToDate } from "./formatToIsoDate";
+ *
+ * const date = formatToDate(["25/12/2023", "15:30:00"], "brazilianDate", -3);
+ * console.log(date); // Outputs a Date object for "2023-12-25T18:30:00.000Z" (UTC)
+ * ```
+ */
+import type { FormatToDateFunction } from "@arkyn/types";
+
+const formatToDate: FormatToDateFunction = (
+  [date, time = "00:00:00"],
+  inputFormat,
+  timezone = 0
+) => {
+  const dateParts = date.split(/[-/]/).map(Number);
+  const timeParts = time.split(":").map(Number);
+
+  let day, month, year;
+  const [hours = 0, minutes = 0, seconds = 0] = timeParts;
+
+  switch (inputFormat) {
+    case "brazilianDate":
+      [day, month, year] = dateParts;
+      break;
+    case "isoDate":
+      [year, month, day] = dateParts;
+      break;
+    case "timestamp":
+      [year, month, day] = dateParts.map(Number);
+      break;
+    default:
+      throw new Error("Invalid input format");
+  }
+
+  const utcDate = new Date(
+    Date.UTC(year, month - 1, day, hours - timezone, minutes, seconds)
+  );
+
+  if (isNaN(utcDate.getTime())) throw new Error("Invalid date");
+
+  return utcDate;
+};
+
+export { formatToDate };

package/src/index.ts

@@ -10,6 +10,7 @@ export { formatToCurrency } from "./formats/formatToCurrency";
 export { formatToEllipsis } from "./formats/formatToEllipsis";
 export { formatToHiddenDigits } from "./formats/formatToHiddenDigits";
 export { formatToPhone } from "./formats/formatToPhone";
+export { formatToDate } from "./formats/formatToDate";
 
 // generators
 export { generateColorByString } from "./generators/generateColorByString";

package/src/services/ensureQuotes.ts

@@ -0,0 +1,25 @@
+import type { EnsureQuotesFunction } from "@arkyn/types";
+
+/**
+ * Ensures that a given rawValue string is enclosed in quotes.
+ *
+ * This function checks if the input string is already enclosed in either single
+ * quotes (`'`) or double quotes (`"`). If the string is already quoted, it is
+ * returned as-is. Otherwise, the function wraps the string in double quotes.
+ *
+ * @param url - The URL string to be checked and potentially quoted.
+ * @returns The input string, either unchanged if it is already quoted, or wrapped in double quotes.
+ */
+
+const ensureQuotes: EnsureQuotesFunction = (rawValue) => {
+  const hasSingleQuotes = rawValue.startsWith("'") && rawValue.endsWith("'");
+  const hasDoubleQuotes = rawValue.startsWith('"') && rawValue.endsWith('"');
+
+  if (hasSingleQuotes || hasDoubleQuotes) {
+    return rawValue;
+  }
+
+  return `"${rawValue}"`;
+};
+
+export { ensureQuotes };