dolphindb 2.0.1102 → 2.0.1103

package/browser.d.ts

@@ -194,7 +194,7 @@ export interface InspectOptions {
 }
 /** 根据 DdbType 格式化单个元素 (value) 为字符串  Formats a single element (value) as a string according to DdbType, null returns a 'null' string */
 export declare function format(type: DdbType, value: DdbValue, le: boolean, options?: InspectOptions): string;
-/** 格式化向量、集合中的第 index 项为字符串  formatted vector, the index-th item in the collection is a string */
+/** 格式化向量、集合中的第 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();
@@ -286,13 +286,13 @@ export declare function second2ms(second: number | null): number | null;
 export declare function second2str(second: number | null, format?: string): string;
 export declare function datetime2ms(datetime: number | null): number | null;
 export declare function datetime2str(datetime: number | null, format?: string): string;
+/** _datetime_formatter.format 会在 date 为 Invalid Date 时抛出错误 */
 export declare function timestamp2ms(timestamp: bigint | null): number | null;
 /** format timestamp (bigint) to string
     - timestamp: bigint value
     - format?:
         格式串，默认是 `YYYY.MM.DD HH:mm:ss.SSS`  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
-*/
+        https://day.js.org/docs/en/parse/string-format#list-of-all-available-parsing-tokens */
 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;
@@ -302,8 +302,7 @@ export declare function datehour2str(datehour: number | null, format?: string):
     - format?:
         对应传入字符串的格式串，默认是 `YYYY.MM.DD HH:mm:ss.SSS`
         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
-*/
+        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 nanotime2ns(nanotime: bigint | null): bigint | null;
 export declare function nanotime2str(nanotime: bigint | null, format?: string): string;

package/browser.js

