@deephaven/jsapi-utils 0.12.1-beta.6

package/LICENSE

@@ -0,0 +1,176 @@
+                                 Apache License
+                           Version 2.0, January 2004
+                        http://www.apache.org/licenses/
+
+   TERMS AND CONDITIONS FOR USE, REPRODUCTION, AND DISTRIBUTION
+
+   1. Definitions.
+
+      "License" shall mean the terms and conditions for use, reproduction,
+      and distribution as defined by Sections 1 through 9 of this document.
+
+      "Licensor" shall mean the copyright owner or entity authorized by
+      the copyright owner that is granting the License.
+
+      "Legal Entity" shall mean the union of the acting entity and all
+      other entities that control, are controlled by, or are under common
+      control with that entity. For the purposes of this definition,
+      "control" means (i) the power, direct or indirect, to cause the
+      direction or management of such entity, whether by contract or
+      otherwise, or (ii) ownership of fifty percent (50%) or more of the
+      outstanding shares, or (iii) beneficial ownership of such entity.
+
+      "You" (or "Your") shall mean an individual or Legal Entity
+      exercising permissions granted by this License.
+
+      "Source" form shall mean the preferred form for making modifications,
+      including but not limited to software source code, documentation
+      source, and configuration files.
+
+      "Object" form shall mean any form resulting from mechanical
+      transformation or translation of a Source form, including but
+      not limited to compiled object code, generated documentation,
+      and conversions to other media types.
+
+      "Work" shall mean the work of authorship, whether in Source or
+      Object form, made available under the License, as indicated by a
+      copyright notice that is included in or attached to the work
+      (an example is provided in the Appendix below).
+
+      "Derivative Works" shall mean any work, whether in Source or Object
+      form, that is based on (or derived from) the Work and for which the
+      editorial revisions, annotations, elaborations, or other modifications
+      represent, as a whole, an original work of authorship. For the purposes
+      of this License, Derivative Works shall not include works that remain
+      separable from, or merely link (or bind by name) to the interfaces of,
+      the Work and Derivative Works thereof.
+
+      "Contribution" shall mean any work of authorship, including
+      the original version of the Work and any modifications or additions
+      to that Work or Derivative Works thereof, that is intentionally
+      submitted to Licensor for inclusion in the Work by the copyright owner
+      or by an individual or Legal Entity authorized to submit on behalf of
+      the copyright owner. For the purposes of this definition, "submitted"
+      means any form of electronic, verbal, or written communication sent
+      to the Licensor or its representatives, including but not limited to
+      communication on electronic mailing lists, source code control systems,
+      and issue tracking systems that are managed by, or on behalf of, the
+      Licensor for the purpose of discussing and improving the Work, but
+      excluding communication that is conspicuously marked or otherwise
+      designated in writing by the copyright owner as "Not a Contribution."
+
+      "Contributor" shall mean Licensor and any individual or Legal Entity
+      on behalf of whom a Contribution has been received by Licensor and
+      subsequently incorporated within the Work.
+
+   2. Grant of Copyright License. Subject to the terms and conditions of
+      this License, each Contributor hereby grants to You a perpetual,
+      worldwide, non-exclusive, no-charge, royalty-free, irrevocable
+      copyright license to reproduce, prepare Derivative Works of,
+      publicly display, publicly perform, sublicense, and distribute the
+      Work and such Derivative Works in Source or Object form.
+
+   3. Grant of Patent License. Subject to the terms and conditions of
+      this License, each Contributor hereby grants to You a perpetual,
+      worldwide, non-exclusive, no-charge, royalty-free, irrevocable
+      (except as stated in this section) patent license to make, have made,
+      use, offer to sell, sell, import, and otherwise transfer the Work,
+      where such license applies only to those patent claims licensable
+      by such Contributor that are necessarily infringed by their
+      Contribution(s) alone or by combination of their Contribution(s)
+      with the Work to which such Contribution(s) was submitted. If You
+      institute patent litigation against any entity (including a
+      cross-claim or counterclaim in a lawsuit) alleging that the Work
+      or a Contribution incorporated within the Work constitutes direct
+      or contributory patent infringement, then any patent licenses
+      granted to You under this License for that Work shall terminate
+      as of the date such litigation is filed.
+
+   4. Redistribution. You may reproduce and distribute copies of the
+      Work or Derivative Works thereof in any medium, with or without
+      modifications, and in Source or Object form, provided that You
+      meet the following conditions:
+
+      (a) You must give any other recipients of the Work or
+          Derivative Works a copy of this License; and
+
+      (b) You must cause any modified files to carry prominent notices
+          stating that You changed the files; and
+
+      (c) You must retain, in the Source form of any Derivative Works
+          that You distribute, all copyright, patent, trademark, and
+          attribution notices from the Source form of the Work,
+          excluding those notices that do not pertain to any part of
+          the Derivative Works; and
+
+      (d) If the Work includes a "NOTICE" text file as part of its
+          distribution, then any Derivative Works that You distribute must
+          include a readable copy of the attribution notices contained
+          within such NOTICE file, excluding those notices that do not
+          pertain to any part of the Derivative Works, in at least one
+          of the following places: within a NOTICE text file distributed
+          as part of the Derivative Works; within the Source form or
+          documentation, if provided along with the Derivative Works; or,
+          within a display generated by the Derivative Works, if and
+          wherever such third-party notices normally appear. The contents
+          of the NOTICE file are for informational purposes only and
+          do not modify the License. You may add Your own attribution
+          notices within Derivative Works that You distribute, alongside
+          or as an addendum to the NOTICE text from the Work, provided
+          that such additional attribution notices cannot be construed
+          as modifying the License.
+
+      You may add Your own copyright statement to Your modifications and
+      may provide additional or different license terms and conditions
+      for use, reproduction, or distribution of Your modifications, or
+      for any such Derivative Works as a whole, provided Your use,
+      reproduction, and distribution of the Work otherwise complies with
+      the conditions stated in this License.
+
+   5. Submission of Contributions. Unless You explicitly state otherwise,
+      any Contribution intentionally submitted for inclusion in the Work
+      by You to the Licensor shall be under the terms and conditions of
+      this License, without any additional terms or conditions.
+      Notwithstanding the above, nothing herein shall supersede or modify
+      the terms of any separate license agreement you may have executed
+      with Licensor regarding such Contributions.
+
+   6. Trademarks. This License does not grant permission to use the trade
+      names, trademarks, service marks, or product names of the Licensor,
+      except as required for reasonable and customary use in describing the
+      origin of the Work and reproducing the content of the NOTICE file.
+
+   7. Disclaimer of Warranty. Unless required by applicable law or
+      agreed to in writing, Licensor provides the Work (and each
+      Contributor provides its Contributions) on an "AS IS" BASIS,
+      WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or
+      implied, including, without limitation, any warranties or conditions
+      of TITLE, NON-INFRINGEMENT, MERCHANTABILITY, or FITNESS FOR A
+      PARTICULAR PURPOSE. You are solely responsible for determining the
+      appropriateness of using or redistributing the Work and assume any
+      risks associated with Your exercise of permissions under this License.
+
+   8. Limitation of Liability. In no event and under no legal theory,
+      whether in tort (including negligence), contract, or otherwise,
+      unless required by applicable law (such as deliberate and grossly
+      negligent acts) or agreed to in writing, shall any Contributor be
+      liable to You for damages, including any direct, indirect, special,
+      incidental, or consequential damages of any character arising as a
+      result of this License or out of the use or inability to use the
+      Work (including but not limited to damages for loss of goodwill,
+      work stoppage, computer failure or malfunction, or any and all
+      other commercial damages or losses), even if such Contributor
+      has been advised of the possibility of such damages.
+
+   9. Accepting Warranty or Additional Liability. While redistributing
+      the Work or Derivative Works thereof, You may choose to offer,
+      and charge a fee for, acceptance of support, warranty, indemnity,
+      or other liability obligations and/or rights consistent with this
+      License. However, in accepting such obligations, You may act only
+      on Your own behalf and on Your sole responsibility, not on behalf
+      of any other Contributor, and only if You agree to indemnify,
+      defend, and hold each Contributor harmless for any liability
+      incurred by, or claims asserted against, such Contributor by reason
+      of your accepting any such warranty or additional liability.
+
+   END OF TERMS AND CONDITIONS

