@stryke/date 0.0.2

package/dist/format.mjs

@@ -0,0 +1,200 @@
+//#region src/format.ts
+/**
+* A utility function that formats a Date object into a string in the format "YYYY-MM-DD".
+*
+* @remarks
+* This function takes a Date object as input and returns a string representation of the date in the "YYYY-MM-DD" format.
+*
+* @example
+* ```ts
+* const date = new Date(2024, 0, 15); // January 15, 2024
+* const formattedDate = formatYYYYMMDD(date); // formattedDate will be "2024-01-15"
+* const formattedDateWithCustomSeparator = formatYYYYMMDD(date, { separator: "/" }); // formattedDateWithCustomSeparator will be "2024/01/15"
+* ```
+*
+* @param date - The Date object to be formatted.
+* @param options - Optional configuration for formatting the date, including a custom separator.
+* @returns A string representing the formatted date in "YYYY-MM-DD" format.
+*/
+function formatYYYYMMDD(date, options) {
+	const year = date.getFullYear();
+	const month = String(date.getMonth() + 1).padStart(2, "0");
+	const day = String(date.getDate()).padStart(2, "0");
+	const separator = options?.separator ?? "-";
+	return `${year}${separator}${month}${separator}${day}`;
+}
+/**
+* A utility function that formats a Date object into a string in the format "MM-DD-YYYY".
+*
+* @remarks
+* This function takes a Date object as input and returns a string representation of the date in the "MM-DD-YYYY" format.
+*
+* @example
+* ```ts
+* const date = new Date(2024, 0, 15); // January 15, 2024
+* const formattedDate = formatMMDDYYYY(date); // formattedDate will be "01-15-2024"
+* const formattedDateWithCustomSeparator = formatMMDDYYYY(date, { separator: "/" }); // formattedDateWithCustomSeparator will be "01/15/2024"
+* ```
+*
+* @param date - The Date object to be formatted.
+* @param options - Optional configuration for formatting the date, including a custom separator.
+* @returns A string representing the formatted date in "MM-DD-YYYY" format.
+*/
+function formatMMDDYYYY(date, options) {
+	const month = String(date.getMonth() + 1).padStart(2, "0");
+	const day = String(date.getDate()).padStart(2, "0");
+	const year = date.getFullYear();
+	const separator = options?.separator ?? "-";
+	return `${month}${separator}${day}${separator}${year}`;
+}
+/**
+* A utility function that formats a Date object into a string in the format "DD-MM-YYYY".
+*
+* @remarks
+* This function takes a Date object as input and returns a string representation of the date in the "DD-MM-YYYY" format.
+*
+* @example
+* ```ts
+* const date = new Date(2024, 0, 15); // January 15, 2024
+* const formattedDate = formatDDMMYYYY(date); // formattedDate will be "15-01-2024"
+* const formattedDateWithCustomSeparator = formatDDMMYYYY(date, { separator: "/" }); // formattedDateWithCustomSeparator will be "15/01/2024"
+* ```
+*
+* @param date - The Date object to be formatted.
+* @param options - Optional configuration for formatting the date, including a custom separator.
+* @returns A string representing the formatted date in "DD-MM-YYYY" format.
+*/
+function formatDDMMYYYY(date, options) {
+	const day = String(date.getDate()).padStart(2, "0");
+	const month = String(date.getMonth() + 1).padStart(2, "0");
+	const year = date.getFullYear();
+	const separator = options?.separator ?? "-";
+	return `${day}${separator}${month}${separator}${year}`;
+}
+/**
+* A utility function that formats a Date object into a string in the format "YYYY-MM-DD HH:mm:ss".
+*
+* @remarks
+* This function formats the date portion using the configured separator and appends
+* a time component in 24-hour format separated by spaces.
+*
+* @example
+* ```ts
+* const date = new Date(2024, 0, 15, 13, 45, 30);
+* const formattedDate = formatYYYYMMDDHHmmss(date); // formattedDate will be "2024-01-15 13:45:30"
+* ```
+*
+* @param date - The Date object to be formatted.
+* @param options - Optional configuration for formatting the date, including a custom separator.
+* @returns A string representing the formatted date in "YYYY-MM-DD HH:mm:ss" format.
+*/
+function formatYYYYMMDDHHmmss(date, options) {
+	const year = date.getFullYear();
+	const month = String(date.getMonth() + 1).padStart(2, "0");
+	const day = String(date.getDate()).padStart(2, "0");
+	const hours = String(date.getHours()).padStart(2, "0");
+	const minutes = String(date.getMinutes()).padStart(2, "0");
+	const seconds = String(date.getSeconds()).padStart(2, "0");
+	const separator = options?.separator ?? "-";
+	return `${year}${separator}${month}${separator}${day} ${hours}:${minutes}:${seconds}`;
+}
+/**
+* A utility function that formats a Date object into a string in the format "YYYY-MM-DDTHH:mm:ss".
+*
+* @remarks
+* This function formats the date portion using the configured separator and appends
+* a time component in 24-hour format separated by a "T" character.
+*
+* @example
+* ```ts
+* const date = new Date(2024, 0, 15, 13, 45, 30);
+* const formattedDate = formatYYYYMMDDTHHMMSS(date); // formattedDate will be "2024-01-15T13:45:30"
+* ```
+*
+* @param date - The Date object to be formatted.
+* @param options - Optional configuration for formatting the date, including a custom separator.
+* @returns A string representing the formatted date in "YYYY-MM-DDTHH:mm:ss" format.
+*/
+function formatYYYYMMDDTHHMMSS(date, options) {
+	const year = date.getFullYear();
+	const month = String(date.getMonth() + 1).padStart(2, "0");
+	const day = String(date.getDate()).padStart(2, "0");
+	const hours = String(date.getHours()).padStart(2, "0");
+	const minutes = String(date.getMinutes()).padStart(2, "0");
+	const seconds = String(date.getSeconds()).padStart(2, "0");
+	const separator = options?.separator ?? "-";
+	return `${year}${separator}${month}${separator}${day}T${hours}:${minutes}:${seconds}`;
+}
+/**
+* A utility function that formats a Date object into a string based on the specified format.
+*
+* @remarks
+* This function takes a Date object and a format string as input and returns a string representation of the date in the specified format. It also accepts optional configuration for customizing the separator used in the date string.
+*
+* @example
+* ```ts
+* const date = new Date(2024, 0, 15); // January 15, 2024
+* const formattedDate1 = formatDate(date, "YYYY-MM-DD"); // formattedDate1 will be "2024-01-15"
+* const formattedDate2 = formatDate(date, "MM-DD-YYYY"); // formattedDate2 will be "01-15-2024"
+* const formattedDate3 = formatDate(date, "DD-MM-YYYY"); // formattedDate3 will be "15-01-2024"
+* const formattedDate4 = formatDate(date, "YYYYMMDD"); // formattedDate4 will be "20240115"
+* const formattedDate5 = formatDate(date, "YYYY/MM/DD"); // formattedDate5 will be "2024/01/15"
+* const formattedDateWithCustomSeparator = formatDate(date, "YYYY-MM-DD", { separator: "/" }); // formattedDateWithCustomSeparator will be "2024/01/15"
+* ```
+*
+* @param date - The Date object to be formatted.
+* @param format - The desired format for the output string.
+* @param options - Optional configuration for formatting the date, including a custom separator.
+* @returns A string representing the formatted date in the specified format.
+* @throws Will throw an error if the specified format is not supported.
+*/
+function formatDate(date, format, options) {
+	switch (format) {
+		case "YYYY-MM-DD": return formatYYYYMMDD(date, options);
+		case "MM-DD-YYYY": return formatMMDDYYYY(date, options);
+		case "DD-MM-YYYY": return formatDDMMYYYY(date, options);
+		case "YYYY/MM/DD": return formatYYYYMMDD(date, {
+			separator: "/",
+			...options
+		});
+		case "MM/DD/YYYY": return formatMMDDYYYY(date, {
+			separator: "/",
+			...options
+		});
+		case "DD/MM/YYYY": return formatDDMMYYYY(date, {
+			separator: "/",
+			...options
+		});
+		case "YYYY.MM.DD": return formatYYYYMMDD(date, {
+			separator: ".",
+			...options
+		});
+		case "MM.DD.YYYY": return formatMMDDYYYY(date, {
+			separator: ".",
+			...options
+		});
+		case "DD.MM.YYYY": return formatDDMMYYYY(date, {
+			separator: ".",
+			...options
+		});
+		case "YYYYMMDD": return formatYYYYMMDD(date, {
+			separator: "",
+			...options
+		});
+		case "MMDDYYYY": return formatMMDDYYYY(date, {
+			separator: "",
+			...options
+		});
+		case "DDMMYYYY": return formatDDMMYYYY(date, {
+			separator: "",
+			...options
+		});
+		case "YYYY-MM-DD HH:mm:ss": return formatYYYYMMDDHHmmss(date, options);
+		case "YYYY-MM-DDTHH:mm:ss": return formatYYYYMMDDTHHMMSS(date, options);
+		default: throw new Error(`Unsupported date format: ${String(format)}`);
+	}
+}
+
+//#endregion
+export { formatDDMMYYYY, formatDate, formatMMDDYYYY, formatYYYYMMDD, formatYYYYMMDDHHmmss, formatYYYYMMDDTHHMMSS };
+//# sourceMappingURL=format.mjs.map

