@bccampus/utils 0.2.3 → 0.3.0

package/README.md

@@ -1,8 +1,3 @@
-# @bccampus/utils
-
-BCcampus' Utility Box
-
-## ToDo
-
-- Write some tests
-- Expected coverage: 80%
+# @bccampus/utils
+
+BCcampus' Utility Box

package/dist/array/chunk.cjs

@@ -1,9 +1,17 @@
-"use strict";
 Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
+//#region src/array/chunk.ts
+/**
+* Returns an array of chunks
+*
+* @param arr
+* @param size - Size of each chunk (default: 5)
+* @returns array of chunks
+*/
 function chunk(arr, size = 5) {
-  const chunks = [];
-  for (let i = 0; i < arr.length; i += size)
-    chunks.push(arr.slice(i, i + size));
-  return chunks;
+	if (size < 1) return [arr];
+	const chunks = [];
+	for (let i = 0; i < arr.length; i += size) chunks.push(arr.slice(i, i + size));
+	return chunks;
 }
+//#endregion
 exports.chunk = chunk;

package/dist/array/chunk.d.ts

@@ -1 +1,8 @@
+/**
+ * Returns an array of chunks
+ *
+ * @param arr
+ * @param size - Size of each chunk (default: 5)
+ * @returns array of chunks
+ */
 export declare function chunk<T>(arr: T[], size?: number): T[][];

package/dist/array/chunk.js

@@ -1,9 +1,16 @@
+//#region src/array/chunk.ts
+/**
+* Returns an array of chunks
+*
+* @param arr
+* @param size - Size of each chunk (default: 5)
+* @returns array of chunks
+*/
 function chunk(arr, size = 5) {
-  const chunks = [];
-  for (let i = 0; i < arr.length; i += size)
-    chunks.push(arr.slice(i, i + size));
-  return chunks;
+	if (size < 1) return [arr];
+	const chunks = [];
+	for (let i = 0; i < arr.length; i += size) chunks.push(arr.slice(i, i + size));
+	return chunks;
 }
-export {
-  chunk
-};
+//#endregion
+export { chunk };

package/dist/array/chunk.test.d.ts

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

package/dist/date/iso-date-time/constants.cjs

@@ -0,0 +1,27 @@
+Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
+//#region src/date/iso-date-time/constants.ts
+var isoDateTimeRegEx = /^([0-9-]+)(T([0-9:.,]+)(Z|[+-]([0-9:]+))?)?$/;
+var dateRegEx = /^(\d{4})-?(\d{2})?-?(\d{2})?$/;
+var timeRegEx = /^(\d{2}):?(\d{2})?:?(\d{2})?(\.(\d{3}))?$/;
+var timezoneRegEx = /^Z|^[+-]((\d{2}):?(\d{2})?)$/;
+var InvalidDate = Symbol("Invalid Date");
+var DefaultDateFormat = {
+	year: "numeric",
+	month: "long",
+	day: "2-digit"
+};
+var DefaultTimeFormat = {
+	hour: "2-digit",
+	minute: "2-digit",
+	timeZoneName: "short"
+};
+var DefaultTimezone = "America/Vancouver";
+//#endregion
+exports.DefaultDateFormat = DefaultDateFormat;
+exports.DefaultTimeFormat = DefaultTimeFormat;
+exports.DefaultTimezone = DefaultTimezone;
+exports.InvalidDate = InvalidDate;
+exports.dateRegEx = dateRegEx;
+exports.isoDateTimeRegEx = isoDateTimeRegEx;
+exports.timeRegEx = timeRegEx;
+exports.timezoneRegEx = timezoneRegEx;

package/dist/date/iso-date-time/constants.d.ts

@@ -0,0 +1,9 @@
+import { DateFormatOptions } from './types';
+export declare const isoDateTimeRegEx: RegExp;
+export declare const dateRegEx: RegExp;
+export declare const timeRegEx: RegExp;
+export declare const timezoneRegEx: RegExp;
+export declare const InvalidDate: unique symbol;
+export declare const DefaultDateFormat: DateFormatOptions;
+export declare const DefaultTimeFormat: DateFormatOptions;
+export declare const DefaultTimezone = "America/Vancouver";