package/README.md

@@ -0,0 +1,23 @@
+# @deephaven/jsapi-utils
+
+A library with some JS utility methods for interacting with the JSAPI.
+
+## Install
+
+```bash
+npm install --save @deephaven/jsapi-utils
+```
+
+## Usage
+
+```javascript
+import { TableUtils } from '@deephaven/jsapi-utils';
+
+if (TableUtils.isDateType(columnType)) {
+  console.log('Date type', columnType);
+} else if (TableUtils.isNumberType(columnType)) {
+  console.log('Number type', columnType);
+} else {
+  console.log('Unrecognized type', columnType);
+}
+```

package/dist/DateUtils.d.ts

@@ -0,0 +1,82 @@
+import type { DateWrapper } from '@deephaven/jsapi-shim';
+interface DateParts<T> {
+    year: T;
+    month: T;
+    date: T;
+    hours: T;
+    minutes: T;
+    seconds: T;
+    nanos: T;
+}
+export declare class DateUtils {
+    static FULL_DATE_FORMAT: string;
+    static months: string[];
+    /**
+     *
+     * @param timeZone The time zone to parse this time in. E.g. America/New_York
+     * @param year The year for the date
+     * @param month The month, starting at 0
+     * @param day The day, starting at 1
+     * @param hour The hours
+     * @param minute The minutes
+     * @param second The seconds
+     * @param ns The nanoseconds
+     */
+    static makeDateWrapper(timeZone: string, year: number, month?: number, day?: number, hour?: number, minute?: number, second?: number, ns?: number): DateWrapper;
+    /**
+     * Takes the string the user entered and returns the next nanos value
+     * @param nanoString The nano string to get the next one of
+     * @returns The value of the next nanos
+     */
+    static getNextNanos(nanoString: string): number;
+    /**
+     * @param components The string components that were parsed from the original string
+     * @param values The values that were parsed from the components
+     * @param timeZone The time zone to parse the date in. E.g. America/New_York
+     * @returns Returns the DateWrapper for the next date, or null if a full date was passed in
+     */
+    static getNextDate(components: DateParts<string>, values: DateParts<number>, timeZone: string): DateWrapper | null;
+    /**
+     * Get the JS month value for the provided string.
+     * Matches digits or a month name (eg. '1', '01', 'jan', 'january' should all work)
+     * @param monthString The string to parse to a JS month value
+     * @returns number The JS month value, which starts at 0 for january, or NaN if nothing could be parsed
+     */
+    static parseMonth(monthString: string): number;
+    /**
+     * Parse a date object out of the provided string segments.
+     * Also using `parseMonth` to get month names like Aug/August rather than
+     * simply doing `parseInt`.
+     * @param yearString The year part of the string
+     * @param monthString The month part of the string
+     * @param dayString The day part of the string
+     * @param hourString The hour part of the string
+     * @param minuteString The minute part of the string
+     * @param secondString The second part of the string
+     * @param nanoString The milli part of the string
+     */
+    static parseDateValues(yearString: string, monthString: string, dayString: string, hourString: string, minuteString: string, secondString: string, nanoString: string): DateParts<number> | null;
+    /**
+     * Parse out a date time string into it's string components.
+     * Anything that is not captured in the string will be undefined.
+     *
+     * @param dateTimeString The date time string to parse
+     * @returns Containing the date time components
+     */
+    static parseDateTimeString(dateTimeString: string): DateParts<string>;
+    /**
+     * Parses the date range provided from a string of text.
+     * @param text The string to parse the date from. Can be a keyword like "today", or in the format "2018-08-04"
+     * @param timeZone The time zone to parse this range in. E.g. America/New_York
+     * @returns A tuple with the start and end value/null for that date range, or both null
+     */
+    static parseDateRange(text: string, timeZone: string): [DateWrapper, DateWrapper | null] | [null, null];
+    /**
+     * Gets the Js Date object from the provided DateWrapper.
+     * In unit test, DateWrapper is just a number provided in millis, so handles that case.
+     * @param dateWrapper The DateWrapper object, or time in millis
+     */
+    static getJsDate(dateWrapper: DateWrapper | number): Date;
+}
+export default DateUtils;
+//# sourceMappingURL=DateUtils.d.ts.map

