dolphindb 2.0.1103 → 3.0.0

package/index.d.ts

@@ -3,7 +3,7 @@ import type { InspectOptions as UtilInspectOptions } from 'util';
 import { inspect, Lock, type WebSocket, type WebSocketConnectionError } from 'xshell';
 import { type DdbDecimal128Value, type DdbDecimal128VectorValue } from './data-types/decimal-128.js';
 import { BigInt128Array } from './shared/bigint-128-array.js';
-import { DdbChartType, DdbDurationUnit, DdbForm, DdbFunctionType, DdbType } from './shared/constants.js';
+import { DdbChartType, DdbDurationUnit, DdbForm, DdbFunctionType, DdbType, DdbVoidType } from './shared/constants.js';
 export * from './shared/constants.js';
 export type { DdbDecimal128Value, DdbDecimal128VectorValue } from './data-types/decimal-128.js';
 export interface DdbFunctionDefValue {
@@ -188,7 +188,7 @@ export declare function format(type: DdbType, value: DdbValue, le: boolean, opti
 /** 格式化向量、集合中的第 index 项为字符串，空值返回 'null' 字符串  formatted vector, the index-th item in the collection is a string, a null value returns a 'null' string */
 export declare function formati(obj: DdbVectorObj, index: number, options?: InspectOptions): string;
 export declare class DdbVoid extends DdbObj<undefined> {
-    constructor();
+    constructor(value?: DdbVoidType);
 }
 export declare class DdbBool extends DdbObj<boolean> {
     constructor(value: boolean | null);

package/index.js

@@ -9,7 +9,7 @@ import { t } from './i18n/index.js';
 import { DdbDecimal128Serializor } from './data-types/decimal-128.js';
 import { BigInt128Array } from './shared/bigint-128-array.js';
 import { is_decimal_type, is_decimal_null_value, get_duration_unit } from './shared/utils.js';
-import { nulls, DdbChartType, DdbDurationUnit, DdbForm, DdbFunctionType, DdbType } from './shared/constants.js';
+import { nulls, DdbChartType, DdbDurationUnit, DdbForm, DdbFunctionType, DdbType, DdbVoidType } from './shared/constants.js';
 export * from './shared/constants.js';
 // Simulate other TypedArray behavior in nodejs
 BigInt128Array.prototype[inspect.custom] = function () {
@@ -268,13 +268,12 @@ export class DdbObj {
     }
     static parse_scalar(buf, le, type) {
         switch (type) {
-            case DdbType.void:
-                return [1, null];
             case DdbType.bool: {
                 const dv = new DataView(buf.buffer, buf.byteOffset);
                 const value = dv.getInt8(0);
                 return [1, value === nulls.int8 ? null : Boolean(value)];
             }
+            case DdbType.void:
             case DdbType.char: {
                 const dv = new DataView(buf.buffer, buf.byteOffset);
                 const value = dv.getInt8(0);
@@ -723,10 +722,7 @@ export class DdbObj {
                 case DdbForm.scalar:
                     switch (type) {
                         case DdbType.void:
-                            // Server 实现中区分了 explicitNull
-                            // Void::serialize()
-                            //     isNothing() ? 0 : 1;
-                            return [Uint8Array.of(0)];
+                            return [Uint8Array.of(Number(value))];
                         case DdbType.bool:
                             return [
                                 Int8Array.of(value === null ?
@@ -905,7 +901,6 @@ export class DdbObj {
             case DdbType.void:
                 return [];
             case DdbType.bool:
-                return [value];
             case DdbType.char:
                 return [value];
             case DdbType.short:
@@ -1281,7 +1276,7 @@ let _grouping = true;
 /** 缓存，为了优化性能，通常 options.decimals 都是不变的 */
 let _formatter = new Intl.NumberFormat('en-US', { maximumFractionDigits: 20 });
 /** 用来处理时差  To deal with jet lag */
-let _datetime_formatter = new Intl.DateTimeFormat('zh-CN', { dateStyle: 'short', timeStyle: 'medium', timeZone: 'UTC' });
+let _datetime_formatter = new Intl.DateTimeFormat('zh-CN', { dateStyle: 'short', timeStyle: 'medium', timeZone: 'UTC', hour12: false });
 /** 根据 DdbType 格式化单个元素 (value) 为字符串，空值返回 'null' 字符串  Formats a single element (value) as a string according to DdbType, null returns a 'null' string */
 export function format(type, value, le, options = {}) {
     const formatter = (() => {
@@ -1316,6 +1311,10 @@ export function format(type, value, le, options = {}) {
         return options.colors ? str.magenta : str;
     }
     switch (type) {
+        case DdbType.void: {
+            const str = value === DdbVoidType.default ? 'default' : 'null';
+            return options.colors ? str.grey : str;
+        }
         case DdbType.bool:
             return inspect((value === null || value === nulls.int8) ?
                 null
@@ -1552,11 +1551,11 @@ export function formati(obj, index, options = {}) {
     }
 }
 export class DdbVoid extends DdbObj {
-    constructor() {
+    constructor(value = DdbVoidType.undefined) {
         super({
             form: DdbForm.scalar,
             type: DdbType.void,
-            value: null,
+            value,
         });
     }
 }