date-vir 0.5.0 → 0.7.0

package/dist/cjs/full-date/create-full-date.js

@@ -27,7 +27,7 @@ timezone) {
     if (!dateTime || !dateTime.isValid) {
         throw new Error(`Failed to parse date input '${dateLike}'`);
     }
-    return (0, luxon_date_time_conversion_1.parseLuxonDateTime)(dateTime);
+    return (0, luxon_date_time_conversion_1.parseLuxonDateTime)(dateTime, timezone);
 }
 exports.createFullDate = createFullDate;
 /**
@@ -41,6 +41,16 @@ function toNewTimezone(fullDate, timezone) {
     return createFullDate(fullDate, timezone);
 }
 exports.toNewTimezone = toNewTimezone;
+function lastDitchConversion(dateLike) {
+    /** As any cast for last ditch effort to convert the dateLike into a date. */
+    const dateTime = luxon_1.DateTime.fromJSDate(new Date(dateLike));
+    if (dateTime.isValid) {
+        return dateTime;
+    }
+    else {
+        return undefined;
+    }
+}
 function convertDateLikeToLuxonDateTime(dateLike, timezone) {
     if ((0, is_valid_full_date_1.isValidFullDate)(dateLike)) {
         dateLike = (0, luxon_date_time_conversion_1.toLuxonDateTime)(dateLike).toMillis();
@@ -54,7 +64,7 @@ function convertDateLikeToLuxonDateTime(dateLike, timezone) {
     else if ((0, common_1.isRuntimeTypeOf)(dateLike, 'string')) {
         const dateTime = luxon_1.DateTime.fromISO(dateLike, { zone: timezone });
         if (!dateTime.isValid) {
-            throw new Error(`Failed to parse date string '${dateLike}': unexpected string format. Please use parseStringToFullDate instead to have more control over the parsing format.`);
+            return lastDitchConversion(dateLike);
         }
         return dateTime;
     }
@@ -62,7 +72,7 @@ function convertDateLikeToLuxonDateTime(dateLike, timezone) {
         const dateTime = luxon_1.DateTime.fromJSDate(dateLike);
         return dateTime.setZone(timezone);
     }
-    return undefined;
+    return lastDitchConversion(dateLike);
 }
 function getNowFullDate(timezone) {
     return createFullDate(Date.now(), timezone);

package/dist/cjs/full-date/date-transforms.js

@@ -0,0 +1,8 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.overrideDateParts = void 0;
+/** Override the initial provided FullDate with all subsequent FullDate parts. */
+function overrideDateParts(date, ...overrides) {
+    return Object.assign({}, date, ...overrides);
+}
+exports.overrideDateParts = overrideDateParts;

package/dist/cjs/full-date/luxon-date-time-conversion.js

@@ -25,7 +25,7 @@ exports.toLuxonDateTime = toLuxonDateTime;
  * could be helpful if you need it. Usually you should prefer using the createFullDate function
  * instead.
  */
-function parseLuxonDateTime(dateTimeInput) {
+function parseLuxonDateTime(dateTimeInput, forcedTimezone) {
     if (!dateTimeInput.isValid) {
         throw new Error(`Invalid input: '${dateTimeInput.toISO()}'`);
     }
@@ -37,7 +37,7 @@ function parseLuxonDateTime(dateTimeInput) {
         minute: dateTimeInput.minute,
         second: dateTimeInput.second,
         millisecond: dateTimeInput.millisecond,
-        timezone: dateTimeInput.zoneName,
+        timezone: forcedTimezone ?? dateTimeInput.zoneName,
     };
 }
 exports.parseLuxonDateTime = parseLuxonDateTime;

package/dist/cjs/full-date/string-format-types.js

@@ -1,2 +1,9 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
+exports.isValidIsoString = void 0;
+const luxon_1 = require("luxon");
+function isValidIsoString(input) {
+    const datetime = luxon_1.DateTime.fromISO(input);
+    return datetime.toISO() === input;
+}
+exports.isValidIsoString = isValidIsoString;

package/dist/cjs/index.js

@@ -19,6 +19,7 @@ __exportStar(require("./date-operations/combine-dates"), exports);
 __exportStar(require("./date-operations/diff-dates"), exports);
 __exportStar(require("./full-date/create-full-date"), exports);
 __exportStar(require("./full-date/date-like"), exports);
+__exportStar(require("./full-date/date-transforms"), exports);
 __exportStar(require("./full-date/format-presets"), exports);
 __exportStar(require("./full-date/full-date-shape"), exports);
 __exportStar(require("./full-date/is-valid-full-date"), exports);

package/dist/esm/full-date/create-full-date.d.ts

@@ -1,20 +1,20 @@
 import { Timezone } from '../timezone/timezone-names';
 import { DateLike } from './date-like';
 import { FullDate } from './full-date-shape';
-export declare function createFullDateInUserTimezone(dateLike: DateLike): FullDate;
-export declare function createUtcFullDate(dateLike: DateLike): FullDate;
+export declare function createFullDateInUserTimezone(dateLike: Readonly<DateLike>): FullDate;
+export declare function createUtcFullDate(dateLike: Readonly<DateLike>): FullDate;
 /**
  * Parses the given dateLike and then reads the fullDate properties from that parsed value as if it
  * were in the given timezone.
  */
 export declare function createFullDate(
 /** The original date representation to be converted into a FullDate. */
-dateLike: DateLike, 
+dateLike: Readonly<DateLike>, 
 /** The timezone that this date/time is meant for / originated from. */
 timezone: Timezone): FullDate;
 /**
  * Creates and returns a new FullDate object with its values shifted to be the same original time
  * but represented in a new timezone.
  */
-export declare function toNewTimezone(fullDate: FullDate, timezone: Timezone): FullDate;
+export declare function toNewTimezone(fullDate: Readonly<FullDate>, timezone: Timezone): Readonly<FullDate>;
 export declare function getNowFullDate(timezone: Timezone): FullDate;

package/dist/esm/full-date/create-full-date.js

@@ -22,7 +22,7 @@ timezone) {
     if (!dateTime || !dateTime.isValid) {
         throw new Error(`Failed to parse date input '${dateLike}'`);
     }
-    return parseLuxonDateTime(dateTime);
+    return parseLuxonDateTime(dateTime, timezone);
 }
 /**
  * Creates and returns a new FullDate object with its values shifted to be the same original time
@@ -34,6 +34,16 @@ export function toNewTimezone(fullDate, timezone) {
     }
     return createFullDate(fullDate, timezone);
 }
+function lastDitchConversion(dateLike) {
+    /** As any cast for last ditch effort to convert the dateLike into a date. */
+    const dateTime = DateTime.fromJSDate(new Date(dateLike));
+    if (dateTime.isValid) {
+        return dateTime;
+    }
+    else {
+        return undefined;
+    }
+}
 function convertDateLikeToLuxonDateTime(dateLike, timezone) {
     if (isValidFullDate(dateLike)) {
         dateLike = toLuxonDateTime(dateLike).toMillis();
@@ -47,7 +57,7 @@ function convertDateLikeToLuxonDateTime(dateLike, timezone) {
     else if (isRuntimeTypeOf(dateLike, 'string')) {
         const dateTime = DateTime.fromISO(dateLike, { zone: timezone });
         if (!dateTime.isValid) {
-            throw new Error(`Failed to parse date string '${dateLike}': unexpected string format. Please use parseStringToFullDate instead to have more control over the parsing format.`);
+            return lastDitchConversion(dateLike);
         }
         return dateTime;
     }
@@ -55,7 +65,7 @@ function convertDateLikeToLuxonDateTime(dateLike, timezone) {
         const dateTime = DateTime.fromJSDate(dateLike);
         return dateTime.setZone(timezone);
     }
-    return undefined;
+    return lastDitchConversion(dateLike);
 }
 export function getNowFullDate(timezone) {
     return createFullDate(Date.now(), timezone);

package/dist/esm/full-date/date-transforms.d.ts

@@ -0,0 +1,3 @@
+import { FullDate } from './full-date-shape';
+/** Override the initial provided FullDate with all subsequent FullDate parts. */
+export declare function overrideDateParts(date: FullDate, ...overrides: Partial<FullDate>[]): FullDate;

package/dist/esm/full-date/date-transforms.js

@@ -0,0 +1,4 @@
+/** Override the initial provided FullDate with all subsequent FullDate parts. */
+export function overrideDateParts(date, ...overrides) {
+    return Object.assign({}, date, ...overrides);
+}

package/dist/esm/full-date/luxon-date-time-conversion.d.ts

@@ -1,4 +1,5 @@
 import { DateTime } from 'luxon';
+import { Timezone } from '../timezone/timezone-names';
 import { FullDate } from './full-date-shape';
 /**
  * Converts a FullDate object into a Luxon DateTime library. This is only needed if you need complex
@@ -11,4 +12,4 @@ export declare function toLuxonDateTime(fullDateInput: FullDate): DateTime;
  * could be helpful if you need it. Usually you should prefer using the createFullDate function
  * instead.
  */
-export declare function parseLuxonDateTime(dateTimeInput: DateTime): FullDate;
+export declare function parseLuxonDateTime(dateTimeInput: DateTime, forcedTimezone?: Timezone): FullDate;

package/dist/esm/full-date/luxon-date-time-conversion.js

@@ -21,7 +21,7 @@ export function toLuxonDateTime(fullDateInput) {
  * could be helpful if you need it. Usually you should prefer using the createFullDate function
  * instead.
  */
-export function parseLuxonDateTime(dateTimeInput) {
+export function parseLuxonDateTime(dateTimeInput, forcedTimezone) {
     if (!dateTimeInput.isValid) {
         throw new Error(`Invalid input: '${dateTimeInput.toISO()}'`);
     }
@@ -33,6 +33,6 @@ export function parseLuxonDateTime(dateTimeInput) {
         minute: dateTimeInput.minute,
         second: dateTimeInput.second,
         millisecond: dateTimeInput.millisecond,
-        timezone: dateTimeInput.zoneName,
+        timezone: forcedTimezone ?? dateTimeInput.zoneName,
     };
 }

package/dist/esm/full-date/string-format-types.d.ts

@@ -4,3 +4,4 @@ export type JustTimeString = `${number}:${number}`;
 export type DateTimeWithSeconds = `${JustDateString}T${JustTimeWithSecondsString}`;
 export type DateTimeString = `${JustDateString}T${JustTimeString}`;
 export type UtcIsoString = `${JustDateString}T${JustTimeWithSecondsString}.${number}Z`;
+export declare function isValidIsoString(input: unknown): input is UtcIsoString;

package/dist/esm/full-date/string-format-types.js

@@ -1 +1,5 @@
-export {};
+import { DateTime } from 'luxon';
+export function isValidIsoString(input) {
+    const datetime = DateTime.fromISO(input);
+    return datetime.toISO() === input;
+}

package/dist/esm/index.d.ts

@@ -3,6 +3,7 @@ export * from './date-operations/combine-dates';
 export * from './date-operations/diff-dates';
 export * from './full-date/create-full-date';
 export * from './full-date/date-like';
+export * from './full-date/date-transforms';
 export * from './full-date/format-presets';
 export * from './full-date/full-date-shape';
 export * from './full-date/is-valid-full-date';

package/dist/esm/index.js

@@ -3,6 +3,7 @@ export * from './date-operations/combine-dates';
 export * from './date-operations/diff-dates';
 export * from './full-date/create-full-date';
 export * from './full-date/date-like';
+export * from './full-date/date-transforms';
 export * from './full-date/format-presets';
 export * from './full-date/full-date-shape';
 export * from './full-date/is-valid-full-date';

package/package.json

@@ -1,6 +1,6 @@
 {
     "name": "date-vir",
-    "version": "0.5.0",
+    "version": "0.7.0",
     "description": "Easy and explicit dates and times",
     "keywords": [
         "date",