package/dist/DateUtils.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"DateUtils.d.ts","sourceRoot":"","sources":["../src/DateUtils.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,uBAAuB,CAAC;AAEzD,UAAU,SAAS,CAAC,CAAC;IACnB,IAAI,EAAE,CAAC,CAAC;IACR,KAAK,EAAE,CAAC,CAAC;IACT,IAAI,EAAE,CAAC,CAAC;IACR,KAAK,EAAE,CAAC,CAAC;IACT,OAAO,EAAE,CAAC,CAAC;IACX,OAAO,EAAE,CAAC,CAAC;IACX,KAAK,EAAE,CAAC,CAAC;CACV;AAED,qBAAa,SAAS;IACpB,MAAM,CAAC,gBAAgB,SAAmC;IAE1D,MAAM,CAAC,MAAM,WAaX;IAEF;;;;;;;;;;OAUG;IACH,MAAM,CAAC,eAAe,CACpB,QAAQ,EAAE,MAAM,EAChB,IAAI,EAAE,MAAM,EACZ,KAAK,SAAI,EACT,GAAG,SAAI,EACP,IAAI,SAAI,EACR,MAAM,SAAI,EACV,MAAM,SAAI,EACV,EAAE,SAAI,GACL,WAAW;IAiBd;;;;OAIG;IACH,MAAM,CAAC,YAAY,CAAC,UAAU,EAAE,MAAM,GAAG,MAAM;IAQ/C;;;;;OAKG;IACH,MAAM,CAAC,WAAW,CAChB,UAAU,EAAE,SAAS,CAAC,MAAM,CAAC,EAC7B,MAAM,EAAE,SAAS,CAAC,MAAM,CAAC,EACzB,QAAQ,EAAE,MAAM,GACf,WAAW,GAAG,IAAI;IA4CrB;;;;;OAKG;IACH,MAAM,CAAC,UAAU,CAAC,WAAW,EAAE,MAAM,GAAG,MAAM;IAqB9C;;;;;;;;;;;OAWG;IACH,MAAM,CAAC,eAAe,CACpB,UAAU,EAAE,MAAM,EAClB,WAAW,EAAE,MAAM,EACnB,SAAS,EAAE,MAAM,EACjB,UAAU,EAAE,MAAM,EAClB,YAAY,EAAE,MAAM,EACpB,YAAY,EAAE,MAAM,EACpB,UAAU,EAAE,MAAM,GACjB,SAAS,CAAC,MAAM,CAAC,GAAG,IAAI;IAwB3B;;;;;;OAMG;IACH,MAAM,CAAC,mBAAmB,CAAC,cAAc,EAAE,MAAM,GAAG,SAAS,CAAC,MAAM,CAAC;IAiCrE;;;;;OAKG;IACH,MAAM,CAAC,cAAc,CACnB,IAAI,EAAE,MAAM,EACZ,QAAQ,EAAE,MAAM,GACf,CAAC,WAAW,EAAE,WAAW,GAAG,IAAI,CAAC,GAAG,CAAC,IAAI,EAAE,IAAI,CAAC;IAwFnD;;;;OAIG;IACH,MAAM,CAAC,SAAS,CAAC,WAAW,EAAE,WAAW,GAAG,MAAM,GAAG,IAAI;CAM1D;AAED,eAAe,SAAS,CAAC"}