package/dist/date/iso-date-time/constants.js

@@ -0,0 +1,19 @@
+//#region src/date/iso-date-time/constants.ts
+var isoDateTimeRegEx = /^([0-9-]+)(T([0-9:.,]+)(Z|[+-]([0-9:]+))?)?$/;
+var dateRegEx = /^(\d{4})-?(\d{2})?-?(\d{2})?$/;
+var timeRegEx = /^(\d{2}):?(\d{2})?:?(\d{2})?(\.(\d{3}))?$/;
+var timezoneRegEx = /^Z|^[+-]((\d{2}):?(\d{2})?)$/;
+var InvalidDate = Symbol("Invalid Date");
+var DefaultDateFormat = {
+	year: "numeric",
+	month: "long",
+	day: "2-digit"
+};
+var DefaultTimeFormat = {
+	hour: "2-digit",
+	minute: "2-digit",
+	timeZoneName: "short"
+};
+var DefaultTimezone = "America/Vancouver";
+//#endregion
+export { DefaultDateFormat, DefaultTimeFormat, DefaultTimezone, InvalidDate, dateRegEx, isoDateTimeRegEx, timeRegEx, timezoneRegEx };

package/dist/date/iso-date-time/index.cjs

@@ -0,0 +1,8 @@
+Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
+const require_date_iso_date_time_constants = require("./constants.cjs");
+const require_date_iso_date_time_iso_date_time = require("./iso-date-time.cjs");
+exports.DefaultDateFormat = require_date_iso_date_time_constants.DefaultDateFormat;
+exports.DefaultTimeFormat = require_date_iso_date_time_constants.DefaultTimeFormat;
+exports.DefaultTimezone = require_date_iso_date_time_constants.DefaultTimezone;
+exports.ISODateTime = require_date_iso_date_time_iso_date_time.ISODateTime;
+exports.InvalidDate = require_date_iso_date_time_constants.InvalidDate;

package/dist/date/iso-date-time/index.d.ts

@@ -0,0 +1,5 @@
+import { DateFormatOptions, DateFormatterConfig, ParsedDateTime } from './types';
+import { DefaultDateFormat, DefaultTimeFormat, DefaultTimezone, InvalidDate } from './constants';
+import { ISODateTime } from './iso-date-time';
+export { DefaultDateFormat, DefaultTimeFormat, DefaultTimezone, InvalidDate, ISODateTime };
+export type { DateFormatOptions, DateFormatterConfig, ParsedDateTime };

package/dist/date/iso-date-time/index.js

@@ -0,0 +1,3 @@
+import { DefaultDateFormat, DefaultTimeFormat, DefaultTimezone, InvalidDate } from "./constants.js";
+import { ISODateTime } from "./iso-date-time.js";
+export { DefaultDateFormat, DefaultTimeFormat, DefaultTimezone, ISODateTime, InvalidDate };

package/dist/date/iso-date-time/iso-date-time.arithmetic.test.d.ts

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

package/dist/date/iso-date-time/iso-date-time.cjs

