dolphindb 3.0.204 → 3.0.208

package/browser.d.ts

@@ -1,3 +1,4 @@
+import { type Dayjs } from 'dayjs';
 import 'xshell/prototype.browser.js';
 import { Lock } from 'xshell/utils.browser.js';
 import { type WebSocketConnectionError } from 'xshell/net.browser.js';
@@ -10,7 +11,7 @@ export declare const nulls: {
     readonly float32: -3.4028234663852886e+38;
     /** -Number.MAX_VALUE */
     readonly double: number;
-    readonly bytes16: Uint8Array;
+    readonly bytes16: Uint8Array<ArrayBuffer>;
 };
 export declare enum DdbForm {
     scalar = 0,
@@ -417,7 +418,7 @@ export interface ConvertOptions {
     /** `'ms'` timestamp 类型转换为字符串表示时显示到秒还是毫秒 */
     timestamp?: 's' | 'ms';
 }
-export declare function convert(type: DdbType, value: DdbValue, le: boolean, { blob, char, timestamp }?: ConvertOptions): string | number | bigint | boolean | Uint8Array | number[] | DdbFunctionDefValue | DdbDurationValue | DdbDecimal32Value | DdbDecimal64Value | Int8Array | Int16Array | Int32Array | Float32Array | Float64Array | BigInt64Array | BigInt128Array | string[] | Uint8Array[] | DdbObj<DdbValue>[] | IotVectorItemValue | DdbSymbolExtendedValue | DdbArrayVectorValue | DdbDecimal32VectorValue | DdbDecimal64VectorValue | DdbDecimal128VectorValue | DdbDurationVectorValue | DdbMatrixValue | DdbChartValue | DdbTensorValue;
+export declare function convert(type: DdbType, value: DdbValue, le: boolean, { blob, char, timestamp }?: ConvertOptions): string | number | bigint | boolean | number[] | Uint8Array<ArrayBufferLike> | DdbFunctionDefValue | DdbDurationValue | DdbDecimal32Value | DdbDecimal64Value | Int8Array<ArrayBufferLike> | Int16Array<ArrayBufferLike> | Int32Array<ArrayBufferLike> | Float32Array<ArrayBufferLike> | Float64Array<ArrayBufferLike> | BigInt64Array<ArrayBufferLike> | BigInt128Array | string[] | Uint8Array<ArrayBufferLike>[] | DdbObj<DdbValue>[] | IotVectorItemValue | DdbSymbolExtendedValue | DdbArrayVectorValue | DdbDecimal32VectorValue | DdbDecimal64VectorValue | DdbDecimal128VectorValue | DdbDurationVectorValue | DdbMatrixValue | DdbChartValue | DdbTensorValue;
 /** 转换一个向量到 js 原生数组 */
 export declare function converts(type: DdbType, value: DdbVectorValue, rows: number, le: boolean, options?: ConvertOptions): any[] | Uint8Array;
 export declare class DdbVoid extends DdbObj<undefined> {
@@ -442,16 +443,16 @@ export declare class DdbDouble extends DdbObj<number> {
     constructor(value: number | null);
 }
 export declare class DdbDateTime extends DdbObj<number> {
-    constructor(value: number | null);
+    constructor(value?: null | number | string | Date | Dayjs);
 }
 export declare class DdbTimeStamp extends DdbObj<bigint> {
-    /** @example
-        new DdbTimeStamp(new Date().getTime())
-        new DdbTimeStamp(dayjs().valueOf()) */
-    constructor(value?: bigint | null | number);
+    constructor(value?: null | number | string | Date | Dayjs);
 }
 export declare class DdbNanoTimeStamp extends DdbObj<bigint> {
-    constructor(value: bigint | null);
+    constructor(value?: null | number | string | Date | Dayjs);
+}
+export declare class DdbDate extends DdbObj<number> {
+    constructor(value?: null | number | string | Date | Dayjs);
 }
 export declare class DdbBlob extends DdbObj<Uint8Array> {
     constructor(value: Uint8Array | ArrayBuffer);

package/browser.js

@@ -1,13 +1,13 @@
-import dayjs from 'dayjs';
+import { default as dayjs } from 'dayjs';
 import DayjsCustomParseFormat from 'dayjs/plugin/customParseFormat.js';
 dayjs.extend(DayjsCustomParseFormat);
 import ipaddrjs from 'ipaddr.js';
 const { fromByteArray: buf2ipaddr } = ipaddrjs;
 import 'xshell/prototype.browser.js';
 import { blue, cyan, green, grey, magenta } from 'xshell/chalk.browser.js';
-import { concat, assert, Lock, genid, seq, zip_object, decode, delay } from 'xshell/utils.browser.js';
+import { concat, assert, Lock, genid, seq, zip_object, decode, delay, check } from 'xshell/utils.browser.js';
 import { connect_websocket } from 'xshell/net.browser.js';
-import { t } from './i18n/index.js';
+import { t } from "./i18n/index.js";
 export const nulls = {
     int8: -0x80, // -128
     int16: -0x80_00, // -32768
@@ -2221,24 +2221,16 @@ export class DdbDateTime extends DdbObj {
         super({
             form: DdbForm.scalar,
             type: DdbType.datetime,
-            value
+            value: get_ddb_time_value('DdbDateTime', value)
         });
     }
 }
 export class DdbTimeStamp extends DdbObj {
-    /** @example
-        new DdbTimeStamp(new Date().getTime())
-        new DdbTimeStamp(dayjs().valueOf()) */
     constructor(value) {
-        if (value === undefined)
-            value = new Date().getTime();
-        if (typeof value === 'number')
-            value = BigInt(-(1000 * 60 * new Date(value).getTimezoneOffset()) +
-                value);
         super({
             form: DdbForm.scalar,
             type: DdbType.timestamp,
-            value
+            value: get_ddb_time_value('DdbTimeStamp', value)
         });
     }
 }
@@ -2247,10 +2239,46 @@ export class DdbNanoTimeStamp extends DdbObj {
         super({
             form: DdbForm.scalar,
             type: DdbType.nanotimestamp,
-            value
+            value: get_ddb_time_value('DdbNanoTimeStamp', value)
         });
     }
 }
+export class DdbDate extends DdbObj {
+    constructor(value) {
+        super({
+            form: DdbForm.scalar,
+            type: DdbType.date,
+            value: get_ddb_time_value('DdbDate', value)
+        });
+    }
+}
+function get_ddb_time_value(classname, value) {
+    if (value === null)
+        return null;
+    if (classname === 'DdbNanoTimeStamp' && typeof value === 'string')
+        return str2nanotimestamp(value);
+    let date;
+    if (value === undefined)
+        date = new Date();
+    else if (typeof value === 'number' || typeof value === 'string')
+        date = new Date(value);
+    else if (value instanceof Date)
+        date = value;
+    else if (dayjs.isDayjs(value))
+        date = new Date(value.valueOf());
+    else
+        throw new Error(t('value 不能转换为 {{classname}}', { classname }));
+    switch (classname) {
+        case 'DdbDateTime':
+            return (date.getTime() - 1000 * 60 * date.getTimezoneOffset()) / 1000;
+        case 'DdbTimeStamp':
+            return BigInt(date.getTime() - 1000 * 60 * date.getTimezoneOffset());
+        case 'DdbNanoTimeStamp':
+            return BigInt(date.getTime() - 1000 * 60 * date.getTimezoneOffset()) * 1000000n;
+        case 'DdbDate':
+            return Math.floor((date.getTime() - 1000 * 60 * date.getTimezoneOffset()) / (1000 * 3600 * 24));
+    }
+}
 export class DdbBlob extends DdbObj {
     constructor(value) {
         assert(value, t('new DdbBlob 不能传空的 value'));
@@ -2673,12 +2701,12 @@ export function nanotimestamp2str(nanotimestamp, format = 'YYYY.MM.DD HH:mm:ss.S
 export function str2nanotimestamp(str, format = 'YYYY.MM.DD HH:mm:ss.SSSSSSSSS') {
     if (!str || str === 'null')
         return nulls.int64;
-    assert(str.length === format.length, t('nanotimestamp 字符串长度必须等于格式串长度'));
+    check(str.length === format.length, t('nanotimestamp 字符串长度必须等于格式串长度'));
     const i_second_start = format.indexOf('ss');
-    assert(i_second_start !== -1, t('格式串必须包含秒的格式 (ss)'));
+    check(i_second_start !== -1, t('格式串必须包含秒的格式 (ss)'));
     const i_second_end = i_second_start + 2;
     const i_nanosecond_start = format.indexOf('SSSSSSSSS', i_second_end);
-    assert(i_nanosecond_start !== -1, t('格式串必须包含纳秒的格式 (SSSSSSSSS)'));
+    check(i_nanosecond_start !== -1, t('格式串必须包含纳秒的格式 (SSSSSSSSS)'));
     const ms = dayjs(str.slice(0, i_second_end), format.slice(0, i_second_end)).valueOf();
     return (BigInt(-(1000 * 60 * new Date(ms).getTimezoneOffset()) +
         ms) * 1000000n