chronos-date 1.0.1 → 1.1.0

package/dist/types.mjs

@@ -1 +1 @@
-export{};
+export {  };

package/dist/utilities-BU4MSYS7.mjs

@@ -0,0 +1,43 @@
+import { i as isString, r as isNumber } from "./primitives-DEt6I7Sy.mjs";
+
+//#region node_modules/.pnpm/nhb-toolbox@4.30.1/node_modules/nhb-toolbox/dist/esm/guards/specials.js
+function isNumericString(value) {
+	return isString(value) && value?.trim() !== "" && Number.isFinite(Number(value));
+}
+
+//#endregion
+//#region node_modules/.pnpm/nhb-toolbox@4.30.1/node_modules/nhb-toolbox/dist/esm/number/constants.js
+const BN_DIGITS = /* @__PURE__ */ Object.freeze({
+	"০": 0,
+	"১": 1,
+	"২": 2,
+	"৩": 3,
+	"৪": 4,
+	"৫": 5,
+	"৬": 6,
+	"৭": 7,
+	"৮": 8,
+	"৯": 9
+});
+
+//#endregion
+//#region node_modules/.pnpm/nhb-toolbox@4.30.1/node_modules/nhb-toolbox/dist/esm/number/utilities.js
+const roundToNearest = (value, interval = 5) => {
+	return Math.round(Number(value) / interval) * interval;
+};
+const getOrdinal = (num, withNumber = true) => {
+	const remainder10 = Number(num) % 10;
+	const remainder100 = Number(num) % 100;
+	let suffix;
+	if (remainder10 === 1 && remainder100 !== 11) suffix = "st";
+	else if (remainder10 === 2 && remainder100 !== 12) suffix = "nd";
+	else if (remainder10 === 3 && remainder100 !== 13) suffix = "rd";
+	else suffix = "th";
+	return withNumber ? String(num).concat(suffix) : suffix;
+};
+function normalizeNumber(num) {
+	return isNumber(num) ? num : isNumericString(num) ? Number(num) : void 0;
+}
+
+//#endregion
+export { isNumericString as a, BN_DIGITS as i, normalizeNumber as n, roundToNearest as r, getOrdinal as t };

package/dist/utilities-CGL7F6R9.cjs

@@ -0,0 +1,72 @@
+const require_primitives = require('./primitives-BME3_QrA.cjs');
+
+//#region node_modules/.pnpm/nhb-toolbox@4.30.1/node_modules/nhb-toolbox/dist/esm/guards/specials.js
+function isNumericString(value) {
+	return require_primitives.isString(value) && value?.trim() !== "" && Number.isFinite(Number(value));
+}
+
+//#endregion
+//#region node_modules/.pnpm/nhb-toolbox@4.30.1/node_modules/nhb-toolbox/dist/esm/number/constants.js
+const BN_DIGITS = /* @__PURE__ */ Object.freeze({
+	"০": 0,
+	"১": 1,
+	"২": 2,
+	"৩": 3,
+	"৪": 4,
+	"৫": 5,
+	"৬": 6,
+	"৭": 7,
+	"৮": 8,
+	"৯": 9
+});
+
+//#endregion
+//#region node_modules/.pnpm/nhb-toolbox@4.30.1/node_modules/nhb-toolbox/dist/esm/number/utilities.js
+const roundToNearest = (value, interval = 5) => {
+	return Math.round(Number(value) / interval) * interval;
+};
+const getOrdinal = (num, withNumber = true) => {
+	const remainder10 = Number(num) % 10;
+	const remainder100 = Number(num) % 100;
+	let suffix;
+	if (remainder10 === 1 && remainder100 !== 11) suffix = "st";
+	else if (remainder10 === 2 && remainder100 !== 12) suffix = "nd";
+	else if (remainder10 === 3 && remainder100 !== 13) suffix = "rd";
+	else suffix = "th";
+	return withNumber ? String(num).concat(suffix) : suffix;
+};
+function normalizeNumber(num) {
+	return require_primitives.isNumber(num) ? num : isNumericString(num) ? Number(num) : void 0;
+}
+
+//#endregion
+Object.defineProperty(exports, 'BN_DIGITS', {
+  enumerable: true,
+  get: function () {
+    return BN_DIGITS;
+  }
+});
+Object.defineProperty(exports, 'getOrdinal', {
+  enumerable: true,
+  get: function () {
+    return getOrdinal;
+  }
+});
+Object.defineProperty(exports, 'isNumericString', {
+  enumerable: true,
+  get: function () {
+    return isNumericString;
+  }
+});
+Object.defineProperty(exports, 'normalizeNumber', {
+  enumerable: true,
+  get: function () {
+    return normalizeNumber;
+  }
+});
+Object.defineProperty(exports, 'roundToNearest', {
+  enumerable: true,
+  get: function () {
+    return roundToNearest;
+  }
+});