@@ -0,0 +1,232 @@
+Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
+const require_date_iso_date_time_constants = require("./constants.cjs");
+//#region src/date/iso-date-time/iso-date-time.ts
+/**
+* Enables storage, retrieval and formating of ISO dates and times
+* with time zone information.
+*/
+var ISODateTime = class ISODateTime {
+	#parsed;
+	#date;
+	#string;
+	constructor(isoDatetime) {
+		if (typeof isoDatetime === "string") {
+			this.#parsed = ISODateTime.parse(isoDatetime);
+			if (this.#parsed) this.#date = new Date(ISODateTime.toString(this));
+			else {
+				this.#date = require_date_iso_date_time_constants.InvalidDate;
+				console.error(`Failed to parse date for value: ${isoDatetime}`);
+			}
+		} else if (typeof isoDatetime === "number" && Number.isFinite(isoDatetime)) {
+			this.#date = new Date(isoDatetime);
+			this.#parsed = ISODateTime.parse(this.#date.toISOString());
+		} else {
+			this.#date = /* @__PURE__ */ new Date();
+			this.#parsed = ISODateTime.parse(this.#date.toISOString());
+		}
+		if (!Number.isNaN(this.valueOf()) && this.#date !== require_date_iso_date_time_constants.InvalidDate) this.#string = this.#date.toISOString();
+		else this.#string = "Invalid Date";
+	}
+	/**
+	* Get date and time components
+	*/
+	get parts() {
+		return this.#parsed;
+	}
+	/**
+	* Get timezone
+	*/
+	get timezone() {
+		return this.parts?.timezone ?? "UTC";
+	}
+	/**
+	* Parse a string in ISO DateTime format.
+	* If the input is valid, returns date and time components;
+	* otherwise, returns `undefined`.
+	*/
+	static parse(isoDatetime) {
+		const isoDatetimeParts = isoDatetime.match(require_date_iso_date_time_constants.isoDateTimeRegEx);
+		if (isoDatetimeParts) {
+			const dateParts = isoDatetimeParts[1] && isoDatetimeParts[1].match(require_date_iso_date_time_constants.dateRegEx);
+			if (!dateParts) return void 0;
+			const parsedDateTime = { date: {
+				year: dateParts[1],
+				month: dateParts[2],
+				day: dateParts[3]
+			} };
+			const timeParts = isoDatetimeParts[3] && isoDatetimeParts[3].match(require_date_iso_date_time_constants.timeRegEx);
+			if (timeParts) parsedDateTime.time = {
+				hours: timeParts[1],
+				minutes: timeParts[2],
+				seconds: timeParts[3],
+				milliseconds: timeParts[5]
+			};
+			const tzParts = isoDatetimeParts[4] && isoDatetimeParts[4].match(require_date_iso_date_time_constants.timezoneRegEx);
+			if (tzParts) parsedDateTime.timezone = tzParts[0];
+			return parsedDateTime;
+		}
+	}
+	static getISOString(parts) {
+		if (!parts) return "Invalid Date";
+		return `${parts.date.year}-${parts.date.month ?? "01"}-${parts.date.day ?? "01"}T${parts.time?.hours ?? "00"}:${parts.time?.minutes ?? "00"}:${parts.time?.seconds ?? "00"}.${parts.time?.milliseconds ?? "000"}${parts.timezone ?? "Z"}`;
+	}
+	static toString(dateTime) {
+		const _p = typeof dateTime === "string" ? ISODateTime.parse(dateTime) : dateTime.parts;
+		return ISODateTime.getISOString(_p);
+	}
+	/**
+	* Returns the stored time value in milliseconds since midnight, January 1, 1970 UTC.
+	*/
+	valueOf() {
+		if (this.#date === require_date_iso_date_time_constants.InvalidDate) return NaN;
+		return this.#date.valueOf();
+	}
+	/**
+	* Retruns ISO date and time string
+	*/
+	toString() {
+		return this.#string;
+	}
+	/**
+	* Retruns Javascript date object
+	*/
+	toDate() {
+		return this.#date;
+	}
+	[Symbol.toPrimitive](hint) {
+		if (hint === "string") return this.toString();
+		return this.valueOf();
+	}
+	toJSON() {
+		return this.toString();
+	}
+	static getFormatter(isoDatetime, config) {
+		let _format;
+		if (config?.customFormat?.dateStyle || config?.customFormat?.timeStyle) _format = {
+			dateStyle: config?.customFormat?.dateStyle,
+			timeStyle: config?.customFormat?.timeStyle
+		};
+		else if (config?.noDate === true && config?.noTime === true) _format = { ...config.customFormat };
+		else if (config?.noDate === true && !config?.noTime) _format = {
+			...require_date_iso_date_time_constants.DefaultTimeFormat,
+			...config.customFormat
+		};
+		else if (config?.noTime === true && !config.noDate) _format = {
+			...require_date_iso_date_time_constants.DefaultDateFormat,
+			...config.customFormat
+		};
+		else _format = {
+			...require_date_iso_date_time_constants.DefaultDateFormat,
+			...require_date_iso_date_time_constants.DefaultTimeFormat,
+			...config?.customFormat
+		};
+		if (config?.customFormat?.timeZone) _format.timeZone = config.customFormat.timeZone;
+		else if (isoDatetime.parts?.time === void 0) _format.timeZone = "UTC";
+		else _format.timeZone = require_date_iso_date_time_constants.DefaultTimezone;
+		return new Intl.DateTimeFormat("en", _format);
+	}
+	static format(isoDatetime, config) {
+		const _isoDatetime = typeof isoDatetime === "string" ? new ISODateTime(isoDatetime) : isoDatetime;
+		const _date = _isoDatetime.toDate();
+		if (_date === require_date_iso_date_time_constants.InvalidDate) return _isoDatetime.toString();
+		return ISODateTime.getFormatter(_isoDatetime, config).format(_date);
+	}
+	static formatRange(startDate, endDate, config) {
+		const _startISODateTime = typeof startDate === "string" ? new ISODateTime(startDate) : startDate;
+		const _startDate = _startISODateTime.toDate();
+		if (_startDate === require_date_iso_date_time_constants.InvalidDate) return _startISODateTime.toString();
+		const _endISODateTime = typeof endDate === "string" ? new ISODateTime(endDate) : endDate;
+		const _endDate = _endISODateTime.toDate();
+		if (_endDate === require_date_iso_date_time_constants.InvalidDate) return _endISODateTime.toString();
+		if (_startISODateTime.timezone !== _endISODateTime.timezone) throw new Error("Start and end dates in different time zones");
+		return ISODateTime.getFormatter(_startISODateTime, config).formatRange(_startDate, _endDate).replace(/\s/g, " ").replace(/\s/g, " ");
+	}
+	/**
+	* Returns formated date and time string
+	*/
+	format(config) {
+		return ISODateTime.format(this, config);
+	}
+	/**
+	* Adds milliseconds to the date and returns it as a new ISODateTime object
+	*/
+	addMillisecond(milliseconds) {
+		return new ISODateTime(this.valueOf() + milliseconds);
+	}
+	/**
+	* Adds seconds to the date and returns it as a new ISODateTime object
+	*/
+	addSecond(seconds) {
+		return this.addMillisecond(seconds * 1e3);
+	}
+	/**
+	* Adds minutes to the date and returns it as a new ISODateTime object
+	*/
+	addMinute(minutes) {
+		return this.addMillisecond(minutes * 6e4);
+	}
+	/**
+	* Adds hours to the date and returns it as a new ISODateTime object
+	*/
+	addHour(hours) {
+		return this.addMillisecond(hours * 36e5);
+	}
+	/**
+	* Adds days to the date and returns it as a new ISODateTime object
+	*/
+	addDay(days) {
+		return this.addMillisecond(days * 864e5);
+	}
+	/**
+	* Returns the start of the previous month as a new ISODateTime object
+	*/
+	static getPrevMonthStart(date) {
+		if (date.parts) {
+			const month = date.parts.date.month ? Number(date.parts.date.month) : 1;
+			const prevMonth = month === 1 ? 12 : month - 1;
+			const prevParts = {
+				date: {
+					year: month === 1 ? (Number(date.parts.date.year) - 1).toString() : date.parts.date.year,
+					month: prevMonth.toString().padStart(2, "0"),
+					day: "01"
+				},
+				timezone: date.parts.timezone
+			};
+			return new ISODateTime(ISODateTime.getISOString(prevParts));
+		}
+		return date;
+	}
+	/**
+	* Returns the start of the previous month as a new ISODateTime object
+	*/
+	getPrevMonthStart() {
+		return ISODateTime.getPrevMonthStart(this);
+	}
+	/**
+	* Returns the start of the next month as a new ISODateTime object
+	*/
+	static getNextMonthStart(date) {
+		if (date.parts) {
+			const month = date.parts.date.month ? Number(date.parts.date.month) : 1;
+			const nextMonth = month % 12 + 1;
+			const nextParts = {
+				date: {
+					year: month === 12 ? (Number(date.parts.date.year) + 1).toString() : date.parts.date.year,
+					month: nextMonth.toString().padStart(2, "0"),
+					day: "01"
+				},
+				timezone: date.parts.timezone
+			};
+			return new ISODateTime(ISODateTime.getISOString(nextParts));
+		}
+		return date;
+	}
+	/**
+	* Returns the start of the next month as a new ISODateTime object
+	*/
+	getNextMonthStart() {
+		return ISODateTime.getNextMonthStart(this);
+	}
+};
+//#endregion
+exports.ISODateTime = ISODateTime;

package/dist/date/{iso-date-time.d.ts → iso-date-time/iso-date-time.d.ts}

@@ -1,8 +1,4 @@
-export declare const InvalidDate: unique symbol;
-export type InvalidDate = typeof InvalidDate;
-export declare const DefaultDateFormat: DateFormatOptions;
-export declare const DefaultTimeFormat: DateFormatOptions;
-export declare const DefaultTimezone = "America/Vancouver";
+import { DateFormatterConfig, InvalidDateSymbol, ParsedDateTime } from './types';
 /**
  * Enables storage, retrieval and formating of ISO dates and times
  * with time zone information.
@@ -19,7 +15,7 @@ export declare class ISODateTime {
     /**
      * Get timezone
      */
-    get timezone(): ISOTimezone | "UTC";
+    get timezone(): string;
     /**
      * Parse a string in ISO DateTime format.
      * If the input is valid, returns date and time components;
@@ -43,8 +39,7 @@ export declare class ISODateTime {
     /**
      * Retruns Javascript date object
      */
-    toDate(): typeof InvalidDate | Date;
-    get [Symbol.toStringTag](): string;
+    toDate(): Date | InvalidDateSymbol;
     [Symbol.toPrimitive](hint: 'default'): number;
     [Symbol.toPrimitive](hint: 'string'): string;
     [Symbol.toPrimitive](hint: 'number'): number;
@@ -101,27 +96,3 @@ export declare class ISODateTime {
      */
     getNextMonthStart(): ISODateTime;
 }
-interface ISODateParts {
-    year: string;
-    month?: string;
-    day?: string;
-}
-interface ISOTimeParts {
-    hours: string;
-    minutes?: string;
-    seconds?: string;
-    milliseconds?: string;
-}
-type ISOTimezone = 'Z' | `${'+' | '-'}${string}`;
-export interface ParsedDateTime {
-    date: ISODateParts;
-    time?: ISOTimeParts;
-    timezone?: ISOTimezone;
-}
-export type DateFormatOptions = Partial<Intl.DateTimeFormatOptions>;
-export interface DateFormatterConfig {
-    noDate?: boolean;
-    noTime?: boolean;
-    customFormat?: DateFormatOptions;
-}
-export {};

package/dist/date/iso-date-time/iso-date-time.format.test.d.ts

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

package/dist/date/iso-date-time/iso-date-time.js

@@ -0,0 +1,231 @@
+import { DefaultDateFormat, DefaultTimeFormat, DefaultTimezone, InvalidDate, dateRegEx, isoDateTimeRegEx, timeRegEx, timezoneRegEx } from "./constants.js";
+//#region src/date/iso-date-time/iso-date-time.ts
+/**
+* Enables storage, retrieval and formating of ISO dates and times
+* with time zone information.
+*/
+var ISODateTime = class ISODateTime {
+	#parsed;
+	#date;
+	#string;
+	constructor(isoDatetime) {
+		if (typeof isoDatetime === "string") {
+			this.#parsed = ISODateTime.parse(isoDatetime);
+			if (this.#parsed) this.#date = new Date(ISODateTime.toString(this));
+			else {
+				this.#date = InvalidDate;
+				console.error(`Failed to parse date for value: ${isoDatetime}`);
+			}
+		} else if (typeof isoDatetime === "number" && Number.isFinite(isoDatetime)) {
+			this.#date = new Date(isoDatetime);
+			this.#parsed = ISODateTime.parse(this.#date.toISOString());
+		} else {
+			this.#date = /* @__PURE__ */ new Date();
+			this.#parsed = ISODateTime.parse(this.#date.toISOString());
+		}
+		if (!Number.isNaN(this.valueOf()) && this.#date !== InvalidDate) this.#string = this.#date.toISOString();
+		else this.#string = "Invalid Date";
+	}
+	/**
+	* Get date and time components
+	*/
+	get parts() {
+		return this.#parsed;
+	}
+	/**
+	* Get timezone
+	*/
+	get timezone() {
+		return this.parts?.timezone ?? "UTC";
+	}
+	/**
+	* Parse a string in ISO DateTime format.
+	* If the input is valid, returns date and time components;
+	* otherwise, returns `undefined`.
+	*/
+	static parse(isoDatetime) {
+		const isoDatetimeParts = isoDatetime.match(isoDateTimeRegEx);
+		if (isoDatetimeParts) {
+			const dateParts = isoDatetimeParts[1] && isoDatetimeParts[1].match(dateRegEx);
+			if (!dateParts) return void 0;
+			const parsedDateTime = { date: {
+				year: dateParts[1],
+				month: dateParts[2],
+				day: dateParts[3]
+			} };
+			const timeParts = isoDatetimeParts[3] && isoDatetimeParts[3].match(timeRegEx);
+			if (timeParts) parsedDateTime.time = {
+				hours: timeParts[1],
+				minutes: timeParts[2],
+				seconds: timeParts[3],
+				milliseconds: timeParts[5]
+			};
+			const tzParts = isoDatetimeParts[4] && isoDatetimeParts[4].match(timezoneRegEx);
+			if (tzParts) parsedDateTime.timezone = tzParts[0];
+			return parsedDateTime;
+		}
+	}
+	static getISOString(parts) {
+		if (!parts) return "Invalid Date";
+		return `${parts.date.year}-${parts.date.month ?? "01"}-${parts.date.day ?? "01"}T${parts.time?.hours ?? "00"}:${parts.time?.minutes ?? "00"}:${parts.time?.seconds ?? "00"}.${parts.time?.milliseconds ?? "000"}${parts.timezone ?? "Z"}`;
+	}
+	static toString(dateTime) {
+		const _p = typeof dateTime === "string" ? ISODateTime.parse(dateTime) : dateTime.parts;
+		return ISODateTime.getISOString(_p);
+	}
+	/**
+	* Returns the stored time value in milliseconds since midnight, January 1, 1970 UTC.
+	*/
+	valueOf() {
+		if (this.#date === InvalidDate) return NaN;
+		return this.#date.valueOf();
+	}
+	/**
+	* Retruns ISO date and time string
+	*/
+	toString() {
+		return this.#string;
+	}
+	/**
+	* Retruns Javascript date object
+	*/
+	toDate() {
+		return this.#date;
+	}
+	[Symbol.toPrimitive](hint) {
+		if (hint === "string") return this.toString();
+		return this.valueOf();
+	}
+	toJSON() {
+		return this.toString();
+	}
+	static getFormatter(isoDatetime, config) {
+		let _format;
+		if (config?.customFormat?.dateStyle || config?.customFormat?.timeStyle) _format = {
+			dateStyle: config?.customFormat?.dateStyle,
+			timeStyle: config?.customFormat?.timeStyle
+		};
+		else if (config?.noDate === true && config?.noTime === true) _format = { ...config.customFormat };
+		else if (config?.noDate === true && !config?.noTime) _format = {
+			...DefaultTimeFormat,
+			...config.customFormat
+		};
+		else if (config?.noTime === true && !config.noDate) _format = {
+			...DefaultDateFormat,
+			...config.customFormat
+		};
+		else _format = {
+			...DefaultDateFormat,
+			...DefaultTimeFormat,
+			...config?.customFormat
+		};
+		if (config?.customFormat?.timeZone) _format.timeZone = config.customFormat.timeZone;
+		else if (isoDatetime.parts?.time === void 0) _format.timeZone = "UTC";
+		else _format.timeZone = DefaultTimezone;
+		return new Intl.DateTimeFormat("en", _format);
+	}
+	static format(isoDatetime, config) {
+		const _isoDatetime = typeof isoDatetime === "string" ? new ISODateTime(isoDatetime) : isoDatetime;
+		const _date = _isoDatetime.toDate();
+		if (_date === InvalidDate) return _isoDatetime.toString();
+		return ISODateTime.getFormatter(_isoDatetime, config).format(_date);
+	}
+	static formatRange(startDate, endDate, config) {
+		const _startISODateTime = typeof startDate === "string" ? new ISODateTime(startDate) : startDate;
+		const _startDate = _startISODateTime.toDate();
+		if (_startDate === InvalidDate) return _startISODateTime.toString();
+		const _endISODateTime = typeof endDate === "string" ? new ISODateTime(endDate) : endDate;
+		const _endDate = _endISODateTime.toDate();
+		if (_endDate === InvalidDate) return _endISODateTime.toString();
+		if (_startISODateTime.timezone !== _endISODateTime.timezone) throw new Error("Start and end dates in different time zones");
+		return ISODateTime.getFormatter(_startISODateTime, config).formatRange(_startDate, _endDate).replace(/\s/g, " ").replace(/\s/g, " ");
+	}
+	/**
+	* Returns formated date and time string
+	*/
+	format(config) {
+		return ISODateTime.format(this, config);
+	}
+	/**
+	* Adds milliseconds to the date and returns it as a new ISODateTime object
+	*/
+	addMillisecond(milliseconds) {
+		return new ISODateTime(this.valueOf() + milliseconds);
+	}
+	/**
+	* Adds seconds to the date and returns it as a new ISODateTime object
+	*/
+	addSecond(seconds) {
+		return this.addMillisecond(seconds * 1e3);
+	}
+	/**
+	* Adds minutes to the date and returns it as a new ISODateTime object
+	*/
+	addMinute(minutes) {
+		return this.addMillisecond(minutes * 6e4);
+	}
+	/**
+	* Adds hours to the date and returns it as a new ISODateTime object
+	*/
+	addHour(hours) {
+		return this.addMillisecond(hours * 36e5);
+	}
+	/**
+	* Adds days to the date and returns it as a new ISODateTime object
+	*/
+	addDay(days) {
+		return this.addMillisecond(days * 864e5);
+	}
+	/**
+	* Returns the start of the previous month as a new ISODateTime object
+	*/
+	static getPrevMonthStart(date) {
+		if (date.parts) {
+			const month = date.parts.date.month ? Number(date.parts.date.month) : 1;
+			const prevMonth = month === 1 ? 12 : month - 1;
+			const prevParts = {
+				date: {
+					year: month === 1 ? (Number(date.parts.date.year) - 1).toString() : date.parts.date.year,
+					month: prevMonth.toString().padStart(2, "0"),
+					day: "01"
+				},
+				timezone: date.parts.timezone
+			};
+			return new ISODateTime(ISODateTime.getISOString(prevParts));
+		}
+		return date;
+	}
+	/**
+	* Returns the start of the previous month as a new ISODateTime object
+	*/
+	getPrevMonthStart() {
+		return ISODateTime.getPrevMonthStart(this);
+	}
+	/**
+	* Returns the start of the next month as a new ISODateTime object
+	*/
+	static getNextMonthStart(date) {
+		if (date.parts) {
+			const month = date.parts.date.month ? Number(date.parts.date.month) : 1;
+			const nextMonth = month % 12 + 1;
+			const nextParts = {
+				date: {
+					year: month === 12 ? (Number(date.parts.date.year) + 1).toString() : date.parts.date.year,
+					month: nextMonth.toString().padStart(2, "0"),
+					day: "01"
+				},
+				timezone: date.parts.timezone
+			};
+			return new ISODateTime(ISODateTime.getISOString(nextParts));
+		}
+		return date;
+	}
+	/**
+	* Returns the start of the next month as a new ISODateTime object
+	*/
+	getNextMonthStart() {
+		return ISODateTime.getNextMonthStart(this);
+	}
+};
+//#endregion
+export { ISODateTime };

package/dist/date/iso-date-time/iso-date-time.test.d.ts

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