dolphindb 2.0.513 → 2.0.516

package/index.d.ts

@@ -12,6 +12,10 @@ export declare enum DdbForm {
     chart = 7,
     chunk = 8
 }
+/** DolphinDB DataType
+    对应的 array vector 类型为 64 + 基本类型
+    对应的 extended 类型为 128 + 基本类型
+*/
 export declare enum DdbType {
     void = 0,
     bool = 1,
@@ -93,7 +97,7 @@ export interface DdbArrayVectorBlock {
     unit: 1 | 2 | 4;
     rows: number;
     lengths: Uint8Array | Uint16Array | Uint32Array;
-    data: DdbVectorValue;
+    data: Int8Array | Int16Array | Int32Array | Float32Array | Float64Array | BigInt64Array;
 }
 export interface DdbMatrixValue {
     rows: DdbObj<DdbVectorValue>;
@@ -258,7 +262,7 @@ export declare function datetime2str(datetime: number, format?: string): string;
 export declare function timestamp2str(timestamp: bigint, format?: string): string;
 export declare function datehour2str(datehour: number, format?: string): string;
 /** parse timestamp string to bigint value
-    - str: timestamp string, If it is an empty string, it will return the corresponding empty value (nulls.int64)
+    - str: timestamp string, If it is an empty string or 'null', it will return the corresponding empty value (nulls.int64)
     - format?:
         The format string corresponding to the incoming string, the default is `YYYY.MM.DD HH:mm:ss.SSS`
         https://day.js.org/docs/en/parse/string-format#list-of-all-available-parsing-tokens
@@ -274,7 +278,7 @@ export declare function nanotime2str(nanotime: bigint, format?: string): string;
 */
 export declare function nanotimestamp2str(nanotimestamp: bigint, format?: string): string;
 /** parse nano timestamp string to bigint value
-    - str: nano timestamp string, If it is an empty string, it will return the corresponding empty value (nulls.int64)
+    - str: nano timestamp string, If it is an empty string or 'null', it will return the corresponding empty value (nulls.int64)
     - format?:
         The format string corresponding to the incoming string, the default is `YYYY.MM.DD HH:mm:ss.SSSSSSSSS`
         Seconds are in the format ss (must be included); nanoseconds are in the format SSSSSSSSS (must be included)
@@ -387,9 +391,9 @@ export declare class DDB {
         - options:
             - urgent?: 决定 `行为标识` 那一行字符串的取值（只适用于 script 和 function）
             - vars?: type === 'variable' 时必传，variable 指令中待上传的变量名
-            - handler?: Process messages during this rpc (DdbMessage)
-            - parse_object?: 在该次 rpc 期间设置 parse_object, 结束后恢复原有，为 false 时返回的 DdbObj 仅含有 buffer 和 le，
-                不做解析，以便后续转发、序列化
+            - listener?: 处理本次 rpc 期间的消息 (DdbMessage)
+            - parse_object?: 在本次 rpc 期间设置 parse_object, 结束后恢复原有
+                为 false 时返回的 DdbObj 仅含有 buffer 和 le，不做解析，以便后续转发、序列化
     */
     rpc<T extends DdbObj = DdbObj>(type: 'script' | 'function' | 'variable' | 'connect', { script, func, args, vars, urgent, listener, parse_object, }: {
         script?: string;
@@ -469,4 +473,3 @@ export interface DdbErrorMessage {
     data: Error;
 }
 export declare type DdbMessage = DdbPrintMessage | DdbObjectMessage | DdbErrorMessage;
-export default DDB;

package/index.js

@@ -20,6 +20,10 @@ var DdbForm;
     DdbForm[DdbForm["chart"] = 7] = "chart";
     DdbForm[DdbForm["chunk"] = 8] = "chunk";
 })(DdbForm = exports.DdbForm || (exports.DdbForm = {}));
+/** DolphinDB DataType
+    对应的 array vector 类型为 64 + 基本类型
+    对应的 extended 类型为 128 + 基本类型
+*/
 var DdbType;
 (function (DdbType) {
     DdbType[DdbType["void"] = 0] = "void";
@@ -471,7 +475,7 @@ class DdbObj {
                 unit,
                 rows,
                 lengths,
-                data
+                data: data
             });
             i_block_start = i_data_start + len_items;
             i_row += rows;
@@ -909,7 +913,7 @@ class DdbObj {
                 case DdbForm.dict:
                     return `dict<${DdbType[this.value[0].type]}, ${DdbType[this.value[1].type]}>`;
                 case DdbForm.matrix:
-                    return `matrix<${DdbType[this.type]}>[${this.rows}r][${this.cols}c]`;
+                    return `matrix<${tname}>[${this.rows}r][${this.cols}c]`;
                 default:
                     return `${DdbForm[this.form]} ${tname}`;
             }
@@ -929,6 +933,34 @@ class DdbObj {
                             :
                                 str_items.bracket('square');
                     }
+                    if (64 <= this.type && this.type < 128) { // array vector
+                        // 因为 array vector 目前只支持：Logical, Integral（不包括 INT128, COMPRESS 类型）, Floating, Temporal
+                        // 都对应 TypedArray 中的一格，所以直接根据 index 去取即可
+                        // av = array(INT[], 0, 5)
+                        // append!(av, [1..1])
+                        // append!(av, [1..70000])
+                        // append!(av, [1..1])
+                        // append!(av, [1..500])
+                        // ...
+                        // av
+                        const _type = this.type - 64;
+                        const limit = 10;
+                        let items = new Array(Math.min(limit, this.rows));
+                        let i_items = 0;
+                        for (const { lengths, data } of this.value) {
+                            let acc_len = 0;
+                            for (const length of lengths) {
+                                let _items = new Array(Math.min(limit, length));
+                                for (let i = 0; i < _items.length; i++)
+                                    _items[i] = format(_type, data[acc_len + i], this.le, options);
+                                items[i_items++] = format_array(_items, length > limit);
+                                acc_len += length;
+                            }
+                            if (i_items >= limit)
+                                break;
+                        }
+                        return format_array(items, this.rows > limit);
+                    }
                     switch (this.type) {
                         case DdbType.symbol_extended: {
                             const limit = 50;
@@ -1171,8 +1203,10 @@ function format(type, value, le, options) {
                 :
                     int1282str(value, le);
         case DdbType.blob:
-            return (0, utils_js_1.inspect)(DdbObj.dec.decode(value.subarray(0, 1000)), options);
-        case DdbType.complex:
+            return (0, utils_js_1.inspect)(value.length > 100 ?
+                DdbObj.dec.decode(value.subarray(0, 98)) + '…'
+                :
+                    DdbObj.dec.decode(value), options);
         case DdbType.point: {
             let [x, y] = value;
             if (x === exports.nulls.double)
@@ -1184,6 +1218,17 @@ function format(type, value, le, options) {
                 :
                     `(${String(x)}, ${String(y)})`;
         }
+        case DdbType.complex: {
+            let [x, y] = value;
+            if (x === exports.nulls.double)
+                x = null;
+            if (y === exports.nulls.double)
+                y = null;
+            return options.colors ?
+                `${String(x).green}+${`${String(y)}i`.green}`
+                :
+                    `${String(x)}+${String(y)}i`;
+        }
         case DdbType.duration: {
             const { data, unit } = value;
             const str = `${data}${DdbDurationUnit[unit]}`;
@@ -1505,32 +1550,32 @@ class DdbTable extends DdbObj {
 exports.DdbTable = DdbTable;
 function date2str(date, format = 'YYYY.MM.DD') {
     return (date === null || date === exports.nulls.int32) ?
-        ''
+        'null'
         :
             (0, dayjs_1.default)(exports.timezone_offset + 1000 * 3600 * 24 * date).format(format);
 }
 exports.date2str = date2str;
 function month2str(month) {
     if (month === null || month === exports.nulls.int32)
-        return '';
+        return 'null';
     if (month < 0)
         return String(month);
-    let _month = month % 12;
-    let year = Math.floor(month / 12);
-    return `${String(year).padStart(4, '0')}.${String(_month + 1).padStart(2, '0')}`;
+    const _month = month % 12;
+    const year = Math.trunc(month / 12);
+    return `${String(year).padStart(4, '0')}.${String(_month + 1).padStart(2, '0')}M`;
 }
 exports.month2str = month2str;
 function time2str(time, format = 'HH:mm:ss.SSS') {
     return (time === null || time === exports.nulls.int32) ?
-        ''
+        'null'
         :
             (0, dayjs_1.default)(exports.timezone_offset + time)
                 .format(format);
 }
 exports.time2str = time2str;
-function minute2str(minute, format = 'HH:mm') {
+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);
@@ -1538,7 +1583,7 @@ function minute2str(minute, format = 'HH:mm') {
 exports.minute2str = minute2str;
 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);
@@ -1546,7 +1591,7 @@ function second2str(second, format = 'HH:mm:ss') {
 exports.second2str = second2str;
 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);
 }
@@ -1559,26 +1604,26 @@ exports.datetime2str = datetime2str;
 */
 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);
 }
 exports.timestamp2str = timestamp2str;
-function datehour2str(datehour, format = 'YYYY.MM.DD.HH') {
+function datehour2str(datehour, format = 'YYYY.MM.DDTHH') {
     return (datehour === null || datehour === exports.nulls.int32) ?
-        ''
+        'null'
         :
             (0, dayjs_1.default)(exports.timezone_offset + 1000 * 3600 * datehour).format(format);
 }
 exports.datehour2str = datehour2str;
 /** parse timestamp string to bigint value
-    - str: timestamp string, If it is an empty string, it will return the corresponding empty value (nulls.int64)
+    - str: timestamp string, If it is an empty string or 'null', it will return the corresponding empty value (nulls.int64)
     - format?:
         The format string corresponding to the incoming string, the default is `YYYY.MM.DD HH:mm:ss.SSS`
         https://day.js.org/docs/en/parse/string-format#list-of-all-available-parsing-tokens
 */
 function str2timestamp(str, format = 'YYYY.MM.DD HH:mm:ss.SSS') {
-    if (!str)
+    if (!str || str === 'null')
         return exports.nulls.int64;
     if (str.length !== format.length)
         throw new Error('The length of the timestamp string is not equal to the length of the format string');
@@ -1587,6 +1632,10 @@ function str2timestamp(str, format = 'YYYY.MM.DD HH:mm:ss.SSS') {
 }
 exports.str2timestamp = str2timestamp;
 function nanotime2str(nanotime, format = 'HH:mm:ss.SSSSSSSSS') {
+    if (nanotime === null || nanotime === exports.nulls.int64)
+        return 'null';
+    if (nanotime < 0n)
+        return String(nanotime);
     const i_second_start = format.indexOf('ss');
     if (i_second_start === -1)
         throw new Error('The format string must contain the format for seconds (ss)');
@@ -1607,8 +1656,14 @@ exports.nanotime2str = nanotime2str;
         https://day.js.org/docs/en/parse/string-format#list-of-all-available-parsing-tokens
 */
 function nanotimestamp2str(nanotimestamp, format = 'YYYY.MM.DD HH:mm:ss.SSSSSSSSS') {
+    // tests:
+    // nanotimestamp2str(0n)
+    // nanotimestamp2str(-1n)
+    // nanotimestamp2str(-9_9999_9999n)
+    // nanotimestamp2str(-10_0000_0000n)
+    // nanotimestamp2str(-10_0000_0001n)
     if (nanotimestamp === null || nanotimestamp === exports.nulls.int64)
-        return '';
+        return 'null';
     const i_second_start = format.indexOf('ss');
     if (i_second_start === -1)
         throw new Error('The format string must contain the format for seconds (ss)');
@@ -1616,20 +1671,27 @@ function nanotimestamp2str(nanotimestamp, format = 'YYYY.MM.DD HH:mm:ss.SSSSSSSS
     const i_nanosecond_start = format.indexOf('SSSSSSSSS', i_second_end);
     if (i_nanosecond_start === -1)
         throw new Error('The format string must contain the format for nanoseconds (SSSSSSSSS)');
-    return ((0, dayjs_1.default)(exports.timezone_offset + (Number(nanotimestamp) / 1000000)).format(format.slice(0, i_second_end)) +
+    const remainder = nanotimestamp % 1000000000n;
+    const borrow = remainder < 0n;
+    return ((0, dayjs_1.default)(exports.timezone_offset +
+        // 去掉 9 位的纳秒部分，转化为毫秒
+        Number((nanotimestamp - remainder + (borrow ? -1000000000n : 0n)) / 1000000n)).format(format.slice(0, i_second_end)) +
         format.slice(i_second_end, i_nanosecond_start) +
-        String(nanotimestamp % 1000000000n).padStart(9, '0'));
+        String(borrow ?
+            (remainder + 1000000000n) % 1000000000n
+            :
+                remainder).padStart(9, '0'));
 }
 exports.nanotimestamp2str = nanotimestamp2str;
 /** parse nano timestamp string to bigint value
-    - str: nano timestamp string, If it is an empty string, it will return the corresponding empty value (nulls.int64)
+    - str: nano timestamp string, If it is an empty string or 'null', it will return the corresponding empty value (nulls.int64)
     - format?:
         The format string corresponding to the incoming string, the default is `YYYY.MM.DD HH:mm:ss.SSSSSSSSS`
         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
 */
 function str2nanotimestamp(str, format = 'YYYY.MM.DD HH:mm:ss.SSSSSSSSS') {
-    if (!str)
+    if (!str || str === 'null')
         return exports.nulls.int64;
     if (str.length !== format.length)
         throw new Error('nanotimestamp string length is not equal to format string length');
@@ -1844,9 +1906,9 @@ class DDB {
         - options:
             - urgent?: 决定 `行为标识` 那一行字符串的取值（只适用于 script 和 function）
             - vars?: type === 'variable' 时必传，variable 指令中待上传的变量名
-            - handler?: Process messages during this rpc (DdbMessage)
-            - parse_object?: 在该次 rpc 期间设置 parse_object, 结束后恢复原有，为 false 时返回的 DdbObj 仅含有 buffer 和 le，
-                不做解析，以便后续转发、序列化
+            - listener?: 处理本次 rpc 期间的消息 (DdbMessage)
+            - parse_object?: 在本次 rpc 期间设置 parse_object, 结束后恢复原有
+                为 false 时返回的 DdbObj 仅含有 buffer 和 le，不做解析，以便后续转发、序列化
     */
     async rpc(type, { script, func, args = [], vars = [], urgent, listener, parse_object, }) {
         if (!this.websocket)
@@ -2070,5 +2132,4 @@ class DDB {
 exports.DDB = DDB;
 /** little endian (client) */
 DDB.le_client = Boolean(new Uint8Array(Uint32Array.of(1).buffer)[0]);
-exports.default = DDB;
 //# sourceMappingURL=index.js.map