package/dist/DateUtils.js

@@ -0,0 +1,284 @@
+function _defineProperty(obj, key, value) { if (key in obj) { Object.defineProperty(obj, key, { value: value, enumerable: true, configurable: true, writable: true }); } else { obj[key] = value; } return obj; }
+
+import dh from '@deephaven/jsapi-shim';
+export class DateUtils {
+  /**
+   *
+   * @param timeZone The time zone to parse this time in. E.g. America/New_York
+   * @param year The year for the date
+   * @param month The month, starting at 0
+   * @param day The day, starting at 1
+   * @param hour The hours
+   * @param minute The minutes
+   * @param second The seconds
+   * @param ns The nanoseconds
+   */
+  static makeDateWrapper(timeZone, year) {
+    var month = arguments.length > 2 && arguments[2] !== undefined ? arguments[2] : 0;
+    var day = arguments.length > 3 && arguments[3] !== undefined ? arguments[3] : 1;
+    var hour = arguments.length > 4 && arguments[4] !== undefined ? arguments[4] : 0;
+    var minute = arguments.length > 5 && arguments[5] !== undefined ? arguments[5] : 0;
+    var second = arguments.length > 6 && arguments[6] !== undefined ? arguments[6] : 0;
+    var ns = arguments.length > 7 && arguments[7] !== undefined ? arguments[7] : 0;
+    var yearString = "".concat(year).padStart(4, '0');
+    var monthString = "".concat(month + 1).padStart(2, '0');
+    var dayString = "".concat(day).padStart(2, '0');
+    var hourString = "".concat(hour).padStart(2, '0');
+    var minuteString = "".concat(minute).padStart(2, '0');
+    var secondString = "".concat(second).padStart(2, '0');
+    var nanoString = "".concat(ns).padStart(9, '0');
+    var dateString = "".concat(yearString, "-").concat(monthString, "-").concat(dayString, " ").concat(hourString, ":").concat(minuteString, ":").concat(secondString, ".").concat(nanoString);
+    return dh.i18n.DateTimeFormat.parse(DateUtils.FULL_DATE_FORMAT, dateString, dh.i18n.TimeZone.getTimeZone(timeZone));
+  }
+  /**
+   * Takes the string the user entered and returns the next nanos value
+   * @param nanoString The nano string to get the next one of
+   * @returns The value of the next nanos
+   */
+
+
+  static getNextNanos(nanoString) {
+    var sigNanos = parseInt(nanoString, 10); // Get the zeroes needed for padding before adding one so we handle overflow properly.
+
+    var zeros = '0'.repeat(9 - nanoString.length);
+    var nextNanoString = "".concat(sigNanos + 1).concat(zeros);
+    return parseInt(nextNanoString, 10);
+  }
+  /**
+   * @param components The string components that were parsed from the original string
+   * @param values The values that were parsed from the components
+   * @param timeZone The time zone to parse the date in. E.g. America/New_York
+   * @returns Returns the DateWrapper for the next date, or null if a full date was passed in
+   */
+
+
+  static getNextDate(components, values, timeZone) {
+    var {
+      year,
+      month,
+      date,
+      hours,
+      minutes,
+      seconds,
+      nanos
+    } = values;
+
+    if (components.nanos != null) {
+      if (components.nanos.length === 9) {
+        // They want an exact match
+        return null;
+      }
+
+      nanos = DateUtils.getNextNanos(components.nanos);
+
+      if (nanos > 999999999) {
+        // There's an overflow, add it to the seconds manually
+        seconds += 1;
+        nanos = 0;
+      }
+    } else if (components.seconds != null) {
+      seconds += 1;
+    } else if (components.minutes != null) {
+      minutes += 1;
+    } else if (components.hours != null) {
+      hours += 1;
+    } else if (components.date != null) {
+      date += 1;
+    } else if (components.month != null) {
+      month += 1;
+    } else {
+      year += 1;
+    } // Use the JS date to handle overflow rather than doing our own logic
+    // Because handling leap years and stuff is a pain
+    // Still need to add nanos after, and the overflow from that is already added to seconds above
+
+
+    var jsDate = new Date(year, month, date, hours, minutes, seconds);
+    return DateUtils.makeDateWrapper(timeZone, jsDate.getFullYear(), jsDate.getMonth(), jsDate.getDate(), jsDate.getHours(), jsDate.getMinutes(), jsDate.getSeconds(), nanos);
+  }
+  /**
+   * Get the JS month value for the provided string.
+   * Matches digits or a month name (eg. '1', '01', 'jan', 'january' should all work)
+   * @param monthString The string to parse to a JS month value
+   * @returns number The JS month value, which starts at 0 for january, or NaN if nothing could be parsed
+   */
+
+
+  static parseMonth(monthString) {
+    var month = parseInt(monthString, 10);
+
+    if (!Number.isNaN(month)) {
+      if (month >= 1 && month <= 12) {
+        return month - 1;
+      }
+
+      return NaN;
+    }
+
+    var cleanMonthString = monthString.trim().toLowerCase();
+
+    if (cleanMonthString.length >= 3) {
+      for (var i = 0; i < DateUtils.months.length; i += 1) {
+        if (DateUtils.months[i].startsWith(cleanMonthString)) {
+          return i;
+        }
+      }
+    }
+
+    return NaN;
+  }
+  /**
+   * Parse a date object out of the provided string segments.
+   * Also using `parseMonth` to get month names like Aug/August rather than
+   * simply doing `parseInt`.
+   * @param yearString The year part of the string
+   * @param monthString The month part of the string
+   * @param dayString The day part of the string
+   * @param hourString The hour part of the string
+   * @param minuteString The minute part of the string
+   * @param secondString The second part of the string
+   * @param nanoString The milli part of the string
+   */
+
+
+  static parseDateValues(yearString, monthString, dayString, hourString, minuteString, secondString, nanoString) {
+    var year = parseInt(yearString, 10);
+    var month = monthString != null ? this.parseMonth(monthString) : 0;
+    var date = dayString != null ? parseInt(dayString, 10) : 1;
+    var hours = hourString != null ? parseInt(hourString, 10) : 0;
+    var minutes = minuteString != null ? parseInt(minuteString, 10) : 0;
+    var seconds = secondString != null ? parseInt(secondString, 10) : 0;
+    var nanos = nanoString != null ? parseInt(nanoString.padEnd(9, '0'), 10) : 0;
+
+    if (Number.isNaN(year) || Number.isNaN(month) || Number.isNaN(date) || Number.isNaN(hours) || Number.isNaN(minutes) || Number.isNaN(seconds) || Number.isNaN(nanos)) {
+      return null;
+    }
+
+    return {
+      year,
+      month,
+      date,
+      hours,
+      minutes,
+      seconds,
+      nanos
+    };
+  }
+  /**
+   * Parse out a date time string into it's string components.
+   * Anything that is not captured in the string will be undefined.
+   *
+   * @param dateTimeString The date time string to parse
+   * @returns Containing the date time components
+   */
+
+
+  static parseDateTimeString(dateTimeString) {
+    var regex = /\s*(\d{4})([-./]([\da-z]+))?([-./](\d{1,2}))?([tT\s](\d{2})([:](\d{2}))?([:](\d{2}))?([.](\d{1,9}))?)?(.*)/;
+    var result = regex.exec(dateTimeString);
+
+    if (result == null) {
+      throw new Error("Unexpected date string: ".concat(dateTimeString));
+    }
+
+    var [, year,, month,, date,, hours,, minutes,, seconds,, nanos, overflow] = result;
+
+    if (overflow != null && overflow.length > 0) {
+      throw new Error("Unexpected characters after date string '".concat(dateTimeString, "': ").concat(overflow));
+    }
+
+    return {
+      year,
+      month,
+      date,
+      hours,
+      minutes,
+      seconds,
+      nanos
+    };
+  }
+  /**
+   * Parses the date range provided from a string of text.
+   * @param text The string to parse the date from. Can be a keyword like "today", or in the format "2018-08-04"
+   * @param timeZone The time zone to parse this range in. E.g. America/New_York
+   * @returns A tuple with the start and end value/null for that date range, or both null
+   */
+
+
+  static parseDateRange(text, timeZone) {
+    var cleanText = text.trim().toLowerCase();
+
+    if (cleanText.length === 0) {
+      throw new Error('Cannot parse date range from empty string');
+    }
+
+    if (cleanText === 'null') {
+      return [null, null];
+    }
+
+    if (cleanText === 'today') {
+      var now = new Date(Date.now());
+
+      var _startDate = DateUtils.makeDateWrapper(timeZone, now.getFullYear(), now.getMonth(), now.getDate());
+
+      var _endDate = DateUtils.makeDateWrapper(timeZone, now.getFullYear(), now.getMonth(), now.getDate() + 1);
+
+      return [_startDate, _endDate];
+    }
+
+    if (cleanText === 'yesterday') {
+      var _now = new Date(Date.now());
+
+      var _startDate2 = DateUtils.makeDateWrapper(timeZone, _now.getFullYear(), _now.getMonth(), _now.getDate() - 1);
+
+      var _endDate2 = DateUtils.makeDateWrapper(timeZone, _now.getFullYear(), _now.getMonth(), _now.getDate());
+
+      return [_startDate2, _endDate2];
+    }
+
+    if (cleanText === 'now') {
+      var _now2 = new Date(Date.now());
+
+      var date = dh.DateWrapper.ofJsDate(_now2);
+      return [date, null];
+    }
+
+    var components = DateUtils.parseDateTimeString(cleanText);
+
+    if (components.year == null && components.month == null && components.date == null) {
+      throw new Error("Unable to extract year, month, or day ".concat(cleanText));
+    }
+
+    var values = DateUtils.parseDateValues(components.year, components.month, components.date, components.hours, components.minutes, components.seconds, components.nanos);
+
+    if (values == null) {
+      throw new Error("Unable to extract date values from ".concat(components));
+    }
+
+    var startDate = DateUtils.makeDateWrapper(timeZone, values.year, values.month, values.date, values.hours, values.minutes, values.seconds, values.nanos);
+    var endDate = DateUtils.getNextDate(components, values, timeZone);
+    return [startDate, endDate];
+  }
+  /**
+   * Gets the Js Date object from the provided DateWrapper.
+   * In unit test, DateWrapper is just a number provided in millis, so handles that case.
+   * @param dateWrapper The DateWrapper object, or time in millis
+   */
+
+
+  static getJsDate(dateWrapper) {
+    if (typeof dateWrapper === 'number') {
+      return new Date(dateWrapper);
+    }
+
+    return dateWrapper.asDate();
+  }
+
+}
+
+_defineProperty(DateUtils, "FULL_DATE_FORMAT", 'yyyy-MM-dd HH:mm:ss.SSSSSSSSS');
+
+_defineProperty(DateUtils, "months", ['january', 'february', 'march', 'april', 'may', 'june', 'july', 'august', 'september', 'october', 'november', 'december']);
+
+export default DateUtils;
+//# sourceMappingURL=DateUtils.js.map

