dolphindb 2.0.510 → 2.0.513

package/index.d.ts

@@ -51,7 +51,6 @@ export declare enum DdbType {
     object = 37,
     symbol_extended = 145
 }
-export declare const ddb_sizes: readonly [0, 1, 1, 2, 4, 8, 4, 4, 4, 4, 4, 4, 8, 8, 8, 4, 8, 0, 0, 16, 0, 0, 0, 0, 0, 0, 1, 0, 0, 16, 16, 0, 0, 0, 0];
 export declare enum DdbFunctionType {
     SystemFunc = 0,
     SystemProc = 1,
@@ -63,10 +62,28 @@ export declare enum DdbFunctionType {
     JitFunc = 7,
     JitPartialFunc = 8
 }
+export declare enum DdbDurationUnit {
+    ns = 0,
+    us = 1,
+    ms = 2,
+    s = 3,
+    m = 4,
+    H = 5,
+    d = 6,
+    w = 7,
+    M = 8,
+    y = 9,
+    B = 10
+}
 export interface DdbFunctionDefValue {
     type: DdbFunctionType;
     name: string;
 }
+export interface DdbDurationValue {
+    unit: DdbDurationUnit;
+    /** int32 */
+    data: number;
+}
 export interface DdbSymbolExtendedValue {
     base_id: number;
     base: string[];
@@ -88,7 +105,7 @@ export declare type DdbScalarValue = null | boolean | number | bigint | string |
     number,
     number
 ] | // complex, point
-DdbFunctionDefValue;
+DdbFunctionDefValue | DdbDurationValue;
 export declare type DdbVectorValue = Uint8Array | Int8Array | Int16Array | Int32Array | Float32Array | Float64Array | BigInt64Array | string[] | // string[]
 Uint8Array[] | // blob
 DdbObj[] | // any
@@ -162,6 +179,7 @@ export declare class DdbObj<T extends DdbValue = DdbValue> {
     to_rows<T extends Record<string, any> = Record<string, any>>(): T[];
     to_dict<T = Record<string, any>>(): T;
 }
+export declare function format(type: DdbType, value: DdbValue, le: boolean, options: InspectOptions): string;
 export declare class DdbVoid extends DdbObj<undefined> {
     constructor();
 }
@@ -226,6 +244,10 @@ export declare class DdbTable extends DdbObj<DdbObj[]> {
     constructor(columns: DdbObj[], name?: string);
 }
 export declare function date2str(date: number, format?: string): string;
+export declare function month2str(month: number | null): string;
+export declare function time2str(time: number, format?: string): string;
+export declare function minute2str(minute: number | null, format?: string): string;
+export declare function second2str(second: number | null, format?: string): string;
 export declare function datetime2str(datetime: number, format?: string): string;
 /** format timestamp (bigint) to string
     - timestamp: bigint value
@@ -234,6 +256,7 @@ export declare function datetime2str(datetime: number, format?: string): string;
         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;
 /** parse timestamp string to bigint value
     - str: timestamp string, If it is an empty string, it will return the corresponding empty value (nulls.int64)
     - format?:
@@ -241,6 +264,7 @@ export declare function timestamp2str(timestamp: bigint, format?: string): strin
         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;
 /** format nanotimestamp value (bigint) to string
     - nanotimestamp: bigint value
     - format?:
@@ -257,6 +281,9 @@ export declare function nanotimestamp2str(nanotimestamp: bigint, format?: string
         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 function ipaddr2str(buffer: Uint8Array, le?: boolean): string;
+export declare function uuid2str(buffer: Uint8Array, le?: boolean): string;
+export declare function int1282str(buffer: Uint8Array, le?: boolean): string;
 export declare class DDB {
     /** 当前的 session id (http 或 tcp) */
     sid: string;

package/index.js

@@ -1,6 +1,6 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.DDB = exports.str2nanotimestamp = exports.nanotimestamp2str = exports.str2timestamp = exports.timestamp2str = exports.datetime2str = 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.DdbObj = exports.timezone_offset = exports.nulls = exports.DdbFunctionType = exports.ddb_sizes = exports.DdbType = exports.DdbForm = void 0;
+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;
 const tslib_1 = require("tslib");
 const ws_1 = require("ws");
 const dayjs_1 = tslib_1.__importDefault(require("dayjs"));
@@ -60,43 +60,6 @@ var DdbType;
     DdbType[DdbType["object"] = 37] = "object";
     DdbType[DdbType["symbol_extended"] = 145] = "symbol_extended";
 })(DdbType = exports.DdbType || (exports.DdbType = {}));
