dolphindb 2.0.517 → 2.0.520

package/browser.d.ts

@@ -8,7 +8,9 @@ export declare enum DdbForm {
     dict = 5,
     table = 6,
     chart = 7,
-    chunk = 8
+    chunk = 8,
+    /** sysobj */
+    object = 9
 }
 /** DolphinDB DataType
     对应的 array vector 类型为 64 + 基本类型
@@ -250,20 +252,28 @@ export declare class DdbSetString extends DdbObj<string[]> {
 export declare class DdbTable extends DdbObj<DdbObj[]> {
     constructor(columns: DdbObj[], name?: string);
 }
-export declare function date2str(date: number, format?: string): string;
+export declare function date2ms(date: number | null): number;
+export declare function date2str(date: number | null, format?: string): string;
+export declare function month2ms(month: number | null): number | null;
 export declare function month2str(month: number | null): string;
-export declare function time2str(time: number, format?: string): string;
+export declare function time2ms(time: number | null): number | null;
+export declare function time2str(time: number | null, format?: string): string;
+export declare function minute2ms(minute: number | null): number | null;
 export declare function minute2str(minute: number | null, format?: string): string;
+export declare function second2ms(second: number | null): number | null;
 export declare function second2str(second: number | null, format?: string): string;
-export declare function datetime2str(datetime: number, format?: string): string;
+export declare function datetime2ms(datetime: number | null): number | null;
+export declare function datetime2str(datetime: number | null, format?: string): string;
+export declare function timestamp2ms(timestamp: bigint | null): number | null;
 /** format timestamp (bigint) to string
     - timestamp: bigint value
     - format?:
         format string, default to `YYYY.MM.DD HH:mm:ss.SSS`
         https://day.js.org/docs/en/parse/string-format#list-of-all-available-parsing-tokens
 */
-export declare function timestamp2str(timestamp: bigint, format?: string): string;
-export declare function datehour2str(datehour: number, format?: string): string;
+export declare function timestamp2str(timestamp: bigint | null, format?: string): string;
+export declare function datehour2ms(datehour: number | null): number | null;
+export declare function datehour2str(datehour: number | null, format?: string): string;
 /** parse timestamp string to bigint value
     - str: timestamp string, If it is an empty string or 'null', it will return the corresponding empty value (nulls.int64)
     - format?:
@@ -271,7 +281,9 @@ export declare function datehour2str(datehour: number, format?: string): string;
         https://day.js.org/docs/en/parse/string-format#list-of-all-available-parsing-tokens
 */
 export declare function str2timestamp(str: string, format?: string): bigint;
-export declare function nanotime2str(nanotime: bigint, format?: string): string;
+export declare function nanotime2ns(nanotime: bigint | null): bigint | null;
+export declare function nanotime2str(nanotime: bigint | null, format?: string): string;
+export declare function nanotimestamp2ns(nanotimestamp: bigint | null): bigint | null;
 /** format nanotimestamp value (bigint) to string
     - nanotimestamp: bigint value
     - format?:
@@ -279,7 +291,7 @@ export declare function nanotime2str(nanotime: bigint, format?: string): string;
         Seconds are in the format ss (must be included); nanoseconds are in the format SSSSSSSSS (must be included)
         https://day.js.org/docs/en/parse/string-format#list-of-all-available-parsing-tokens
 */