package/dist/utilities-CtOZhIYv.mjs

@@ -0,0 +1,241 @@
+import { n as NATIVE_TZ_IDS } from "./timezone-BfBXeMK_.mjs";
+import { a as isUndefined } from "./primitives-DEt6I7Sy.mjs";
+import { r as isObject } from "./non-primitives-DrQfPj1r.mjs";
+import { n as normalizeNumber } from "./utilities-BU4MSYS7.mjs";
+import { isValidUTCOffset } from "./guards.mjs";
+import { n as _dateArgsToDate, p as _resolveNativeTzName, r as _formatDate, s as _gmtToUtcOffset, u as _normalizeOffset } from "./helpers-CrMc9iJZ.mjs";
+
+//#region src/utils/utilities.ts
+/**
+* * Extracts the hour and minute from a time string in `HH:MM` or `-HH:MM` format.
+*
+* @param time - The time string to extract from.
+* @return The extracted hour and minute as number tuple.
+*/
+function extractHourMinute(time) {
+	const [hour, minute] = time.split(":").map(Number);
+	return [hour, minute];
+}
+/**
+* * Converts a time string `HH:MM` or `-HH:MM` into total minutes from `00:00`.
+*
+* @param time - The time in `HH:MM` or `-HH:MM` format.
+* @returns The total minutes elapsed since `00:00`.
+*/
+function getTotalMinutes(time) {
+	const isNegative = time.startsWith("-");
+	const [h, m] = extractHourMinute(isNegative ? time.slice(1) : time);
+	const total = h * 60 + m;
+	return isNegative ? -total : total;
+}
+/**
+* * Extract Time in `HH:MM` format from given UTC value.
+*
+* @param utc UTC value in `UTC-01:30` or `UTC+01:30` format.
+* @returns The UTC value in `HH:MM` format.
+*/
+function extractTimeFromUTC(utc) {
+	return utc.replace(/^UTC[+]?/g, "");
+}
+/**
+* * Converts a UTC value in `UTC-01:30` or `UTC+01:30` format into total minutes in number.
+*
+* @param time - UTC value in `UTC-01:30` or `UTC+01:30` format.
+* @returns The total minutes elapsed since `00:00`.
+*/
+function extractMinutesFromUTC(utc) {
+	return getTotalMinutes(extractTimeFromUTC(utc));
+}
+/**
+* * Converts a number of minutes into a time string in "HH:MM" format.
+*
+* @param minutes - The number of minutes to convert. Can be a number or a numeric string.
+* @returns A string representing the time in "HH:MM" format.
+*
+* @remarks Always returns the absolute value of the minutes, ignoring the sign if they are negative.
+*
+* @example
+* convertMinutesToTime(75); // "1:15"
+* convertMinutesToTime(-45); // "0:45"
+*/
+function convertMinutesToTime(minutes) {
+	const parsed = normalizeNumber(minutes);
+	if (isUndefined(parsed)) throw new TypeError(`Invalid numeric input!`, { cause: `${minutes} cannot be converted to a number.` });
+	const numMIn = Math.abs(parsed);
+	return `${String(Math.floor(numMIn / 60))}:${String(numMIn % 60).padStart(2, "0")}`;
+}
+/**
+* * Converts a minute-based offset to a UTC offset string in the format `UTC±HH:MM`.
+*
+* @param minutes - The offset in minutes (positive or negative).
+* @returns A formatted UTC offset string like `UTC+05:30` or `UTC-04:00`.
+*/
+function formatUTCOffset(minutes) {
+	const parsed = normalizeNumber(minutes);
+	if (isUndefined(parsed)) throw new TypeError(`Invalid numeric input!`, { cause: `${minutes} cannot be converted to a number.` });
+	const sign = parsed < 0 ? "-" : "+";
+	const abs = Math.abs(parsed);
+	return `UTC${sign}${String(Math.floor(abs / 60)).padStart(2, "0")}:${String(abs % 60).padStart(2, "0")}`;
+}
+/** Get the current system's time zone identifier using {@link Intl.DateTimeFormat} API. */
+function getNativeTimeZoneId() {
+	return Intl.DateTimeFormat().resolvedOptions().timeZone;
+}
+/**
+* * Retrieves comprehensive time zone details using the {@link Intl.DateTimeFormat} API.
+* @param tzId Optional timezone identifier. Defaults to the system timezone.
+* @param date Optional date for which to resolve the information.
+* @returns Object containing time zone identifier, names, and offset.
+*/
+function getTimeZoneDetails(tzId, date) {
+	const TZ_NAME_TYPES = [
+		"long",
+		"longGeneric",
+		"longOffset"
+	];
+	const $tzId = tzId || getNativeTimeZoneId();
+	const obj = { tzIdentifier: $tzId };
+	for (const type of TZ_NAME_TYPES) {
+		const key = `tzName${type[0].toUpperCase()}${type.slice(1)}`;
+		obj[key] = _resolveNativeTzName($tzId, type, date);
+	}
+	return obj;
+}
+/** Cache for offset to time zone */
+const TZ_MAP = /* @__PURE__ */ new Map();
+/**
+* * Resolves all IANA time-zone identifiers that match a given UTC offset.
+*
+* @remarks
+* - Uses an internal in-memory cache that persists for the lifetime of the running application.
+* - The cache is lazily populated so the `offset`-to-`time-zone` mapping is computed only once per offset.
+* - Offset and time-zone identifier detection uses the {@link Intl.DateTimeFormat} API.
+*
+* @param offset The UTC offset in `"UTC±HH:MM"` format.
+* @returns An array of matching IANA time-zone identifiers, or an empty array if the offset is invalid.
+*/
+function getTimeZoneIds(offset) {
+	if (!isValidUTCOffset(offset)) return [];
+	if (TZ_MAP.has(offset)) return TZ_MAP.get(offset) ?? [];
+	for (const zone of NATIVE_TZ_IDS) {
+		const off = _gmtToUtcOffset(_resolveNativeTzName(zone, "longOffset"));
+		if (off) TZ_MAP.set(off, [...TZ_MAP.get(off) ?? [], zone]);
+	}
+	return TZ_MAP.get(offset) ?? [];
+}
+/**
+* * Formats a date into a specified string format.
+*
+* @param options Options to control date and time formatting.
+*
+* @remarks
+* - If no date is provided, the current date and time will be used.
+* - If the provided date is invalid, the function will return `'Invalid Date!'`.
+* - The default format is `'dd, mmm DD, YYYY HH:mm:ss'` (e.g., `'Sun, Apr 06, 2025 16:11:55'`).
+* - By default, local time is used; set `useUTC` to `true` to format in UTC.
+* - The format string supports various tokens for date and time components, as well as literal text enclosed in square brackets.
+* - See {@link https://toolbox.nazmul-nhb.dev/docs/utilities/date/formatDate#format-tokens format tokens} for details on supported tokens.
+* - For more complex date/time manipulations, consider using the {@link https://toolbox.nazmul-nhb.dev/docs/classes/Chronos Chronos} class.
+*
+* @returns Date/time string in specified format.
+*/
+function formatDate(options) {
+	const { date = /* @__PURE__ */ new Date(), format = "dd, mmm DD, YYYY HH:mm:ss", useUTC = false } = options ?? {};
+	const $date = _dateArgsToDate(date);
+	if (isNaN($date.getTime())) return "Invalid Date!";
+	/** Get unit value for {@link $date} for specific unit in local or UTC time */
+	const _getUnitValue = (suffix) => {
+		return useUTC ? $date[`getUTC${suffix}`]() : $date[`get${suffix}`]();
+	};
+	return _formatDate(format, _getUnitValue("FullYear"), _getUnitValue("Month"), _getUnitValue("Day"), _getUnitValue("Date"), _getUnitValue("Hours"), _getUnitValue("Minutes"), _getUnitValue("Seconds"), _getUnitValue("Milliseconds"), useUTC ? "Z" : formatUTCOffset(-$date.getTimezoneOffset()).slice(3));
+}
+/**
+* * Formats a time-only string into a formatted time string.
+*
+* @param time - Time string to be formatted. Supported formats include:
+* - `HH:mm` → e.g., `'14:50'`
+* - `HH:mm:ss` → e.g., `'14:50:00'`
+* - `HH:mm:ss.mss` → e.g., `'14:50:00.800'`
+* - `HH:mm+TimeZoneOffset(HH)` → e.g., `'14:50+06'`
+* - `HH:mm+TimeZoneOffset(HH:mm)` → e.g., `'14:50+06:00'`
+* - `HH:mm:ss+TimeZoneOffset(HH)` → e.g., `'14:50:00+06'`
+* - `HH:mm:ss+TimeZoneOffset(HH:mm)` → e.g., `'14:50:00+05:30'`
+* - `HH:mm:ss.mss+TimeZoneOffset(HH)` → e.g., `'14:50:00.800+06'`
+* - `HH:mm:ss.mss+TimeZoneOffset(HH:mm)` → e.g., `'14:50:00.800+06:30'`
+*
+* - *Input will default to today's date and assume local timezone if no offset is provided.*
+*
+* @param format - Format tokens accepted by {@link formatDate} method ({@link TimeOnlyFormat}) for time part only.
+*                 Default: `hh:mm:ss a` → 02:33:36 pm.
+* @returns Formatted time string in local (System) time.
+*/
+function formatTimePart(time, format) {
+	return formatDate({
+		date: `${formatDate({ format: "YYYY-MM-DD" })}T${_normalizeOffset(time)}`,
+		format: format || "hh:mm:ss a"
+	});
+}
+/**
+* * Formats a date as a relative time string (e.g., "5m ago", "2h from now").
+*
+* @param date - The date to format, which can be a `Date` object, a date string, or a timestamp number.
+* @param format - Optional format string for dates older than 7 days. Defaults to `'mmm D, yyyy hh:mm a'`.
+* @returns A relative time string if the date is within the last 7 days, otherwise a formatted date string.
+*
+* @remarks
+* - If date is provided but `undefined`, current date and time will be used.
+* - If the provided date is invalid, the function will return `'Invalid Date!'`.
+* - For dates within the last 7 days, the output will be in the format of "Xm ago" or "Xh from now".
+* - For dates older than 7 days, the output will be formatted using the provided `format` string or the default format if none is provided.
+*
+* @example
+* formatDateRelative(Date.now() - 5 * 60000); // "5m ago"
+* formatDateRelative(Date.now() + 2 * 3600000); // "2h from now"
+* formatDateRelative(Date.now() - 10 * 86400000); // "Apr 6, 2026 04:11 PM" (formatted date string)
+*/
+function formatDateRelative(date, format) {
+	const $date = _dateArgsToDate(date);
+	if (isNaN($date.getTime())) return "Invalid Date!";
+	const now = Date.now();
+	const then = $date.getTime();
+	const diff = Math.abs(now - then);
+	const minutes = Math.floor(diff / 6e4);
+	const hours = Math.floor(diff / 36e5);
+	const days = Math.floor(diff / 864e5);
+	const suffix = then < now ? "ago" : "from now";
+	if (minutes < 1) return "Just now";
+	if (minutes < 60) return `${minutes}m ${suffix}`;
+	if (hours < 24) return `${hours}h ${suffix}`;
+	if (days < 7) return `${days}d ${suffix}`;
+	return formatDate({
+		date,
+		format: format || "mmm D, yyyy hh:mm a"
+	});
+}
+/** Get timestamp in ISO 8601 format. */
+function getTimestamp(args, format) {
+	let $value;
+	let $format;
+	const _isTsOptions = (opt) => {
+		return isObject(opt) && ("value" in opt || "format" in opt);
+	};
+	if (_isTsOptions(args)) {
+		$value = args.value || /* @__PURE__ */ new Date();
+		$format = args.format || "utc";
+	} else {
+		$value = args || /* @__PURE__ */ new Date();
+		$format = format || "utc";
+	}
+	let date = _dateArgsToDate($value);
+	if (isNaN(date.getTime())) date = /* @__PURE__ */ new Date();
+	if ($format === "local") {
+		const offsetMins = date.getTimezoneOffset();
+		const localDate = /* @__PURE__ */ new Date(date.getTime() - offsetMins * 6e4);
+		const offset = formatUTCOffset(-offsetMins).slice(3);
+		return localDate.toISOString().replace("Z", offset);
+	}
+	return date.toISOString();
+}
+
+//#endregion
+export { formatDate as a, formatUTCOffset as c, getTimeZoneIds as d, getTimestamp as f, extractTimeFromUTC as i, getNativeTimeZoneId as l, extractHourMinute as n, formatDateRelative as o, getTotalMinutes as p, extractMinutesFromUTC as r, formatTimePart as s, convertMinutesToTime as t, getTimeZoneDetails as u };