package/dist/format.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"format.mjs","names":[],"sources":["../src/format.ts"],"sourcesContent":["/* -------------------------------------------------------------------\n\n                       🗲 Storm Software - Stryke\n\n This code was released as part of the Stryke project. Stryke\n is maintained by Storm Software under the Apache-2.0 license, and is\n free for commercial and private use. For more information, please visit\n our licensing page at https://stormsoftware.com/licenses/projects/stryke.\n\n Website:                  https://stormsoftware.com\n Repository:               https://github.com/storm-software/stryke\n Documentation:            https://docs.stormsoftware.com/projects/stryke\n Contact:                  https://stormsoftware.com/contact\n\n SPDX-License-Identifier:  Apache-2.0\n\n ------------------------------------------------------------------- */\n\n// cspell:ignore YYYYMMDDTHHMMSS\n\nexport interface FormatDateOptions {\n  /**\n   * The separator to use between the year, month, and day components of the date.\n   *\n   * @remarks\n   * This option allows you to specify a custom separator character or string to be used when formatting the date. The default separator is a hyphen (\"-\").\n   *\n   * @example\n   * ```ts\n   * const date = new Date(2024, 0, 15); // January 15, 2024\n   * const formattedDate = formatYYYYMMDD(date, { separator: \"/\" }); // formattedDate will be \"2024/01/15\"\n   * ```\n   *\n   * @defaultValue \"-\"\n   */\n  separator?: string;\n}\n\n/**\n * A utility function that formats a Date object into a string in the format \"YYYY-MM-DD\".\n *\n * @remarks\n * This function takes a Date object as input and returns a string representation of the date in the \"YYYY-MM-DD\" format.\n *\n * @example\n * ```ts\n * const date = new Date(2024, 0, 15); // January 15, 2024\n * const formattedDate = formatYYYYMMDD(date); // formattedDate will be \"2024-01-15\"\n * const formattedDateWithCustomSeparator = formatYYYYMMDD(date, { separator: \"/\" }); // formattedDateWithCustomSeparator will be \"2024/01/15\"\n * ```\n *\n * @param date - The Date object to be formatted.\n * @param options - Optional configuration for formatting the date, including a custom separator.\n * @returns A string representing the formatted date in \"YYYY-MM-DD\" format.\n */\nexport function formatYYYYMMDD(\n  date: Date,\n  options?: FormatDateOptions\n): string {\n  const year = date.getFullYear();\n  const month = String(date.getMonth() + 1).padStart(2, \"0\");\n  const day = String(date.getDate()).padStart(2, \"0\");\n  const separator = options?.separator ?? \"-\";\n\n  return `${year}${separator}${month}${separator}${day}`;\n}\n\n/**\n * A utility function that formats a Date object into a string in the format \"MM-DD-YYYY\".\n *\n * @remarks\n * This function takes a Date object as input and returns a string representation of the date in the \"MM-DD-YYYY\" format.\n *\n * @example\n * ```ts\n * const date = new Date(2024, 0, 15); // January 15, 2024\n * const formattedDate = formatMMDDYYYY(date); // formattedDate will be \"01-15-2024\"\n * const formattedDateWithCustomSeparator = formatMMDDYYYY(date, { separator: \"/\" }); // formattedDateWithCustomSeparator will be \"01/15/2024\"\n * ```\n *\n * @param date - The Date object to be formatted.\n * @param options - Optional configuration for formatting the date, including a custom separator.\n * @returns A string representing the formatted date in \"MM-DD-YYYY\" format.\n */\nexport function formatMMDDYYYY(\n  date: Date,\n  options?: FormatDateOptions\n): string {\n  const month = String(date.getMonth() + 1).padStart(2, \"0\");\n  const day = String(date.getDate()).padStart(2, \"0\");\n  const year = date.getFullYear();\n  const separator = options?.separator ?? \"-\";\n\n  return `${month}${separator}${day}${separator}${year}`;\n}\n\n/**\n * A utility function that formats a Date object into a string in the format \"DD-MM-YYYY\".\n *\n * @remarks\n * This function takes a Date object as input and returns a string representation of the date in the \"DD-MM-YYYY\" format.\n *\n * @example\n * ```ts\n * const date = new Date(2024, 0, 15); // January 15, 2024\n * const formattedDate = formatDDMMYYYY(date); // formattedDate will be \"15-01-2024\"\n * const formattedDateWithCustomSeparator = formatDDMMYYYY(date, { separator: \"/\" }); // formattedDateWithCustomSeparator will be \"15/01/2024\"\n * ```\n *\n * @param date - The Date object to be formatted.\n * @param options - Optional configuration for formatting the date, including a custom separator.\n * @returns A string representing the formatted date in \"DD-MM-YYYY\" format.\n */\nexport function formatDDMMYYYY(\n  date: Date,\n  options?: FormatDateOptions\n): string {\n  const day = String(date.getDate()).padStart(2, \"0\");\n  const month = String(date.getMonth() + 1).padStart(2, \"0\");\n  const year = date.getFullYear();\n  const separator = options?.separator ?? \"-\";\n\n  return `${day}${separator}${month}${separator}${year}`;\n}\n\n/**\n * A utility function that formats a Date object into a string in the format \"YYYY-MM-DD HH:mm:ss\".\n *\n * @remarks\n * This function formats the date portion using the configured separator and appends\n * a time component in 24-hour format separated by spaces.\n *\n * @example\n * ```ts\n * const date = new Date(2024, 0, 15, 13, 45, 30);\n * const formattedDate = formatYYYYMMDDHHmmss(date); // formattedDate will be \"2024-01-15 13:45:30\"\n * ```\n *\n * @param date - The Date object to be formatted.\n * @param options - Optional configuration for formatting the date, including a custom separator.\n * @returns A string representing the formatted date in \"YYYY-MM-DD HH:mm:ss\" format.\n */\nexport function formatYYYYMMDDHHmmss(\n  date: Date,\n  options?: FormatDateOptions\n): string {\n  const year = date.getFullYear();\n  const month = String(date.getMonth() + 1).padStart(2, \"0\");\n  const day = String(date.getDate()).padStart(2, \"0\");\n  const hours = String(date.getHours()).padStart(2, \"0\");\n  const minutes = String(date.getMinutes()).padStart(2, \"0\");\n  const seconds = String(date.getSeconds()).padStart(2, \"0\");\n  const separator = options?.separator ?? \"-\";\n\n  return `${year}${separator}${month}${separator}${day} ${hours}:${minutes}:${seconds}`;\n}\n\n/**\n * A utility function that formats a Date object into a string in the format \"YYYY-MM-DDTHH:mm:ss\".\n *\n * @remarks\n * This function formats the date portion using the configured separator and appends\n * a time component in 24-hour format separated by a \"T\" character.\n *\n * @example\n * ```ts\n * const date = new Date(2024, 0, 15, 13, 45, 30);\n * const formattedDate = formatYYYYMMDDTHHMMSS(date); // formattedDate will be \"2024-01-15T13:45:30\"\n * ```\n *\n * @param date - The Date object to be formatted.\n * @param options - Optional configuration for formatting the date, including a custom separator.\n * @returns A string representing the formatted date in \"YYYY-MM-DDTHH:mm:ss\" format.\n */\nexport function formatYYYYMMDDTHHMMSS(\n  date: Date,\n  options?: FormatDateOptions\n): string {\n  const year = date.getFullYear();\n  const month = String(date.getMonth() + 1).padStart(2, \"0\");\n  const day = String(date.getDate()).padStart(2, \"0\");\n  const hours = String(date.getHours()).padStart(2, \"0\");\n  const minutes = String(date.getMinutes()).padStart(2, \"0\");\n  const seconds = String(date.getSeconds()).padStart(2, \"0\");\n  const separator = options?.separator ?? \"-\";\n\n  return `${year}${separator}${month}${separator}${day}T${hours}:${minutes}:${seconds}`;\n}\n\n/**\n * A utility function that formats a Date object into a string based on the specified format.\n *\n * @remarks\n * This function takes a Date object and a format string as input and returns a string representation of the date in the specified format. It also accepts optional configuration for customizing the separator used in the date string.\n *\n * @example\n * ```ts\n * const date = new Date(2024, 0, 15); // January 15, 2024\n * const formattedDate1 = formatDate(date, \"YYYY-MM-DD\"); // formattedDate1 will be \"2024-01-15\"\n * const formattedDate2 = formatDate(date, \"MM-DD-YYYY\"); // formattedDate2 will be \"01-15-2024\"\n * const formattedDate3 = formatDate(date, \"DD-MM-YYYY\"); // formattedDate3 will be \"15-01-2024\"\n * const formattedDate4 = formatDate(date, \"YYYYMMDD\"); // formattedDate4 will be \"20240115\"\n * const formattedDate5 = formatDate(date, \"YYYY/MM/DD\"); // formattedDate5 will be \"2024/01/15\"\n * const formattedDateWithCustomSeparator = formatDate(date, \"YYYY-MM-DD\", { separator: \"/\" }); // formattedDateWithCustomSeparator will be \"2024/01/15\"\n * ```\n *\n * @param date - The Date object to be formatted.\n * @param format - The desired format for the output string.\n * @param options - Optional configuration for formatting the date, including a custom separator.\n * @returns A string representing the formatted date in the specified format.\n * @throws Will throw an error if the specified format is not supported.\n */\nexport function formatDate(\n  date: Date,\n  format:\n    | \"YYYY-MM-DD\"\n    | \"MM-DD-YYYY\"\n    | \"DD-MM-YYYY\"\n    | \"YYYY/MM/DD\"\n    | \"MM/DD/YYYY\"\n    | \"DD/MM/YYYY\"\n    | \"YYYY.MM.DD\"\n    | \"MM.DD.YYYY\"\n    | \"DD.MM.YYYY\"\n    | \"YYYYMMDD\"\n    | \"MMDDYYYY\"\n    | \"DDMMYYYY\"\n    | \"YYYY-MM-DD HH:mm:ss\"\n    | \"YYYY-MM-DDTHH:mm:ss\",\n  options?: FormatDateOptions\n): string {\n  switch (format) {\n    case \"YYYY-MM-DD\":\n      return formatYYYYMMDD(date, options);\n    case \"MM-DD-YYYY\":\n      return formatMMDDYYYY(date, options);\n    case \"DD-MM-YYYY\":\n      return formatDDMMYYYY(date, options);\n    case \"YYYY/MM/DD\":\n      return formatYYYYMMDD(date, { separator: \"/\", ...options });\n    case \"MM/DD/YYYY\":\n      return formatMMDDYYYY(date, { separator: \"/\", ...options });\n    case \"DD/MM/YYYY\":\n      return formatDDMMYYYY(date, { separator: \"/\", ...options });\n    case \"YYYY.MM.DD\":\n      return formatYYYYMMDD(date, { separator: \".\", ...options });\n    case \"MM.DD.YYYY\":\n      return formatMMDDYYYY(date, { separator: \".\", ...options });\n    case \"DD.MM.YYYY\":\n      return formatDDMMYYYY(date, { separator: \".\", ...options });\n    case \"YYYYMMDD\":\n      return formatYYYYMMDD(date, { separator: \"\", ...options });\n    case \"MMDDYYYY\":\n      return formatMMDDYYYY(date, { separator: \"\", ...options });\n    case \"DDMMYYYY\":\n      return formatDDMMYYYY(date, { separator: \"\", ...options });\n    case \"YYYY-MM-DD HH:mm:ss\":\n      return formatYYYYMMDDHHmmss(date, options);\n    case \"YYYY-MM-DDTHH:mm:ss\":\n      return formatYYYYMMDDTHHMMSS(date, options);\n    default:\n      throw new Error(`Unsupported date format: ${String(format)}`);\n  }\n}\n"],"mappings":"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"}