-export declare function nanotimestamp2str(nanotimestamp: bigint, format?: string): string;
+export declare function nanotimestamp2str(nanotimestamp: bigint | null, format?: string): string;
 /** parse nano timestamp string to bigint value
     - str: nano timestamp string, If it is an empty string or 'null', it will return the corresponding empty value (nulls.int64)
     - format?:

package/browser.js

@@ -1,6 +1,7 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.ddb = exports.DDB = exports.int1282str = exports.uuid2str = exports.ipaddr2str = exports.str2nanotimestamp = exports.nanotimestamp2str = exports.nanotime2str = exports.str2timestamp = exports.datehour2str = exports.timestamp2str = exports.datetime2str = exports.second2str = exports.minute2str = exports.time2str = exports.month2str = exports.date2str = exports.DdbTable = exports.DdbSetString = exports.DdbSetDouble = exports.DdbSetInt = exports.DdbVectorSymbol = exports.DdbVectorAny = exports.DdbVectorString = exports.DdbVectorDouble = exports.DdbVectorInt = exports.DdbFunction = exports.DdbPair = exports.DdbNanoTimeStamp = exports.DdbTimeStamp = exports.DdbDateTime = exports.DdbDouble = exports.DdbLong = exports.DdbString = exports.DdbInt = exports.DdbChar = exports.DdbBool = exports.DdbVoid = exports.format = exports.DdbObj = exports.timezone_offset = exports.nulls = exports.DdbDurationUnit = exports.DdbFunctionType = exports.DdbType = exports.DdbForm = void 0;
+exports.nanotimestamp2str = exports.nanotimestamp2ns = exports.nanotime2str = exports.nanotime2ns = exports.str2timestamp = exports.datehour2str = exports.datehour2ms = exports.timestamp2str = exports.timestamp2ms = exports.datetime2str = exports.datetime2ms = exports.second2str = exports.second2ms = exports.minute2str = exports.minute2ms = exports.time2str = exports.time2ms = exports.month2str = exports.month2ms = exports.date2str = exports.date2ms = exports.DdbTable = exports.DdbSetString = exports.DdbSetDouble = exports.DdbSetInt = exports.DdbVectorSymbol = exports.DdbVectorAny = exports.DdbVectorString = exports.DdbVectorDouble = exports.DdbVectorInt = exports.DdbFunction = exports.DdbPair = exports.DdbNanoTimeStamp = exports.DdbTimeStamp = exports.DdbDateTime = exports.DdbDouble = exports.DdbLong = exports.DdbString = exports.DdbInt = exports.DdbChar = exports.DdbBool = exports.DdbVoid = exports.format = exports.DdbObj = exports.timezone_offset = exports.nulls = exports.DdbDurationUnit = exports.DdbFunctionType = exports.DdbType = exports.DdbForm = void 0;
+exports.ddb = exports.DDB = exports.int1282str = exports.uuid2str = exports.ipaddr2str = exports.str2nanotimestamp = 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"));
@@ -21,6 +22,8 @@ var DdbForm;
     DdbForm[DdbForm["table"] = 6] = "table";
     DdbForm[DdbForm["chart"] = 7] = "chart";
     DdbForm[DdbForm["chunk"] = 8] = "chunk";
+    /** sysobj */
+    DdbForm[DdbForm["object"] = 9] = "object";
 })(DdbForm = exports.DdbForm || (exports.DdbForm = {}));
 /** DolphinDB DataType
     对应的 array vector 类型为 64 + 基本类型
@@ -1172,7 +1175,7 @@ function format(type, value, le) {
         case DdbType.uuid:
             return uuid2str(value, le);
         case DdbType.functiondef:
-            return value.quote('single');
+            return value.name.quote('single');
         case DdbType.handle:
         case DdbType.code:
             return value.quote('single');
@@ -1220,7 +1223,6 @@ class DdbVoid extends DdbObj {
         super({
             form: DdbForm.scalar,
             type: DdbType.void,
-            length: 0,
             value: null,
         });
     }
@@ -1231,7 +1233,6 @@ class DdbBool extends DdbObj {
         super({
             form: DdbForm.scalar,
             type: DdbType.bool,
-            length: 1,
             value,
         });
     }
@@ -1242,7 +1243,6 @@ class DdbChar extends DdbObj {
         super({
             form: DdbForm.scalar,
             type: DdbType.char,
-            length: 1,
             value: typeof value === 'string' ?
                 value.charCodeAt(0)
                 :
@@ -1256,7 +1256,6 @@ class DdbInt extends DdbObj {
         super({
             form: DdbForm.scalar,
             type: DdbType.int,
-            length: 4,
             value,
         });
     }
@@ -1267,7 +1266,6 @@ class DdbString extends DdbObj {
         super({
             form: DdbForm.scalar,
             type: DdbType.string,
-            length: 0,
             value
         });
     }
@@ -1278,7 +1276,6 @@ class DdbLong extends DdbObj {
         super({
             form: DdbForm.scalar,
             type: DdbType.long,
-            length: 8,
             value
         });
     }
@@ -1289,7 +1286,6 @@ class DdbDouble extends DdbObj {
         super({
             form: DdbForm.scalar,
             type: DdbType.double,
-            length: 8,
             value
         });
     }
@@ -1300,7 +1296,6 @@ class DdbDateTime extends DdbObj {
         super({
             form: DdbForm.scalar,
             type: DdbType.datetime,
-            length: 4,
             value
         });
     }
@@ -1311,7 +1306,6 @@ class DdbTimeStamp extends DdbObj {
         super({
             form: DdbForm.scalar,
             type: DdbType.timestamp,
-            length: 8,
             value
         });
     }
@@ -1322,7 +1316,6 @@ class DdbNanoTimeStamp extends DdbObj {
         super({
             form: DdbForm.scalar,
             type: DdbType.nanotimestamp,
-            length: 8,
             value
         });
     }
@@ -1333,7 +1326,6 @@ class DdbPair extends DdbObj {
         super({
             form: DdbForm.pair,
             type: DdbType.int,
-            length: 0,
             rows: 2,
             cols: 1,
             value: Int32Array.of(l === null ? exports.nulls.int32 : l, r === null ? exports.nulls.int32 : r)
@@ -1346,7 +1338,6 @@ class DdbFunction extends DdbObj {
         super({
             form: DdbForm.scalar,
             type: DdbType.functiondef,
-            length: 0,
             value: { type, name }
         });
     }
@@ -1357,7 +1348,6 @@ class DdbVectorInt extends DdbObj {
         super({
             form: DdbForm.vector,
             type: DdbType.int,
-            length: 0,
             rows: ints.length,
             cols: 1,
             value: ints instanceof Int32Array ?
@@ -1377,7 +1367,6 @@ class DdbVectorDouble extends DdbObj {
         super({
             form: DdbForm.vector,
             type: DdbType.double,
-            length: 0,
             rows: doubles.length,
             cols: 1,
             value: doubles instanceof Float64Array ?
@@ -1397,7 +1386,6 @@ class DdbVectorString extends DdbObj {
         super({
             form: DdbForm.vector,
             type: DdbType.string,
-            length: 0,
             rows: strings.length,
             cols: 1,
             value: strings,
@@ -1411,7 +1399,6 @@ class DdbVectorAny extends DdbObj {
         super({
             form: DdbForm.vector,
             type: DdbType.any,
-            length: 0,
             rows: objs.length,
             cols: 1,
             value: objs,
@@ -1438,7 +1425,6 @@ class DdbVectorSymbol extends DdbObj {
         super({
             form: DdbForm.vector,
             type: DdbType.symbol_extended,
-            length: 0,
             rows: strings.length,
             cols: 1,
             value: {
@@ -1456,7 +1442,6 @@ class DdbSetInt extends DdbObj {
         super({
             form: DdbForm.set,
             type: DdbType.int,
-            length: 0,
             rows: ints instanceof Set ?
                 ints.size
                 :
@@ -1478,7 +1463,6 @@ class DdbSetDouble extends DdbObj {
         super({
             form: DdbForm.set,
             type: DdbType.double,
-            length: 0,
             rows: doubles instanceof Set ?
                 doubles.size
                 :
@@ -1502,7 +1486,6 @@ class DdbSetString extends DdbObj {
         super({
             form: DdbForm.set,
             type: DdbType.string,
-            length: 0,
             rows: strings.length,
             cols: 1,
             value: strings
@@ -1515,7 +1498,6 @@ class DdbTable extends DdbObj {
         super({
             form: DdbForm.table,
             type: DdbType.void,
-            length: 0,
             rows: columns[0].rows,
             cols: columns.length,
             name,
@@ -1524,13 +1506,27 @@ class DdbTable extends DdbObj {
     }
 }
 exports.DdbTable = DdbTable;
+function date2ms(date) {
+    return (date === null || date === exports.nulls.int32) ?
+        null
+        :
+            exports.timezone_offset + 1000 * 3600 * 24 * date;
+}
+exports.date2ms = date2ms;
 function date2str(date, format = 'YYYY.MM.DD') {
     return (date === null || date === exports.nulls.int32) ?
-        'null'
+        null
         :
-            (0, dayjs_1.default)(exports.timezone_offset + 1000 * 3600 * 24 * date).format(format);
+            (0, dayjs_1.default)(date2ms(date)).format(format);
 }
 exports.date2str = date2str;
+function month2ms(month) {
+    return (month === null || month === exports.nulls.int32) ?
+        null
+        :
+            (0, dayjs_1.default)(month2str(month), 'YYYY.MM[M]').valueOf();
+}
+exports.month2ms = month2ms;
 function month2str(month) {
     if (month === null || month === exports.nulls.int32)
         return 'null';
@@ -1541,37 +1537,69 @@ function month2str(month) {
     return `${String(year).padStart(4, '0')}.${String(_month + 1).padStart(2, '0')}M`;
 }
 exports.month2str = month2str;
+function time2ms(time) {
+    return (time === null || time === exports.nulls.int32) ?
+        null
+        :
+            exports.timezone_offset + time;
+}
+exports.time2ms = time2ms;
 function time2str(time, format = 'HH:mm:ss.SSS') {
     return (time === null || time === exports.nulls.int32) ?
-        'null'
+        null
         :
-            (0, dayjs_1.default)(exports.timezone_offset + time)
-                .format(format);
+            (0, dayjs_1.default)(time2ms(time)).format(format);
 }
 exports.time2str = time2str;
+function minute2ms(minute) {
+    return (minute === null || minute === exports.nulls.int32) ?
+        null
+        :
+            exports.timezone_offset + 60 * 1000 * minute;
+}
+exports.minute2ms = minute2ms;
 function minute2str(minute, format = 'HH:mm[m]') {
     return (minute === null || minute === exports.nulls.int32) ?
         'null'
         :
-            (0, dayjs_1.default)(exports.timezone_offset + 60 * 1000 * minute)
-                .format(format);
+            (0, dayjs_1.default)(minute2ms(minute)).format(format);
 }
 exports.minute2str = minute2str;
+function second2ms(second) {
+    return (second === null || second === exports.nulls.int32) ?
+        null
+        :
+            exports.timezone_offset + 1000 * second;
+}
+exports.second2ms = second2ms;
 function second2str(second, format = 'HH:mm:ss') {
     return (second === null || second === exports.nulls.int32) ?
         'null'
         :
-            (0, dayjs_1.default)(exports.timezone_offset + 1000 * second)
-                .format(format);
+            (0, dayjs_1.default)(second2ms(second)).format(format);
 }
 exports.second2str = second2str;
+function datetime2ms(datetime) {
+    return (datetime === null || datetime === exports.nulls.int32) ?
+        null
+        :
+            exports.timezone_offset + 1000 * datetime;
+}
+exports.datetime2ms = datetime2ms;
 function datetime2str(datetime, format = 'YYYY.MM.DD HH:mm:ss') {
     return (datetime === null || datetime === exports.nulls.int32) ?
         'null'
         :
-            (0, dayjs_1.default)(exports.timezone_offset + 1000 * datetime).format(format);
+            (0, dayjs_1.default)(datetime2ms(datetime)).format(format);
 }
 exports.datetime2str = datetime2str;
+function timestamp2ms(timestamp) {
+    return (timestamp === null || timestamp === exports.nulls.int64) ?
+        null
+        :
+            exports.timezone_offset + Number(timestamp);
+}
+exports.timestamp2ms = timestamp2ms;
 /** format timestamp (bigint) to string
     - timestamp: bigint value
     - format?:
@@ -1582,9 +1610,16 @@ function timestamp2str(timestamp, format = 'YYYY.MM.DD HH:mm:ss.SSS') {
     return (timestamp === null || timestamp === exports.nulls.int64) ?
         'null'
         :
-            (0, dayjs_1.default)(exports.timezone_offset + Number(timestamp)).format(format);
+            (0, dayjs_1.default)(timestamp2ms(timestamp)).format(format);
 }
 exports.timestamp2str = timestamp2str;
+function datehour2ms(datehour) {
+    return (datehour === null || datehour === exports.nulls.int32) ?
+        null
+        :
+            exports.timezone_offset + 1000 * 3600 * datehour;
+}
+exports.datehour2ms = datehour2ms;
 function datehour2str(datehour, format = 'YYYY.MM.DDTHH') {
     return (datehour === null || datehour === exports.nulls.int32) ?
         'null'
@@ -1607,6 +1642,10 @@ function str2timestamp(str, format = 'YYYY.MM.DD HH:mm:ss.SSS') {
         (0, dayjs_1.default)(str, format).valueOf());
 }
 exports.str2timestamp = str2timestamp;
+function nanotime2ns(nanotime) {
+    return nanotimestamp2ns(nanotime);
+}
+exports.nanotime2ns = nanotime2ns;
 function nanotime2str(nanotime, format = 'HH:mm:ss.SSSSSSSSS') {
     if (nanotime === null || nanotime === exports.nulls.int64)
         return 'null';
@@ -1624,6 +1663,13 @@ function nanotime2str(nanotime, format = 'HH:mm:ss.SSSSSSSSS') {
         String(nanotime % 1000000000n).padStart(9, '0'));
 }
 exports.nanotime2str = nanotime2str;
+function nanotimestamp2ns(nanotimestamp) {
+    return (nanotimestamp === null || nanotimestamp === exports.nulls.int64) ?
+        null
+        :
+            BigInt(exports.timezone_offset) * 1000000n + nanotimestamp;
+}
+exports.nanotimestamp2ns = nanotimestamp2ns;
 /** format nanotimestamp value (bigint) to string
     - nanotimestamp: bigint value
     - format?: