date-vir 0.6.0 → 0.8.0

package/dist/cjs/extra-utils/now-in-iso-string.js

@@ -0,0 +1,14 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.getNowInIsoString = void 0;
+const create_full_date_1 = require("../full-date/create-full-date");
+const primitive_conversions_1 = require("../full-date/primitive-conversions");
+const timezones_1 = require("../timezone/timezones");
+function getNowInIsoString() {
+    /**
+     * The time zone doesn't matter here because the ISO string will be identical for a given date
+     * no matter what its timezone is.
+     */
+    return (0, primitive_conversions_1.toIsoString)((0, create_full_date_1.getNowFullDate)(timezones_1.utcTimezone));
+}
+exports.getNowInIsoString = getNowInIsoString;

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/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

@@ -17,6 +17,7 @@ Object.defineProperty(exports, "__esModule", { value: true });
 __exportStar(require("./date-operations/calculate-relative-date"), exports);
 __exportStar(require("./date-operations/combine-dates"), exports);
 __exportStar(require("./date-operations/diff-dates"), exports);
+__exportStar(require("./extra-utils/now-in-iso-string"), exports);
 __exportStar(require("./full-date/create-full-date"), exports);
 __exportStar(require("./full-date/date-like"), exports);
 __exportStar(require("./full-date/date-transforms"), exports);

package/dist/esm/extra-utils/now-in-iso-string.d.ts

@@ -0,0 +1,2 @@
+import { UtcIsoString } from '../full-date/string-format-types';
+export declare function getNowInIsoString(): UtcIsoString;

package/dist/esm/extra-utils/now-in-iso-string.js

@@ -0,0 +1,10 @@
+import { getNowFullDate } from '../full-date/create-full-date';
+import { toIsoString } from '../full-date/primitive-conversions';
+import { utcTimezone } from '../timezone/timezones';
+export function getNowInIsoString() {
+    /**
+     * The time zone doesn't matter here because the ISO string will be identical for a given date
+     * no matter what its timezone is.
+     */
+    return toIsoString(getNowFullDate(utcTimezone));
+}

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/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

@@ -1,6 +1,7 @@
 export * from './date-operations/calculate-relative-date';
 export * from './date-operations/combine-dates';
 export * from './date-operations/diff-dates';
+export * from './extra-utils/now-in-iso-string';
 export * from './full-date/create-full-date';
 export * from './full-date/date-like';
 export * from './full-date/date-transforms';

package/dist/esm/index.js

@@ -1,6 +1,7 @@
 export * from './date-operations/calculate-relative-date';
 export * from './date-operations/combine-dates';
 export * from './date-operations/diff-dates';
+export * from './extra-utils/now-in-iso-string';
 export * from './full-date/create-full-date';
 export * from './full-date/date-like';
 export * from './full-date/date-transforms';

package/package.json

@@ -1,6 +1,6 @@
 {
     "name": "date-vir",
-    "version": "0.6.0",
+    "version": "0.8.0",
     "description": "Easy and explicit dates and times",
     "keywords": [
         "date",
@@ -40,15 +40,15 @@
         "test:watch": "web-test-runner --watch --color --config configs/web-test-runner.config.mjs"
     },
     "dependencies": {
-        "@augment-vir/common": "^16.2.0",
+        "@augment-vir/common": "^16.3.0",
         "@types/luxon": "^3.3.1",
-        "luxon": "^3.3.0",
+        "luxon": "^3.4.0",
         "object-shape-tester": "^0.4.2",
         "type-fest": "^4.2.0"
     },
     "devDependencies": {
-        "@augment-vir/browser": "^16.2.0",
-        "@augment-vir/browser-testing": "^16.2.0",
+        "@augment-vir/browser": "^16.3.0",
+        "@augment-vir/browser-testing": "^16.3.0",
         "@open-wc/testing": "^3.2.0",
         "@types/chai": "^4.3.5",
         "@types/mocha": "^10.0.1",
@@ -57,9 +57,9 @@
         "@web/test-runner-commands": "^0.8.0",
         "@web/test-runner-playwright": "^0.10.1",
         "@web/test-runner-visual-regression": "^0.8.2",
-        "cspell": "^6.31.3",
+        "cspell": "^7.0.0",
         "element-vir": "^16.3.1",
-        "esbuild": "^0.19.0",
+        "esbuild": "^0.19.1",
         "istanbul-smart-text-reporter": "^1.1.2",
         "markdown-code-example-inserter": "^0.3.1",
         "npm-check-updates": "^16.10.18",