package/dist/index.cjs

@@ -0,0 +1,12 @@
+Object.defineProperty(exports, Symbol.toStringTag, { value: 'Module' });
+const require_format = require('./format.cjs');
+const require_validate = require('./validate.cjs');
+
+exports.formatDDMMYYYY = require_format.formatDDMMYYYY;
+exports.formatDate = require_format.formatDate;
+exports.formatMMDDYYYY = require_format.formatMMDDYYYY;
+exports.formatYYYYMMDD = require_format.formatYYYYMMDD;
+exports.formatYYYYMMDDHHmmss = require_format.formatYYYYMMDDHHmmss;
+exports.formatYYYYMMDDTHHMMSS = require_format.formatYYYYMMDDTHHMMSS;
+exports.isValidDateString = require_validate.isValidDateString;
+exports.isValidTimestamp = require_validate.isValidTimestamp;

package/dist/index.d.cts

@@ -0,0 +1,3 @@
+import { FormatDateOptions, formatDDMMYYYY, formatDate, formatMMDDYYYY, formatYYYYMMDD, formatYYYYMMDDHHmmss, formatYYYYMMDDTHHMMSS } from "./format.cjs";
+import { isValidDateString, isValidTimestamp } from "./validate.cjs";
+export { FormatDateOptions, formatDDMMYYYY, formatDate, formatMMDDYYYY, formatYYYYMMDD, formatYYYYMMDDHHmmss, formatYYYYMMDDTHHMMSS, isValidDateString, isValidTimestamp };

package/dist/index.d.mts

@@ -0,0 +1,3 @@
+import { FormatDateOptions, formatDDMMYYYY, formatDate, formatMMDDYYYY, formatYYYYMMDD, formatYYYYMMDDHHmmss, formatYYYYMMDDTHHMMSS } from "./format.mjs";
+import { isValidDateString, isValidTimestamp } from "./validate.mjs";
+export { FormatDateOptions, formatDDMMYYYY, formatDate, formatMMDDYYYY, formatYYYYMMDD, formatYYYYMMDDHHmmss, formatYYYYMMDDTHHMMSS, isValidDateString, isValidTimestamp };

package/dist/index.mjs

@@ -0,0 +1,4 @@
+import { formatDDMMYYYY, formatDate, formatMMDDYYYY, formatYYYYMMDD, formatYYYYMMDDHHmmss, formatYYYYMMDDTHHMMSS } from "./format.mjs";
+import { isValidDateString, isValidTimestamp } from "./validate.mjs";
+
+export { formatDDMMYYYY, formatDate, formatMMDDYYYY, formatYYYYMMDD, formatYYYYMMDDHHmmss, formatYYYYMMDDTHHMMSS, isValidDateString, isValidTimestamp };

package/dist/validate.cjs

@@ -0,0 +1,44 @@
+Object.defineProperty(exports, Symbol.toStringTag, { value: 'Module' });
+
+//#region src/validate.ts
+/**
+* Validates if a given timestamp is a valid Unix timestamp.
+*
+* @remarks
+* A valid Unix timestamp is a non-negative integer that represents the number of seconds since January 1, 1970 (the Unix epoch).
+*
+* @example
+* ```ts
+* isValidTimestamp(1700000000); // true
+* isValidTimestamp(-100); // false
+* isValidTimestamp(3.14); // false
+* ```
+*
+* @param timestamp - The timestamp to validate.
+* @returns `true` if the timestamp is valid, `false` otherwise.
+*/
+function isValidTimestamp(timestamp) {
+	return Number.isInteger(timestamp) && timestamp >= 0;
+}
+/**
+* Validates if a given date string is a valid date.
+*
+* @remarks
+* A valid date string is one that can be parsed into a valid JavaScript `Date` object.
+*
+* @example
+* ```ts
+* isValidDateString("2024-01-15"); // true
+* isValidDateString("invalid-date"); // false
+* ```
+*
+* @param date - The date string to validate.
+* @returns `true` if the date string is valid, `false` otherwise.
+*/
+function isValidDateString(date) {
+	return !Number.isNaN(new Date(date).getTime());
+}
+
+//#endregion
+exports.isValidDateString = isValidDateString;
+exports.isValidTimestamp = isValidTimestamp;

package/dist/validate.d.cts

@@ -0,0 +1,37 @@
+//#region src/validate.d.ts
+/**
+ * Validates if a given timestamp is a valid Unix timestamp.
+ *
+ * @remarks
+ * A valid Unix timestamp is a non-negative integer that represents the number of seconds since January 1, 1970 (the Unix epoch).
+ *
+ * @example
+ * ```ts
+ * isValidTimestamp(1700000000); // true
+ * isValidTimestamp(-100); // false
+ * isValidTimestamp(3.14); // false
+ * ```
+ *
+ * @param timestamp - The timestamp to validate.
+ * @returns `true` if the timestamp is valid, `false` otherwise.
+ */
+declare function isValidTimestamp(timestamp: number): boolean;
+/**
+ * Validates if a given date string is a valid date.
+ *
+ * @remarks
+ * A valid date string is one that can be parsed into a valid JavaScript `Date` object.
+ *
+ * @example
+ * ```ts
+ * isValidDateString("2024-01-15"); // true
+ * isValidDateString("invalid-date"); // false
+ * ```
+ *
+ * @param date - The date string to validate.
+ * @returns `true` if the date string is valid, `false` otherwise.
+ */
+declare function isValidDateString(date: string): boolean;
+//#endregion
+export { isValidDateString, isValidTimestamp };
+//# sourceMappingURL=validate.d.cts.map