package/dist/DateUtils.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/DateUtils.ts"],"names":["dh","DateUtils","makeDateWrapper","timeZone","year","month","day","hour","minute","second","ns","yearString","padStart","monthString","dayString","hourString","minuteString","secondString","nanoString","dateString","i18n","DateTimeFormat","parse","FULL_DATE_FORMAT","TimeZone","getTimeZone","getNextNanos","sigNanos","parseInt","zeros","repeat","length","nextNanoString","getNextDate","components","values","date","hours","minutes","seconds","nanos","jsDate","Date","getFullYear","getMonth","getDate","getHours","getMinutes","getSeconds","parseMonth","Number","isNaN","NaN","cleanMonthString","trim","toLowerCase","i","months","startsWith","parseDateValues","padEnd","parseDateTimeString","dateTimeString","regex","result","exec","Error","overflow","parseDateRange","text","cleanText","now","startDate","endDate","DateWrapper","ofJsDate","getJsDate","dateWrapper","asDate"],"mappings":"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","sourcesContent":["import dh from '@deephaven/jsapi-shim';\nimport type { DateWrapper } from '@deephaven/jsapi-shim';\n\ninterface DateParts<T> {\n  year: T;\n  month: T;\n  date: T;\n  hours: T;\n  minutes: T;\n  seconds: T;\n  nanos: T;\n}\n\nexport class DateUtils {\n  static FULL_DATE_FORMAT = 'yyyy-MM-dd HH:mm:ss.SSSSSSSSS';\n\n  static months = [\n    'january',\n    'february',\n    'march',\n    'april',\n    'may',\n    'june',\n    'july',\n    'august',\n    'september',\n    'october',\n    'november',\n    'december',\n  ];\n\n  /**\n   *\n   * @param timeZone The time zone to parse this time in. E.g. America/New_York\n   * @param year The year for the date\n   * @param month The month, starting at 0\n   * @param day The day, starting at 1\n   * @param hour The hours\n   * @param minute The minutes\n   * @param second The seconds\n   * @param ns The nanoseconds\n   */\n  static makeDateWrapper(\n    timeZone: string,\n    year: number,\n    month = 0,\n    day = 1,\n    hour = 0,\n    minute = 0,\n    second = 0,\n    ns = 0\n  ): DateWrapper {\n    const yearString = `${year}`.padStart(4, '0');\n    const monthString = `${month + 1}`.padStart(2, '0');\n    const dayString = `${day}`.padStart(2, '0');\n    const hourString = `${hour}`.padStart(2, '0');\n    const minuteString = `${minute}`.padStart(2, '0');\n    const secondString = `${second}`.padStart(2, '0');\n    const nanoString = `${ns}`.padStart(9, '0');\n\n    const dateString = `${yearString}-${monthString}-${dayString} ${hourString}:${minuteString}:${secondString}.${nanoString}`;\n    return dh.i18n.DateTimeFormat.parse(\n      DateUtils.FULL_DATE_FORMAT,\n      dateString,\n      dh.i18n.TimeZone.getTimeZone(timeZone)\n    );\n  }\n\n  /**\n   * Takes the string the user entered and returns the next nanos value\n   * @param nanoString The nano string to get the next one of\n   * @returns The value of the next nanos\n   */\n  static getNextNanos(nanoString: string): number {\n    const sigNanos = parseInt(nanoString, 10);\n    // Get the zeroes needed for padding before adding one so we handle overflow properly.\n    const zeros = '0'.repeat(9 - nanoString.length);\n    const nextNanoString = `${sigNanos + 1}${zeros}`;\n    return parseInt(nextNanoString, 10);\n  }\n\n  /**\n   * @param components The string components that were parsed from the original string\n   * @param values The values that were parsed from the components\n   * @param timeZone The time zone to parse the date in. E.g. America/New_York\n   * @returns Returns the DateWrapper for the next date, or null if a full date was passed in\n   */\n  static getNextDate(\n    components: DateParts<string>,\n    values: DateParts<number>,\n    timeZone: string\n  ): DateWrapper | null {\n    let { year, month, date, hours, minutes, seconds, nanos } = values;\n\n    if (components.nanos != null) {\n      if (components.nanos.length === 9) {\n        // They want an exact match\n        return null;\n      }\n      nanos = DateUtils.getNextNanos(components.nanos);\n      if (nanos > 999999999) {\n        // There's an overflow, add it to the seconds manually\n        seconds += 1;\n        nanos = 0;\n      }\n    } else if (components.seconds != null) {\n      seconds += 1;\n    } else if (components.minutes != null) {\n      minutes += 1;\n    } else if (components.hours != null) {\n      hours += 1;\n    } else if (components.date != null) {\n      date += 1;\n    } else if (components.month != null) {\n      month += 1;\n    } else {\n      year += 1;\n    }\n\n    // Use the JS date to handle overflow rather than doing our own logic\n    // Because handling leap years and stuff is a pain\n    // Still need to add nanos after, and the overflow from that is already added to seconds above\n    const jsDate = new Date(year, month, date, hours, minutes, seconds);\n    return DateUtils.makeDateWrapper(\n      timeZone,\n      jsDate.getFullYear(),\n      jsDate.getMonth(),\n      jsDate.getDate(),\n      jsDate.getHours(),\n      jsDate.getMinutes(),\n      jsDate.getSeconds(),\n      nanos\n    );\n  }\n\n  /**\n   * Get the JS month value for the provided string.\n   * Matches digits or a month name (eg. '1', '01', 'jan', 'january' should all work)\n   * @param monthString The string to parse to a JS month value\n   * @returns number The JS month value, which starts at 0 for january, or NaN if nothing could be parsed\n   */\n  static parseMonth(monthString: string): number {\n    const month = parseInt(monthString, 10);\n    if (!Number.isNaN(month)) {\n      if (month >= 1 && month <= 12) {\n        return month - 1;\n      }\n      return NaN;\n    }\n\n    const cleanMonthString = monthString.trim().toLowerCase();\n    if (cleanMonthString.length >= 3) {\n      for (let i = 0; i < DateUtils.months.length; i += 1) {\n        if (DateUtils.months[i].startsWith(cleanMonthString)) {\n          return i;\n        }\n      }\n    }\n\n    return NaN;\n  }\n\n  /**\n   * Parse a date object out of the provided string segments.\n   * Also using `parseMonth` to get month names like Aug/August rather than\n   * simply doing `parseInt`.\n   * @param yearString The year part of the string\n   * @param monthString The month part of the string\n   * @param dayString The day part of the string\n   * @param hourString The hour part of the string\n   * @param minuteString The minute part of the string\n   * @param secondString The second part of the string\n   * @param nanoString The milli part of the string\n   */\n  static parseDateValues(\n    yearString: string,\n    monthString: string,\n    dayString: string,\n    hourString: string,\n    minuteString: string,\n    secondString: string,\n    nanoString: string\n  ): DateParts<number> | null {\n    const year = parseInt(yearString, 10);\n    const month = monthString != null ? this.parseMonth(monthString) : 0;\n    const date = dayString != null ? parseInt(dayString, 10) : 1;\n    const hours = hourString != null ? parseInt(hourString, 10) : 0;\n    const minutes = minuteString != null ? parseInt(minuteString, 10) : 0;\n    const seconds = secondString != null ? parseInt(secondString, 10) : 0;\n    const nanos =\n      nanoString != null ? parseInt(nanoString.padEnd(9, '0'), 10) : 0;\n    if (\n      Number.isNaN(year) ||\n      Number.isNaN(month) ||\n      Number.isNaN(date) ||\n      Number.isNaN(hours) ||\n      Number.isNaN(minutes) ||\n      Number.isNaN(seconds) ||\n      Number.isNaN(nanos)\n    ) {\n      return null;\n    }\n\n    return { year, month, date, hours, minutes, seconds, nanos };\n  }\n\n  /**\n   * Parse out a date time string into it's string components.\n   * Anything that is not captured in the string will be undefined.\n   *\n   * @param dateTimeString The date time string to parse\n   * @returns Containing the date time components\n   */\n  static parseDateTimeString(dateTimeString: string): DateParts<string> {\n    const regex = /\\s*(\\d{4})([-./]([\\da-z]+))?([-./](\\d{1,2}))?([tT\\s](\\d{2})([:](\\d{2}))?([:](\\d{2}))?([.](\\d{1,9}))?)?(.*)/;\n    const result = regex.exec(dateTimeString);\n    if (result == null) {\n      throw new Error(`Unexpected date string: ${dateTimeString}`);\n    }\n\n    const [\n      ,\n      year,\n      ,\n      month,\n      ,\n      date,\n      ,\n      hours,\n      ,\n      minutes,\n      ,\n      seconds,\n      ,\n      nanos,\n      overflow,\n    ] = result;\n    if (overflow != null && overflow.length > 0) {\n      throw new Error(\n        `Unexpected characters after date string '${dateTimeString}': ${overflow}`\n      );\n    }\n\n    return { year, month, date, hours, minutes, seconds, nanos };\n  }\n\n  /**\n   * Parses the date range provided from a string of text.\n   * @param text The string to parse the date from. Can be a keyword like \"today\", or in the format \"2018-08-04\"\n   * @param timeZone The time zone to parse this range in. E.g. America/New_York\n   * @returns A tuple with the start and end value/null for that date range, or both null\n   */\n  static parseDateRange(\n    text: string,\n    timeZone: string\n  ): [DateWrapper, DateWrapper | null] | [null, null] {\n    const cleanText = text.trim().toLowerCase();\n    if (cleanText.length === 0) {\n      throw new Error('Cannot parse date range from empty string');\n    }\n\n    if (cleanText === 'null') {\n      return [null, null];\n    }\n\n    if (cleanText === 'today') {\n      const now = new Date(Date.now());\n      const startDate = DateUtils.makeDateWrapper(\n        timeZone,\n        now.getFullYear(),\n        now.getMonth(),\n        now.getDate()\n      );\n      const endDate = DateUtils.makeDateWrapper(\n        timeZone,\n        now.getFullYear(),\n        now.getMonth(),\n        now.getDate() + 1\n      );\n      return [startDate, endDate];\n    }\n\n    if (cleanText === 'yesterday') {\n      const now = new Date(Date.now());\n      const startDate = DateUtils.makeDateWrapper(\n        timeZone,\n        now.getFullYear(),\n        now.getMonth(),\n        now.getDate() - 1\n      );\n      const endDate = DateUtils.makeDateWrapper(\n        timeZone,\n        now.getFullYear(),\n        now.getMonth(),\n        now.getDate()\n      );\n      return [startDate, endDate];\n    }\n\n    if (cleanText === 'now') {\n      const now = new Date(Date.now());\n      const date = dh.DateWrapper.ofJsDate(now);\n      return [date, null];\n    }\n\n    const components = DateUtils.parseDateTimeString(cleanText);\n    if (\n      components.year == null &&\n      components.month == null &&\n      components.date == null\n    ) {\n      throw new Error(`Unable to extract year, month, or day ${cleanText}`);\n    }\n\n    const values = DateUtils.parseDateValues(\n      components.year,\n      components.month,\n      components.date,\n      components.hours,\n      components.minutes,\n      components.seconds,\n      components.nanos\n    );\n\n    if (values == null) {\n      throw new Error(`Unable to extract date values from ${components}`);\n    }\n\n    const startDate = DateUtils.makeDateWrapper(\n      timeZone,\n      values.year,\n      values.month,\n      values.date,\n      values.hours,\n      values.minutes,\n      values.seconds,\n      values.nanos\n    );\n\n    const endDate = DateUtils.getNextDate(components, values, timeZone);\n    return [startDate, endDate];\n  }\n\n  /**\n   * Gets the Js Date object from the provided DateWrapper.\n   * In unit test, DateWrapper is just a number provided in millis, so handles that case.\n   * @param dateWrapper The DateWrapper object, or time in millis\n   */\n  static getJsDate(dateWrapper: DateWrapper | number): Date {\n    if (typeof dateWrapper === 'number') {\n      return new Date(dateWrapper);\n    }\n    return dateWrapper.asDate();\n  }\n}\n\nexport default DateUtils;\n"],"file":"DateUtils.js"}