-exports.ddb_sizes = [
-    0,
-    1,
-    1,
-    2,
-    4,
-    8,
-    4,
-    4,
-    4,
-    4,
-    4,
-    4,
-    8,
-    8,
-    8,
-    4,
-    8,
-    0,
-    0,
-    16,
-    0,
-    0,
-    0,
-    0,
-    0,
-    0,
-    1,
-    0,
-    0,
-    16,
-    16,
-    0,
-    0,
-    0,
-    0, // duration = 36,
-];
 var DdbFunctionType;
 (function (DdbFunctionType) {
     DdbFunctionType[DdbFunctionType["SystemFunc"] = 0] = "SystemFunc";
@@ -109,6 +72,20 @@ var DdbFunctionType;
     DdbFunctionType[DdbFunctionType["JitFunc"] = 7] = "JitFunc";
     DdbFunctionType[DdbFunctionType["JitPartialFunc"] = 8] = "JitPartialFunc";
 })(DdbFunctionType = exports.DdbFunctionType || (exports.DdbFunctionType = {}));
+var DdbDurationUnit;
+(function (DdbDurationUnit) {
+    DdbDurationUnit[DdbDurationUnit["ns"] = 0] = "ns";
+    DdbDurationUnit[DdbDurationUnit["us"] = 1] = "us";
+    DdbDurationUnit[DdbDurationUnit["ms"] = 2] = "ms";
+    DdbDurationUnit[DdbDurationUnit["s"] = 3] = "s";
+    DdbDurationUnit[DdbDurationUnit["m"] = 4] = "m";
+    DdbDurationUnit[DdbDurationUnit["H"] = 5] = "H";
+    DdbDurationUnit[DdbDurationUnit["d"] = 6] = "d";
+    DdbDurationUnit[DdbDurationUnit["w"] = 7] = "w";
+    DdbDurationUnit[DdbDurationUnit["M"] = 8] = "M";
+    DdbDurationUnit[DdbDurationUnit["y"] = 9] = "y";
+    DdbDurationUnit[DdbDurationUnit["B"] = 10] = "B";
+})(DdbDurationUnit = exports.DdbDurationUnit || (exports.DdbDurationUnit = {}));
 exports.nulls = {
     int8: -0x80,
     int16: -32768,
@@ -359,6 +336,7 @@ class DdbObj {
             case DdbType.string:
             case DdbType.symbol:
             case DdbType.code:
+            case DdbType.handle:
             case DdbType.functiondef: {
                 const i_head = type === DdbType.functiondef ? 1 : 0;
                 let i_zero = buf.indexOf(0, i_head);
@@ -406,8 +384,18 @@ class DdbObj {
                     ]
                 ];
             }
+            case DdbType.duration: {
+                const dv = new DataView(buf.buffer, buf.byteOffset);
+                return [
+                    8,
+                    {
+                        unit: dv.getUint32(4, le),
+                        data: dv.getInt32(0, le)
+                    }
+                ];
+            }
             default:
-                return [0, buf];
+                throw new Error(`${DdbType[type] || type} 暂时不支持解析`);
         }
     }
     /** parse: rows, cols, items
@@ -546,6 +534,7 @@ class DdbObj {
                 ];
             case DdbType.string:
             case DdbType.symbol:
+            case DdbType.handle:
             case DdbType.code: {
                 let value = new Array(length);
                 let i_head = 0, i_tail = i_head;
@@ -639,6 +628,13 @@ class DdbObj {
                     values
                 ];
             }
+            // case DdbType.duration: -> 实际会返回一个 any vector
+            // [2y, 1M, 3d, 7H, 11m, 12s, 15ms, 16us, 17ns]
+            // <Buffer 19 01 type = any, form = vector
+            // 09 00 00 00 01 00 00 00 rows = 9, cols = 1
+            // 24 00 type = DdbType.duration, form = scalar
+            // 02 00 00 00 09 00 00 00 
+            // 24 00 01 00 00 00 08 00 00 00 24 00 03 00 00 00 06 00 00 00 24 00 07 00 00 00 05 00 00 00 ... 50 more bytes>
             default:
                 return [0, buf];
         }
@@ -718,6 +714,7 @@ class DdbObj {
                         case DdbType.string:
                         case DdbType.symbol:
                         case DdbType.code:
+                        case DdbType.handle:
                             return [
                                 DdbObj.enc.encode(value),
                                 Uint8Array.of(0),
@@ -740,12 +737,12 @@ class DdbObj {
                         case DdbType.complex:
                         case DdbType.point:
                             return [Float64Array.from(this.value)];
-                        case DdbType.duration:
-                            return [value];
-                        case DdbType.handle:
-                            throw new Error('DolphinDB Server 不支持 handle 的反序列化');
+                        case DdbType.duration: {
+                            const { unit, data } = this.value;
+                            return [Int32Array.of(data, unit)];
+                        }
                         default:
-                            throw new Error(`${DdbType[type]} 暂时不支持序列化`);
+                            throw new Error(`${DdbType[type] || type} 暂时不支持序列化`);
                     }
                 case DdbForm.vector:
                 case DdbForm.pair:
@@ -838,6 +835,7 @@ class DdbObj {
                 return [value];
             case DdbType.string:
             case DdbType.symbol:
+            case DdbType.handle:
             case DdbType.code: {
                 let bufs = new Array(length * 2);
                 for (let i = 0; i < length; i++) {
@@ -907,25 +905,69 @@ class DdbObj {
                 case DdbForm.set:
                     return `set<${tname}>[${this.rows}]`;
                 case DdbForm.table:
-                    return `table[${this.rows} rows][${this.cols} cols]`;
+                    return `table[${this.rows}r][${this.cols}c]`;
                 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} rows][${this.cols} cols]`;
+                    return `matrix<${DdbType[this.type]}>[${this.rows}r][${this.cols}c]`;
                 default:
                     return `${DdbForm[this.form]} ${tname}`;
             }
         })();
         const data = (() => {
             switch (this.form) {
-                case DdbForm.pair:
-                    return `${(0, utils_js_1.inspect)(this.value[0], options)}, ${(0, utils_js_1.inspect)(this.value[1], options)}`;
                 case DdbForm.scalar:
+                    return format(this.type, this.value, this.le, options);
+                case DdbForm.vector:
+                case DdbForm.pair:
+                case DdbForm.set: {
+                    const form = this.form;
+                    function format_array(items, ellipsis) {
+                        const str_items = items.join(', ') + (ellipsis ? ', ...' : '');
+                        return form === DdbForm.pair ?
+                            str_items
+                            :
+                                str_items.bracket('square');
+                    }
                     switch (this.type) {
-                        case DdbType.functiondef:
-                            return (0, utils_js_1.inspect)(this.value.name, options);
+                        case DdbType.symbol_extended: {
+                            const limit = 50;
+                            const { base, data } = this.value;
+                            let items = new Array(Math.min(limit, data.length));
+                            for (let i = 0; i < items.length; i++)
+                                items[i] = (0, utils_js_1.inspect)(base[data[i]], options);
+                            return format_array(items, data.length > limit);
+                        }
+                        case DdbType.uuid:
+                        case DdbType.int128:
+                        case DdbType.ipaddr: {
+                            const limit = 10;
+                            const value = this.value;
+                            const len_data = value.length / 16;
+                            let items = new Array(Math.min(limit, len_data));
+                            for (let i = 0; i < items.length; i++)
+                                items[i] = format(this.type, value.subarray(16 * i, 16 * (i + 1)), this.le, options);
+                            return format_array(items, len_data > limit);
+                        }
+                        case DdbType.complex:
+                        case DdbType.point: {
+                            const limit = 20;
+                            const value = this.value;
+                            const len_data = value.length / 2;
+                            let items = new Array(Math.min(limit, len_data));
+                            for (let i = 0; i < items.length; i++)
+                                items[i] = format(this.type, value.subarray(2 * i, 2 * (i + 1)), this.le, options);
+                            return format_array(items, len_data > limit);
+                        }
+                        default: {
+                            const limit = 50;
+                            let items = new Array(Math.min(limit, this.value.length));
+                            for (let i = 0; i < items.length; i++)
+                                items[i] = format(this.type, this.value[i], this.le, options);
+                            return format_array(items, this.value.length > limit);
+                        }
                     }
-                    break;
+                }
             }
             if (this.value instanceof Uint8Array)
                 return (0, utils_js_1.inspect)((0, utils_js_1.typed_array_to_buffer)(this.value), options);
@@ -935,7 +977,7 @@ class DdbObj {
     }
     to_rows() {
         if (this.form !== DdbForm.table)
-            throw new Error('this.form is not DdbForm.table, cannot call to_rows');
+            throw new Error('this.form 不是 DdbForm.table, 不能 to_rows');
         let rows = new Array(this.rows);
         for (let i = 0; i < this.rows; i++) {
             let row = {};
@@ -968,7 +1010,7 @@ class DdbObj {
     }
     to_dict() {
         if (this.form !== DdbForm.dict)
-            throw new Error('this.form is not DdbForm.dict, cannot convert to Object');
+            throw new Error('this.form 不是 DdbForm.dict, 不能转换为 Object');
         const [{ value: keys }, { value: values }] = this.value;
         let obj = {};
         for (let i = 0; i < this.rows; i++)
@@ -985,6 +1027,173 @@ DdbObj.enc = new TextEncoder();
 DdbObj.symbol_bases = {};
 /** little endian (client) */
 DdbObj.le_client = Boolean(new Uint8Array(Uint32Array.of(1).buffer)[0]);