package/dist/validate.d.cts.map

@@ -0,0 +1 @@
+{"version":3,"file":"validate.d.cts","names":[],"sources":["../src/validate.ts"],"mappings":";;AAkCA;;;;;AAmBA;;;;;;;;;;iBAnBgB,gBAAA,CAAiB,SAAA;;;;;;;;;;;;;;;;iBAmBjB,iBAAA,CAAkB,IAAA"}

package/dist/validate.d.mts

@@ -0,0 +1,37 @@
+//#region src/validate.d.ts
+/**
+ * Validates if a given timestamp is a valid Unix timestamp.
+ *
+ * @remarks
+ * A valid Unix timestamp is a non-negative integer that represents the number of seconds since January 1, 1970 (the Unix epoch).
+ *
+ * @example
+ * ```ts
+ * isValidTimestamp(1700000000); // true
+ * isValidTimestamp(-100); // false
+ * isValidTimestamp(3.14); // false
+ * ```
+ *
+ * @param timestamp - The timestamp to validate.
+ * @returns `true` if the timestamp is valid, `false` otherwise.
+ */
+declare function isValidTimestamp(timestamp: number): boolean;
+/**
+ * Validates if a given date string is a valid date.
+ *
+ * @remarks
+ * A valid date string is one that can be parsed into a valid JavaScript `Date` object.
+ *
+ * @example
+ * ```ts
+ * isValidDateString("2024-01-15"); // true
+ * isValidDateString("invalid-date"); // false
+ * ```
+ *
+ * @param date - The date string to validate.
+ * @returns `true` if the date string is valid, `false` otherwise.
+ */
+declare function isValidDateString(date: string): boolean;
+//#endregion
+export { isValidDateString, isValidTimestamp };
+//# sourceMappingURL=validate.d.mts.map

