dolphindb 0.0.9 → 0.0.12

package/browser.d.ts

@@ -151,6 +151,9 @@ export declare class DdbVoid extends DdbObj<undefined> {
 export declare class DdbBool extends DdbObj<boolean> {
     constructor(value: boolean);
 }
+export declare class DdbChar extends DdbObj<string> {
+    constructor(value: string);
+}
 export declare class DdbInt extends DdbObj<number> {
     constructor(value: number);
 }
@@ -163,17 +166,26 @@ export declare class DdbLong extends DdbObj<bigint> {
 export declare class DdbDouble extends DdbObj<number> {
     constructor(value: number);
 }
+export declare class DdbDateTime extends DdbObj<number> {
+    constructor(value: number);
+}
+export declare class DdbTimeStamp extends DdbObj<bigint> {
+    constructor(value: bigint);
+}
+export declare class DdbNanoTimeStamp extends DdbObj<bigint> {
+    constructor(value: bigint);
+}
 export declare class DdbVectorInt extends DdbObj<Int32Array> {
-    constructor(value: number[]);
+    constructor(value: number[], name?: string);
 }
 export declare class DdbVectorString extends DdbObj<string[]> {
-    constructor(value: string[]);
+    constructor(value: string[], name?: string);
 }
 export declare class DdbVectorDouble extends DdbObj<Float64Array> {
-    constructor(value: number[]);
+    constructor(value: number[], name?: string);
 }
 export declare class DdbVectorAny extends DdbObj {
-    constructor(value: DdbObj<DdbValue>[]);
+    constructor(value: DdbObj<DdbValue>[], name?: string);
 }
 export declare class DdbPair extends DdbObj<Int32Array> {
     constructor(l: number, r?: number);
@@ -181,8 +193,16 @@ export declare class DdbPair extends DdbObj<Int32Array> {
 export declare class DdbFunction extends DdbObj<DdbFunctionDefValue> {
     constructor(name: string, type: DdbFunctionType);
 }
-export declare function date2str(date: number): string;
+export declare function date2str(date: number, format?: string): string;
+export declare function datetime2str(datetime: number, format?: string): string;
 export declare function timestamp2str(timestamp: bigint): string;
+export declare function nanotimestamp2str(nanotimestamp: bigint, format?: string): string;
+/** parse nano timestamp string to bigint value
+    - str: nano timestamp string, 如果为空字符串会返回对应的空值 (nulls.int64)
+    - format?: Format string up to and including seconds of the passed string, default is `YYYY.MM.DD HH:mm:ss`
+        https://day.js.org/docs/en/parse/string-format#list-of-all-available-parsing-tokens
+*/
+export declare function str2nanotimestamp(str: string, format?: string): bigint;
 export declare class DDB {
     /** 当前的 session id (http 或 tcp) */
     sid: string;

package/browser.js

@@ -1,8 +1,10 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.ddb = exports.DDB = exports.timestamp2str = exports.date2str = exports.DdbFunction = exports.DdbPair = exports.DdbVectorAny = exports.DdbVectorDouble = exports.DdbVectorString = exports.DdbVectorInt = exports.DdbDouble = exports.DdbLong = exports.DdbString = exports.DdbInt = exports.DdbBool = exports.DdbVoid = exports.DdbObj = exports.timezone_offset = exports.nulls = exports.DdbFunctionType = exports.DdbType = exports.DdbForm = void 0;
+exports.ddb = exports.DDB = exports.str2nanotimestamp = exports.nanotimestamp2str = exports.timestamp2str = exports.datetime2str = exports.date2str = exports.DdbFunction = exports.DdbPair = exports.DdbVectorAny = exports.DdbVectorDouble = exports.DdbVectorString = exports.DdbVectorInt = exports.DdbNanoTimeStamp = exports.DdbTimeStamp = exports.DdbDateTime = exports.DdbDouble = exports.DdbLong = exports.DdbString = exports.DdbInt = exports.DdbChar = exports.DdbBool = exports.DdbVoid = exports.DdbObj = exports.timezone_offset = exports.nulls = exports.DdbFunctionType = exports.DdbType = exports.DdbForm = void 0;
 const tslib_1 = require("tslib");
 const dayjs_1 = tslib_1.__importDefault(require("dayjs"));
+const customParseFormat_js_1 = tslib_1.__importDefault(require("dayjs/plugin/customParseFormat.js"));
+dayjs_1.default.extend(customParseFormat_js_1.default);
 require("xshell/prototype.browser");
 const utils_browser_1 = require("xshell/utils.browser");
 var DdbForm;
@@ -844,7 +846,7 @@ class DdbObj {
     }
     to_dict() {
         if (this.form !== DdbForm.dict)
-            throw new Error('this.form 不是 dict, 不能转换为 Object');
+            throw new Error('this.form is not DdbForm.dict, cannot convert to Object');
         const [{ value: keys }, { value: values }] = this.value;
         let obj = {};
         for (let i = 0; i < this.rows; i++)
@@ -880,6 +882,17 @@ class DdbBool extends DdbObj {
     }
 }
 exports.DdbBool = DdbBool;
+class DdbChar extends DdbObj {
+    constructor(value) {
+        super({
+            form: DdbForm.scalar,
+            type: DdbType.char,
+            length: 1,
+            value,
+        });
+    }
+}
+exports.DdbChar = DdbChar;
 class DdbInt extends DdbObj {
     constructor(value) {
         super({
@@ -924,8 +937,41 @@ class DdbDouble extends DdbObj {
     }
 }
 exports.DdbDouble = DdbDouble;
-class DdbVectorInt extends DdbObj {
+class DdbDateTime extends DdbObj {
+    constructor(value) {
+        super({
+            form: DdbForm.scalar,
+            type: DdbType.datetime,
+            length: 4,
+            value
+        });
+    }
+}
+exports.DdbDateTime = DdbDateTime;
+class DdbTimeStamp extends DdbObj {
     constructor(value) {
+        super({
+            form: DdbForm.scalar,
+            type: DdbType.timestamp,
+            length: 8,
+            value
+        });
+    }
+}
+exports.DdbTimeStamp = DdbTimeStamp;
+class DdbNanoTimeStamp extends DdbObj {
+    constructor(value) {
+        super({
+            form: DdbForm.scalar,
+            type: DdbType.nanotimestamp,
+            length: 8,
+            value
+        });
+    }
+}
+exports.DdbNanoTimeStamp = DdbNanoTimeStamp;
+class DdbVectorInt extends DdbObj {
+    constructor(value, name) {
         super({
             form: DdbForm.vector,
             type: DdbType.int,
@@ -933,45 +979,49 @@ class DdbVectorInt extends DdbObj {
             rows: value.length,
             cols: 1,
             value: Int32Array.from(value),
+            name,
         });
     }
 }
 exports.DdbVectorInt = DdbVectorInt;
 class DdbVectorString extends DdbObj {
-    constructor(value) {
+    constructor(value, name) {
         super({
             form: DdbForm.vector,
             type: DdbType.string,
             length: 0,
             rows: value.length,
             cols: 1,
-            value
+            value,
+            name,
         });
     }
 }
 exports.DdbVectorString = DdbVectorString;
 class DdbVectorDouble extends DdbObj {
-    constructor(value) {
+    constructor(value, name) {
         super({
             form: DdbForm.vector,
             type: DdbType.double,
             length: 0,
             rows: value.length,
             cols: 1,
-            value: Float64Array.from(value)
+            value: Float64Array.from(value),
+            name,
         });
     }
 }
 exports.DdbVectorDouble = DdbVectorDouble;
 class DdbVectorAny extends DdbObj {
-    constructor(value) {
+    constructor(value, name) {
         super({
             form: DdbForm.vector,
             type: DdbType.any,
             length: 0,
             rows: value.length,
             cols: 1,
-            value
+            value,
+            name,
         });
     }
 }
@@ -1000,13 +1050,20 @@ class DdbFunction extends DdbObj {
     }
 }
 exports.DdbFunction = DdbFunction;
-function date2str(date) {
+function date2str(date, format = 'YYYY.MM.DD') {
     return date === exports.nulls.int32 ?
         ''
         :
-            (0, dayjs_1.default)(exports.timezone_offset + 1000 * 3600 * 24 * date).format('YYYY.MM.DD');
+            (0, dayjs_1.default)(exports.timezone_offset + 1000 * 3600 * 24 * date).format(format);
 }
 exports.date2str = date2str;
+function datetime2str(datetime, format = 'YYYY.MM.DD HH:mm:ss') {
+    return datetime === exports.nulls.int32 ?
+        ''
+        :
+            (0, dayjs_1.default)(exports.timezone_offset + 1000 * datetime).format(format);
+}
+exports.datetime2str = datetime2str;
 function timestamp2str(timestamp) {
     return timestamp === exports.nulls.int64 ?
         ''
@@ -1014,6 +1071,29 @@ function timestamp2str(timestamp) {
             (0, dayjs_1.default)(exports.timezone_offset + Number(timestamp)).format('YYYY.MM.DD HH:mm:ss.SSS');
 }
 exports.timestamp2str = timestamp2str;
+function nanotimestamp2str(nanotimestamp, format = 'YYYY.MM.DD HH:mm:ss') {
+    return nanotimestamp === exports.nulls.int64 ?
+        ''
+        :
+            (0, dayjs_1.default)(exports.timezone_offset + (Number(nanotimestamp) / 1000000)).format(format) + `.${nanotimestamp % 1000000000n}`;
+}
+exports.nanotimestamp2str = nanotimestamp2str;
+/** parse nano timestamp string to bigint value
+    - str: nano timestamp string, 如果为空字符串会返回对应的空值 (nulls.int64)
+    - format?: Format string up to and including seconds of the passed string, default is `YYYY.MM.DD HH:mm:ss`
+        https://day.js.org/docs/en/parse/string-format#list-of-all-available-parsing-tokens
+*/
+function str2nanotimestamp(str, format = 'YYYY.MM.DD HH:mm:ss') {
+    if (!str)
+        return exports.nulls.int64;
+    if (str.length - format.length !== 9)
+        throw new Error('nanotimestamp 字符串长度减格式串长度应该等于 9');
+    return (BigInt(-exports.timezone_offset +
+        (0, dayjs_1.default)(str.slice(0, format.length), format).valueOf()) * 1000000n
+        +
+            BigInt(str.slice(format.length)));
+}
+exports.str2nanotimestamp = str2nanotimestamp;
 class DDB {
     /**
         Initialize an instance of DolphinDB Client using the WebSocket URL