+function format(type, value, le, options) {
+    switch (type) {
+        case DdbType.bool:
+            return (0, utils_js_1.inspect)((value === null || value === exports.nulls.int8) ?
+                null
+                :
+                    Boolean(value), options);
+        case DdbType.char:
+            return (0, utils_js_1.inspect)((value === null || value === exports.nulls.int8) ?
+                null
+                :
+                    value, options);
+        case DdbType.short:
+            return (0, utils_js_1.inspect)((value === null || value === exports.nulls.int16) ?
+                null
+                :
+                    value, options);
+        case DdbType.int:
+            return (0, utils_js_1.inspect)((value === null || value === exports.nulls.int32) ?
+                null
+                :
+                    value, options);
+        case DdbType.long:
+            return (value === null || value === exports.nulls.int64) ?
+                'null'
+                :
+                    options.colors ?
+                        String(value).green
+                        :
+                            String(value);
+        case DdbType.date:
+            return (value === null || value === exports.nulls.int32) ?
+                'null'
+                :
+                    options.colors ?
+                        date2str(value).green
+                        :
+                            date2str(value);
+        case DdbType.month:
+            return (value === null || value === exports.nulls.int32) ?
+                'null'
+                :
+                    options.colors ?
+                        month2str(value).green
+                        :
+                            month2str(value);
+        case DdbType.time:
+            return (value === null || value === exports.nulls.int32) ?
+                'null'
+                :
+                    options.colors ?
+                        time2str(value).green
+                        :
+                            time2str(value);
+        case DdbType.minute:
+            return (value === null || value === exports.nulls.int32) ?
+                'null'
+                :
+                    options.colors ?
+                        minute2str(value).green
+                        :
+                            minute2str(value);
+        case DdbType.second:
+            return (value === null || value === exports.nulls.int32) ?
+                'null'
+                :
+                    options.colors ?
+                        second2str(value).green
+                        :
+                            second2str(value);
+        case DdbType.datetime:
+            return (value === null || value === exports.nulls.int32) ?
+                'null'
+                :
+                    options.colors ?
+                        datetime2str(value).green
+                        :
+                            datetime2str(value);
+        case DdbType.timestamp:
+            return (value === null || value === exports.nulls.int64) ?
+                'null'
+                :
+                    options.colors ?
+                        timestamp2str(value).green
+                        :
+                            timestamp2str(value);
+        case DdbType.nanotime:
+            return (value === null || value === exports.nulls.int64) ?
+                'null'
+                :
+                    options.colors ?
+                        nanotime2str(value).green
+                        :
+                            nanotime2str(value);
+        case DdbType.nanotimestamp:
+            return (value === null || value === exports.nulls.int64) ?
+                'null'
+                :
+                    options.colors ?
+                        nanotimestamp2str(value).green
+                        :
+                            nanotimestamp2str(value);
+        case DdbType.float:
+            return (value === null || value === exports.nulls.float32) ?
+                'null'
+                :
+                    (0, utils_js_1.inspect)(value, options);
+        case DdbType.double:
+            return (value === null || value === exports.nulls.double) ?
+                'null'
+                :
+                    (0, utils_js_1.inspect)(value, options);
+        case DdbType.symbol:
+        case DdbType.string:
+            return (0, utils_js_1.inspect)(value, options);
+        case DdbType.uuid:
+            return options.colors ?
+                uuid2str(value, le).green
+                :
+                    uuid2str(value, le);
+        case DdbType.functiondef:
+            return (0, utils_js_1.inspect)(value.name, options);
+        case DdbType.handle:
+        case DdbType.code:
+            return (0, utils_js_1.inspect)(value, options);
+        case DdbType.datehour:
+            return (value === null || value === exports.nulls.int32) ?
+                'null'
+                :
+                    options.colors ?
+                        datehour2str(value).green
+                        :
+                            datehour2str(value);
+        case DdbType.ipaddr:
+            return options.colors ?
+                ipaddr2str(value, le).green
+                :
+                    ipaddr2str(value, le);
+        case DdbType.int128:
+            return options.colors ?
+                int1282str(value, le).green
+                :
+                    int1282str(value, le);
+        case DdbType.blob:
+            return (0, utils_js_1.inspect)(DdbObj.dec.decode(value.subarray(0, 1000)), options);
+        case DdbType.complex:
+        case DdbType.point: {
+            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).green})`
+                :
+                    `(${String(x)}, ${String(y)})`;
+        }
+        case DdbType.duration: {
+            const { data, unit } = value;
+            const str = `${data}${DdbDurationUnit[unit]}`;
+            return options.colors ? str.green : str;
+        }
+        default:
+            return (0, utils_js_1.inspect)(value, options);
+    }
+}
+exports.format = format;
 class DdbVoid extends DdbObj {
     constructor() {
         super({
@@ -1295,14 +1504,48 @@ class DdbTable extends DdbObj {
 }
 exports.DdbTable = DdbTable;
 function date2str(date, format = 'YYYY.MM.DD') {
-    return date === exports.nulls.int32 ?
+    return (date === null || date === exports.nulls.int32) ?
         ''
         :
             (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 '';
+    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')}`;
+}
+exports.month2str = month2str;
+function time2str(time, format = 'HH:mm:ss.SSS') {
+    return (time === null || time === exports.nulls.int32) ?
+        ''
+        :
+            (0, dayjs_1.default)(exports.timezone_offset + time)
+                .format(format);
+}
+exports.time2str = time2str;
+function minute2str(minute, format = 'HH:mm') {
+    return (minute === null || minute === exports.nulls.int32) ?
+        ''
+        :
+            (0, dayjs_1.default)(exports.timezone_offset + 60 * 1000 * minute)
+                .format(format);
+}
+exports.minute2str = minute2str;
+function second2str(second, format = 'HH:mm:ss') {
+    return (second === null || second === exports.nulls.int32) ?
+        ''
+        :
+            (0, dayjs_1.default)(exports.timezone_offset + 1000 * second)
+                .format(format);
+}
+exports.second2str = second2str;
 function datetime2str(datetime, format = 'YYYY.MM.DD HH:mm:ss') {
-    return datetime === exports.nulls.int32 ?
+    return (datetime === null || datetime === exports.nulls.int32) ?
         ''
         :
             (0, dayjs_1.default)(exports.timezone_offset + 1000 * datetime).format(format);
@@ -1315,12 +1558,19 @@ exports.datetime2str = datetime2str;
         https://day.js.org/docs/en/parse/string-format#list-of-all-available-parsing-tokens
 */
 function timestamp2str(timestamp, format = 'YYYY.MM.DD HH:mm:ss.SSS') {
-    return timestamp === exports.nulls.int64 ?
+    return (timestamp === null || timestamp === exports.nulls.int64) ?
         ''
         :
             (0, dayjs_1.default)(exports.timezone_offset + Number(timestamp)).format(format);
 }
 exports.timestamp2str = timestamp2str;
+function datehour2str(datehour, format = 'YYYY.MM.DD.HH') {
+    return (datehour === null || datehour === exports.nulls.int32) ?
+        ''
+        :
+            (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)
     - format?:
@@ -1336,6 +1586,19 @@ function str2timestamp(str, format = 'YYYY.MM.DD HH:mm:ss.SSS') {
         (0, dayjs_1.default)(str, format).valueOf());
 }
 exports.str2timestamp = str2timestamp;
+function nanotime2str(nanotime, format = 'HH:mm:ss.SSSSSSSSS') {
+    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)');
+    const i_second_end = i_second_start + 2;
+    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(nanotime) / 1000000)).format(format.slice(0, i_second_end)) +
+        format.slice(i_second_end, i_nanosecond_start) +
+        String(nanotime % 1000000000n).padStart(9, '0'));
+}
+exports.nanotime2str = nanotime2str;
 /** format nanotimestamp value (bigint) to string
     - nanotimestamp: bigint value
     - format?:
@@ -1344,7 +1607,7 @@ exports.str2timestamp = str2timestamp;
         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') {
-    if (nanotimestamp === exports.nulls.int64)
+    if (nanotimestamp === null || nanotimestamp === exports.nulls.int64)
         return '';
     const i_second_start = format.indexOf('ss');
     if (i_second_start === -1)
@@ -1355,7 +1618,7 @@ function nanotimestamp2str(nanotimestamp, format = 'YYYY.MM.DD HH:mm:ss.SSSSSSSS
         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)) +
         format.slice(i_second_end, i_nanosecond_start) +
-        String(nanotimestamp % 1000000000n));
+        String(nanotimestamp % 1000000000n).padStart(9, '0'));
 }
 exports.nanotimestamp2str = nanotimestamp2str;
 /** parse nano timestamp string to bigint value
@@ -1383,6 +1646,31 @@ function str2nanotimestamp(str, format = 'YYYY.MM.DD HH:mm:ss.SSSSSSSSS') {
             BigInt(str.slice(i_nanosecond_start, i_nanosecond_start + 9)));
 }
 exports.str2nanotimestamp = str2nanotimestamp;
+function ipaddr2str(buffer, le = true) {
+    let buf = buffer;
+    if (le)
+        buf = buffer.slice().reverse();
+    const i_non_zero = buf.findIndex(x => x);
+    if (i_non_zero !== -1 && i_non_zero < 12) // ipv6 (i_non_zero === -1 或 0 < i_non_zero < 12)
+        return [...buf].map(x => x.toString(16)
+            .padStart(2, '0')).join(':');
+    else // ipv4
+        return buf.subarray(12).join('.');
+}
+exports.ipaddr2str = ipaddr2str;
+function uuid2str(buffer, le = true) {
+    const str = int1282str(buffer, le);
+    return `${str.slice(0, 8)}-${str.slice(8, 12)}-${str.slice(12, 16)}-${str.slice(16, 20)}-${str.slice(20)}`;
+}
+exports.uuid2str = uuid2str;
+function int1282str(buffer, le = true) {
+    let buf = buffer;
+    if (le)
+        buf = buffer.slice().reverse();
+    return [...buf].map(x => x.toString(16)
+        .padStart(2, '0')).join('');
+}
+exports.int1282str = int1282str;
 class DDB {
     /**
         Initialize an instance of DolphinDB Client using the WebSocket URL