package/dist/validate.d.mts.map

@@ -0,0 +1 @@
+{"version":3,"file":"validate.d.mts","names":[],"sources":["../src/validate.ts"],"mappings":";;AAkCA;;;;;AAmBA;;;;;;;;;;iBAnBgB,gBAAA,CAAiB,SAAA;;;;;;;;;;;;;;;;iBAmBjB,iBAAA,CAAkB,IAAA"}

package/dist/validate.mjs

@@ -0,0 +1,42 @@
+//#region src/validate.ts
+/**
+* Validates if a given timestamp is a valid Unix timestamp.
+*
+* @remarks
+* A valid Unix timestamp is a non-negative integer that represents the number of seconds since January 1, 1970 (the Unix epoch).
+*
+* @example
+* ```ts
+* isValidTimestamp(1700000000); // true
+* isValidTimestamp(-100); // false
+* isValidTimestamp(3.14); // false
+* ```
+*
+* @param timestamp - The timestamp to validate.
+* @returns `true` if the timestamp is valid, `false` otherwise.
+*/
+function isValidTimestamp(timestamp) {
+	return Number.isInteger(timestamp) && timestamp >= 0;
+}
+/**
+* Validates if a given date string is a valid date.
+*
+* @remarks
+* A valid date string is one that can be parsed into a valid JavaScript `Date` object.
+*
+* @example
+* ```ts
+* isValidDateString("2024-01-15"); // true
+* isValidDateString("invalid-date"); // false
+* ```
+*
+* @param date - The date string to validate.
+* @returns `true` if the date string is valid, `false` otherwise.
+*/
+function isValidDateString(date) {
+	return !Number.isNaN(new Date(date).getTime());
+}
+
+//#endregion
+export { isValidDateString, isValidTimestamp };
+//# sourceMappingURL=validate.mjs.map