package/dist/utilities-bXwTPJaD.cjs

@@ -0,0 +1,318 @@
+const require_timezone = require('./timezone-DYVJJYKz.cjs');
+const require_primitives = require('./primitives-BME3_QrA.cjs');
+const require_non_primitives = require('./non-primitives-CT4vszrX.cjs');
+const require_utilities = require('./utilities-CGL7F6R9.cjs');
+const require_guards = require('./guards.cjs');
+const require_helpers = require('./helpers-M_SfAbAv.cjs');
+
+//#region src/utils/utilities.ts
+/**
+* * Extracts the hour and minute from a time string in `HH:MM` or `-HH:MM` format.
+*
+* @param time - The time string to extract from.
+* @return The extracted hour and minute as number tuple.
+*/
+function extractHourMinute(time) {
+	const [hour, minute] = time.split(":").map(Number);
+	return [hour, minute];
+}
+/**
+* * Converts a time string `HH:MM` or `-HH:MM` into total minutes from `00:00`.
+*
+* @param time - The time in `HH:MM` or `-HH:MM` format.
+* @returns The total minutes elapsed since `00:00`.
+*/
+function getTotalMinutes(time) {
+	const isNegative = time.startsWith("-");
+	const [h, m] = extractHourMinute(isNegative ? time.slice(1) : time);
+	const total = h * 60 + m;
+	return isNegative ? -total : total;
+}
+/**
+* * Extract Time in `HH:MM` format from given UTC value.
+*
+* @param utc UTC value in `UTC-01:30` or `UTC+01:30` format.
+* @returns The UTC value in `HH:MM` format.
+*/
+function extractTimeFromUTC(utc) {
+	return utc.replace(/^UTC[+]?/g, "");
+}
+/**
+* * Converts a UTC value in `UTC-01:30` or `UTC+01:30` format into total minutes in number.
+*
+* @param time - UTC value in `UTC-01:30` or `UTC+01:30` format.
+* @returns The total minutes elapsed since `00:00`.
+*/
+function extractMinutesFromUTC(utc) {
+	return getTotalMinutes(extractTimeFromUTC(utc));
+}
+/**
+* * Converts a number of minutes into a time string in "HH:MM" format.
+*
+* @param minutes - The number of minutes to convert. Can be a number or a numeric string.
+* @returns A string representing the time in "HH:MM" format.
+*
+* @remarks Always returns the absolute value of the minutes, ignoring the sign if they are negative.
+*
+* @example
+* convertMinutesToTime(75); // "1:15"
+* convertMinutesToTime(-45); // "0:45"
+*/
+function convertMinutesToTime(minutes) {
+	const parsed = require_utilities.normalizeNumber(minutes);
+	if (require_primitives.isUndefined(parsed)) throw new TypeError(`Invalid numeric input!`, { cause: `${minutes} cannot be converted to a number.` });
+	const numMIn = Math.abs(parsed);
+	return `${String(Math.floor(numMIn / 60))}:${String(numMIn % 60).padStart(2, "0")}`;
+}
+/**
+* * Converts a minute-based offset to a UTC offset string in the format `UTC±HH:MM`.
+*
+* @param minutes - The offset in minutes (positive or negative).
+* @returns A formatted UTC offset string like `UTC+05:30` or `UTC-04:00`.
+*/
+function formatUTCOffset(minutes) {
+	const parsed = require_utilities.normalizeNumber(minutes);
+	if (require_primitives.isUndefined(parsed)) throw new TypeError(`Invalid numeric input!`, { cause: `${minutes} cannot be converted to a number.` });
+	const sign = parsed < 0 ? "-" : "+";
+	const abs = Math.abs(parsed);
+	return `UTC${sign}${String(Math.floor(abs / 60)).padStart(2, "0")}:${String(abs % 60).padStart(2, "0")}`;
+}
+/** Get the current system's time zone identifier using {@link Intl.DateTimeFormat} API. */
+function getNativeTimeZoneId() {
+	return Intl.DateTimeFormat().resolvedOptions().timeZone;
+}
+/**
+* * Retrieves comprehensive time zone details using the {@link Intl.DateTimeFormat} API.
+* @param tzId Optional timezone identifier. Defaults to the system timezone.
+* @param date Optional date for which to resolve the information.
+* @returns Object containing time zone identifier, names, and offset.
+*/
+function getTimeZoneDetails(tzId, date) {
+	const TZ_NAME_TYPES = [
+		"long",
+		"longGeneric",
+		"longOffset"
+	];
+	const $tzId = tzId || getNativeTimeZoneId();
+	const obj = { tzIdentifier: $tzId };
+	for (const type of TZ_NAME_TYPES) {
+		const key = `tzName${type[0].toUpperCase()}${type.slice(1)}`;
+		obj[key] = require_helpers._resolveNativeTzName($tzId, type, date);
+	}
+	return obj;
+}
+/** Cache for offset to time zone */
+const TZ_MAP = /* @__PURE__ */ new Map();
+/**
+* * Resolves all IANA time-zone identifiers that match a given UTC offset.
+*
+* @remarks
+* - Uses an internal in-memory cache that persists for the lifetime of the running application.
+* - The cache is lazily populated so the `offset`-to-`time-zone` mapping is computed only once per offset.
+* - Offset and time-zone identifier detection uses the {@link Intl.DateTimeFormat} API.
+*
+* @param offset The UTC offset in `"UTC±HH:MM"` format.
+* @returns An array of matching IANA time-zone identifiers, or an empty array if the offset is invalid.
+*/
+function getTimeZoneIds(offset) {
+	if (!require_guards.isValidUTCOffset(offset)) return [];
+	if (TZ_MAP.has(offset)) return TZ_MAP.get(offset) ?? [];
+	for (const zone of require_timezone.NATIVE_TZ_IDS) {
+		const off = require_helpers._gmtToUtcOffset(require_helpers._resolveNativeTzName(zone, "longOffset"));
+		if (off) TZ_MAP.set(off, [...TZ_MAP.get(off) ?? [], zone]);
+	}
+	return TZ_MAP.get(offset) ?? [];
+}
+/**
+* * Formats a date into a specified string format.
+*
+* @param options Options to control date and time formatting.
+*
+* @remarks
+* - If no date is provided, the current date and time will be used.
+* - If the provided date is invalid, the function will return `'Invalid Date!'`.
+* - The default format is `'dd, mmm DD, YYYY HH:mm:ss'` (e.g., `'Sun, Apr 06, 2025 16:11:55'`).
+* - By default, local time is used; set `useUTC` to `true` to format in UTC.
+* - The format string supports various tokens for date and time components, as well as literal text enclosed in square brackets.
+* - See {@link https://toolbox.nazmul-nhb.dev/docs/utilities/date/formatDate#format-tokens format tokens} for details on supported tokens.
+* - For more complex date/time manipulations, consider using the {@link https://toolbox.nazmul-nhb.dev/docs/classes/Chronos Chronos} class.
+*
+* @returns Date/time string in specified format.
+*/
+function formatDate(options) {
+	const { date = /* @__PURE__ */ new Date(), format = "dd, mmm DD, YYYY HH:mm:ss", useUTC = false } = options ?? {};
+	const $date = require_helpers._dateArgsToDate(date);
+	if (isNaN($date.getTime())) return "Invalid Date!";
+	/** Get unit value for {@link $date} for specific unit in local or UTC time */
+	const _getUnitValue = (suffix) => {
+		return useUTC ? $date[`getUTC${suffix}`]() : $date[`get${suffix}`]();
+	};
+	return require_helpers._formatDate(format, _getUnitValue("FullYear"), _getUnitValue("Month"), _getUnitValue("Day"), _getUnitValue("Date"), _getUnitValue("Hours"), _getUnitValue("Minutes"), _getUnitValue("Seconds"), _getUnitValue("Milliseconds"), useUTC ? "Z" : formatUTCOffset(-$date.getTimezoneOffset()).slice(3));
+}
+/**
+* * Formats a time-only string into a formatted time string.
+*
+* @param time - Time string to be formatted. Supported formats include:
+* - `HH:mm` → e.g., `'14:50'`
+* - `HH:mm:ss` → e.g., `'14:50:00'`
+* - `HH:mm:ss.mss` → e.g., `'14:50:00.800'`
+* - `HH:mm+TimeZoneOffset(HH)` → e.g., `'14:50+06'`
+* - `HH:mm+TimeZoneOffset(HH:mm)` → e.g., `'14:50+06:00'`
+* - `HH:mm:ss+TimeZoneOffset(HH)` → e.g., `'14:50:00+06'`
+* - `HH:mm:ss+TimeZoneOffset(HH:mm)` → e.g., `'14:50:00+05:30'`
+* - `HH:mm:ss.mss+TimeZoneOffset(HH)` → e.g., `'14:50:00.800+06'`
+* - `HH:mm:ss.mss+TimeZoneOffset(HH:mm)` → e.g., `'14:50:00.800+06:30'`
+*
+* - *Input will default to today's date and assume local timezone if no offset is provided.*
+*
+* @param format - Format tokens accepted by {@link formatDate} method ({@link TimeOnlyFormat}) for time part only.
+*                 Default: `hh:mm:ss a` → 02:33:36 pm.
+* @returns Formatted time string in local (System) time.
+*/
+function formatTimePart(time, format) {
+	return formatDate({
+		date: `${formatDate({ format: "YYYY-MM-DD" })}T${require_helpers._normalizeOffset(time)}`,
+		format: format || "hh:mm:ss a"
+	});
+}
+/**
+* * Formats a date as a relative time string (e.g., "5m ago", "2h from now").
+*
+* @param date - The date to format, which can be a `Date` object, a date string, or a timestamp number.
+* @param format - Optional format string for dates older than 7 days. Defaults to `'mmm D, yyyy hh:mm a'`.
+* @returns A relative time string if the date is within the last 7 days, otherwise a formatted date string.
+*
+* @remarks
+* - If date is provided but `undefined`, current date and time will be used.
+* - If the provided date is invalid, the function will return `'Invalid Date!'`.
+* - For dates within the last 7 days, the output will be in the format of "Xm ago" or "Xh from now".
+* - For dates older than 7 days, the output will be formatted using the provided `format` string or the default format if none is provided.
+*
+* @example
+* formatDateRelative(Date.now() - 5 * 60000); // "5m ago"
+* formatDateRelative(Date.now() + 2 * 3600000); // "2h from now"
+* formatDateRelative(Date.now() - 10 * 86400000); // "Apr 6, 2026 04:11 PM" (formatted date string)
+*/
+function formatDateRelative(date, format) {
+	const $date = require_helpers._dateArgsToDate(date);
+	if (isNaN($date.getTime())) return "Invalid Date!";
+	const now = Date.now();
+	const then = $date.getTime();
+	const diff = Math.abs(now - then);
+	const minutes = Math.floor(diff / 6e4);
+	const hours = Math.floor(diff / 36e5);
+	const days = Math.floor(diff / 864e5);
+	const suffix = then < now ? "ago" : "from now";
+	if (minutes < 1) return "Just now";
+	if (minutes < 60) return `${minutes}m ${suffix}`;
+	if (hours < 24) return `${hours}h ${suffix}`;
+	if (days < 7) return `${days}d ${suffix}`;
+	return formatDate({
+		date,
+		format: format || "mmm D, yyyy hh:mm a"
+	});
+}
+/** Get timestamp in ISO 8601 format. */
+function getTimestamp(args, format) {
+	let $value;
+	let $format;
+	const _isTsOptions = (opt) => {
+		return require_non_primitives.isObject(opt) && ("value" in opt || "format" in opt);
+	};
+	if (_isTsOptions(args)) {
+		$value = args.value || /* @__PURE__ */ new Date();
+		$format = args.format || "utc";
+	} else {
+		$value = args || /* @__PURE__ */ new Date();
+		$format = format || "utc";
+	}
+	let date = require_helpers._dateArgsToDate($value);
+	if (isNaN(date.getTime())) date = /* @__PURE__ */ new Date();
+	if ($format === "local") {
+		const offsetMins = date.getTimezoneOffset();
+		const localDate = /* @__PURE__ */ new Date(date.getTime() - offsetMins * 6e4);
+		const offset = formatUTCOffset(-offsetMins).slice(3);
+		return localDate.toISOString().replace("Z", offset);
+	}
+	return date.toISOString();
+}
+
+//#endregion
+Object.defineProperty(exports, 'convertMinutesToTime', {
+  enumerable: true,
+  get: function () {
+    return convertMinutesToTime;
+  }
+});
+Object.defineProperty(exports, 'extractHourMinute', {
+  enumerable: true,
+  get: function () {
+    return extractHourMinute;
+  }
+});
+Object.defineProperty(exports, 'extractMinutesFromUTC', {
+  enumerable: true,
+  get: function () {
+    return extractMinutesFromUTC;
+  }
+});
+Object.defineProperty(exports, 'extractTimeFromUTC', {
+  enumerable: true,
+  get: function () {
+    return extractTimeFromUTC;
+  }
+});
+Object.defineProperty(exports, 'formatDate', {
+  enumerable: true,
+  get: function () {
+    return formatDate;
+  }
+});
+Object.defineProperty(exports, 'formatDateRelative', {
+  enumerable: true,
+  get: function () {
+    return formatDateRelative;
+  }
+});
+Object.defineProperty(exports, 'formatTimePart', {
+  enumerable: true,
+  get: function () {
+    return formatTimePart;
+  }
+});
+Object.defineProperty(exports, 'formatUTCOffset', {
+  enumerable: true,
+  get: function () {
+    return formatUTCOffset;
+  }
+});
+Object.defineProperty(exports, 'getNativeTimeZoneId', {
+  enumerable: true,
+  get: function () {
+    return getNativeTimeZoneId;
+  }
+});
+Object.defineProperty(exports, 'getTimeZoneDetails', {
+  enumerable: true,
+  get: function () {
+    return getTimeZoneDetails;
+  }
+});
+Object.defineProperty(exports, 'getTimeZoneIds', {
+  enumerable: true,
+  get: function () {
+    return getTimeZoneIds;
+  }
+});
+Object.defineProperty(exports, 'getTimestamp', {
+  enumerable: true,
+  get: function () {
+    return getTimestamp;
+  }
+});
+Object.defineProperty(exports, 'getTotalMinutes', {
+  enumerable: true,
+  get: function () {
+    return getTotalMinutes;
+  }
+});