@@ -951,7 +951,7 @@ export class DdbObj {
             case DdbType.complex:
             case DdbType.point:
                 return [value];
-            case DdbType.duration:
+            case DdbType.duration: {
                 let bufs = new Int32Array(length * 2);
                 for (let i = 0; i < length; i++) {
                     const { data, unit } = value[i];
@@ -959,6 +959,7 @@ export class DdbObj {
                     bufs[2 * i + 1] = unit;
                 }
                 return [bufs];
+            }
             case DdbType.any: {
                 // [1, 2, 'a', 'aaa']
                 // any[4](<Buffer 
@@ -1303,6 +1304,22 @@ export function format(type, value, le, options = {}) {
             :
                 '';
     }
+    function format_time(formatter, _null) {
+        if (value === null || value === _null)
+            return get_nullstr();
+        let str;
+        // formatter 可能会在 value 不属于 new Date() 有效值时，调用  抛出错误，这里统一处理
+        try {
+            str = formatter(value);
+        }
+        catch (error) {
+            if (error instanceof RangeError)
+                str = 'Invalid Date';
+            else
+                throw error;
+        }
+        return colors ? magenta(str) : str;
+    }
     switch (type) {
         case DdbType.bool:
             if (value === null || value === nulls.int8)
@@ -1348,68 +1365,23 @@ export function format(type, value, le, options = {}) {
                 return colors ? green(str) : str;
             }
         case DdbType.date:
-            if (value === null || value === nulls.int32)
-                return get_nullstr();
-            else {
-                const str = date2str(value);
-                return colors ? magenta(str) : str;
-            }
+            return format_time(date2str, nulls.int32);
         case DdbType.month:
-            if (value === null || value === nulls.int32)
-                return get_nullstr();
-            else {
-                const str = month2str(value);
-                return colors ? magenta(str) : str;
-            }
+            return format_time(month2str, nulls.int32);
         case DdbType.time:
-            if (value === null || value === nulls.int32)
-                return get_nullstr();
-            else {
-                const str = time2str(value);
-                return colors ? magenta(str) : str;
-            }
+            return format_time(time2str, nulls.int32);
         case DdbType.minute:
-            if (value === null || value === nulls.int32)
-                return get_nullstr();
-            else {
-                const str = minute2str(value);
-                return colors ? magenta(str) : str;
-            }
+            return format_time(minute2str, nulls.int32);
         case DdbType.second:
-            if (value === null || value === nulls.int32)
-                return get_nullstr();
-            else {
-                const str = second2str(value);
-                return colors ? magenta(str) : str;
-            }
+            return format_time(second2str, nulls.int32);
         case DdbType.datetime:
-            if (value === null || value === nulls.int32)
-                return get_nullstr();
-            else {
-                const str = datetime2str(value);
-                return colors ? magenta(str) : str;
-            }
+            return format_time(datetime2str, nulls.int32);
         case DdbType.timestamp:
-            if (value === null || value === nulls.int64)
-                return get_nullstr();
-            else {
-                const str = timestamp2str(value);
-                return colors ? magenta(str) : str;
-            }
+            return format_time(timestamp2str, nulls.int64);
         case DdbType.nanotime:
-            if (value === null || value === nulls.int64)
-                return get_nullstr();
-            else {
-                const str = nanotime2str(value);
-                return colors ? magenta(str) : str;
-            }
+            return format_time(nanotime2str, nulls.int64);
         case DdbType.nanotimestamp:
-            if (value === null || value === nulls.int64)
-                return get_nullstr();
-            else {
-                const str = nanotimestamp2str(value);
-                return colors ? magenta(str) : str;
-            }
+            return format_time(nanotimestamp2str, nulls.int64);
         case DdbType.float:
             if (value === null || value === nulls.float32)
                 return get_nullstr();
@@ -1447,12 +1419,7 @@ export function format(type, value, le, options = {}) {
             return colors ? cyan(str) : str;
         }
         case DdbType.datehour:
-            if (value === null || value === nulls.int32)
-                return get_nullstr();
-            else {
-                const str = datehour2str(value);
-                return colors ? magenta(str) : str;
-            }
+            return format_time(datehour2str, nulls.int32);
         case DdbType.ipaddr: {
             const str = ipaddr2str(value, le);
             return colors ? cyan(str) : str;
@@ -1496,7 +1463,7 @@ export function format(type, value, le, options = {}) {
             return value === null ? get_nullstr() : String(value);
     }
 }
-/** 格式化向量、集合中的第 index 项为字符串  formatted vector, the index-th item in the collection is a string */
+/** 格式化向量、集合中的第 index 项为字符串，空值返回 'null' 字符串  formatted vector, the index-th item in the collection is a string, a null value returns a 'null' string */
 export function formati(obj, index, options = {}) {
     assert(index < obj.rows, 'index < obj.rows');
     if (64 <= obj.type && obj.type < 128) { // array vector
@@ -2002,6 +1969,7 @@ export function datetime2str(datetime, format = 'YYYY.MM.DD HH:mm:ss') {
         :
             dayjs(datetime2ms(datetime)).format(format);
 }
+/** _datetime_formatter.format 会在 date 为 Invalid Date 时抛出错误 */
 export function timestamp2ms(timestamp) {
     if (timestamp === null || timestamp === nulls.int64)
         return null;
@@ -2012,8 +1980,7 @@ export function timestamp2ms(timestamp) {
     - timestamp: bigint value
     - format?:
         格式串，默认是 `YYYY.MM.DD HH:mm:ss.SSS`  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
-*/
+        https://day.js.org/docs/en/parse/string-format#list-of-all-available-parsing-tokens */
 export function timestamp2str(timestamp, format = 'YYYY.MM.DD HH:mm:ss.SSS') {
     return (timestamp === null || timestamp === nulls.int64) ?
         'null'
@@ -2038,8 +2005,7 @@ export function datehour2str(datehour, format = 'YYYY.MM.DDTHH') {
     - format?:
         对应传入字符串的格式串，默认是 `YYYY.MM.DD HH:mm:ss.SSS`
         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
-*/
+        https://day.js.org/docs/en/parse/string-format#list-of-all-available-parsing-tokens */
 export function str2timestamp(str, format = 'YYYY.MM.DD HH:mm:ss.SSS') {
     if (!str || str === 'null')
         return nulls.int64;