package/dist/validate.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"validate.mjs","names":[],"sources":["../src/validate.ts"],"sourcesContent":["/* -------------------------------------------------------------------\n\n                       🗲 Storm Software - Stryke\n\n This code was released as part of the Stryke project. Stryke\n is maintained by Storm Software under the Apache-2.0 license, and is\n free for commercial and private use. For more information, please visit\n our licensing page at https://stormsoftware.com/licenses/projects/stryke.\n\n Website:                  https://stormsoftware.com\n Repository:               https://github.com/storm-software/stryke\n Documentation:            https://docs.stormsoftware.com/projects/stryke\n Contact:                  https://stormsoftware.com/contact\n\n SPDX-License-Identifier:  Apache-2.0\n\n ------------------------------------------------------------------- */\n\n/**\n * Validates if a given timestamp is a valid Unix timestamp.\n *\n * @remarks\n * A valid Unix timestamp is a non-negative integer that represents the number of seconds since January 1, 1970 (the Unix epoch).\n *\n * @example\n * ```ts\n * isValidTimestamp(1700000000); // true\n * isValidTimestamp(-100); // false\n * isValidTimestamp(3.14); // false\n * ```\n *\n * @param timestamp - The timestamp to validate.\n * @returns `true` if the timestamp is valid, `false` otherwise.\n */\nexport function isValidTimestamp(timestamp: number): boolean {\n  return Number.isInteger(timestamp) && timestamp >= 0;\n}\n\n/**\n * Validates if a given date string is a valid date.\n *\n * @remarks\n * A valid date string is one that can be parsed into a valid JavaScript `Date` object.\n *\n * @example\n * ```ts\n * isValidDateString(\"2024-01-15\"); // true\n * isValidDateString(\"invalid-date\"); // false\n * ```\n *\n * @param date - The date string to validate.\n * @returns `true` if the date string is valid, `false` otherwise.\n */\nexport function isValidDateString(date: string): boolean {\n  return !Number.isNaN(new Date(date).getTime());\n}\n"],"mappings":";;;;;;;;;;;;;;;;;AAkCA,SAAgB,iBAAiB,WAA4B;AAC3D,QAAO,OAAO,UAAU,UAAU,IAAI,aAAa;;;;;;;;;;;;;;;;;AAkBrD,SAAgB,kBAAkB,MAAuB;AACvD,QAAO,CAAC,OAAO,MAAM,IAAI,KAAK,KAAK,CAAC,SAAS,CAAC"}

package/package.json

@@ -0,0 +1,30 @@
+{
+  "name": "@stryke/date",
+  "version": "0.0.2",
+  "private": false,
+  "description": "A utility package that helps with date manipulation and formatting.",
+  "repository": {
+    "type": "github",
+    "url": "https://github.com/storm-software/stryke.git",
+    "directory": "packages/date"
+  },
+  "type": "module",
+  "exports": {
+    ".": { "import": "./dist/index.mjs", "require": "./dist/index.cjs" },
+    "./format": {
+      "import": "./dist/format.mjs",
+      "require": "./dist/format.cjs"
+    },
+    "./validate": {
+      "import": "./dist/validate.mjs",
+      "require": "./dist/validate.cjs"
+    },
+    "./package.json": "./package.json"
+  },
+  "main": "./dist/index.cjs",
+  "module": "./dist/index.mjs",
+  "types": "./dist/index.d.cts",
+  "devDependencies": { "@types/node": "^24.13.2", "tsdown": "^0.21.10" },
+  "publishConfig": { "access": "public" },
+  "gitHead": "3dcaa5327786a7939dba470d7cc24d773d2a95f5"
+}