dolphindb 2.0.1036 → 2.0.1101

package/CHANGELOG.md

@@ -0,0 +1,15 @@
+# Release Notes
+
+## Version: 2.0.1101
+
+### Feature Enhancement
+
+Support the serializtion of DURATION vector. 
+
+## Version: 2.0.1100
+
+### Feature Enhancement
+
+Support for processing exchange identifiers as DURATION type.  
+
+

package/CHANGELOG.zh.md

@@ -0,0 +1,15 @@
+# 版本发布说明
+
+## 版本：2.0.1101
+
+### 功能改善
+
+新增对 DURATION Vector 序列化的支持。
+
+## 版本: 2.0.1100
+
+### 功能改善
+
+新增 DURATION 类型对交易所标识的支持。
+
+

package/README.md

@@ -24,25 +24,27 @@ https://www.npmjs.com/package/dolphindb
 - Use WebSocket to communicate with DolphinDB database, exchange data in binary format, and support real-time push of streaming data
 - Support running in browser environment and Node.js environment
 - Use TypedArray such as Int32Array in JavaScript to process binary data, with high performance
-- A single call supports serialized upload of up to 2GB of data, and the amount of downloaded data is not limited
+- Support serialized upload of up to 2GB of data with a single call, and the amount of downloaded data is not limited
 
 ## Installation
-```bash
-# 1. Install the latest version of Node.js and browser on the machine
-
-# 2. Create a new project (skip this step if you already have a project)
-mkdir dolphindb-example
-cd dolphindb-example
-npm init --yes
-# Open the package.json file with an editor, add the line "type": "module", below "main": "./index.js",
-# This enables the use of ECMAScript modules, and in the code behind you can use import { DDB } from 'dolphindb' to import npm packages
-
-# 3. Install npm packages in your project
-npm install dolphindb
-```
+
+1. Install the latest version of Node.js and browser.
+2. (Optional) Create a new project (skip this step if there's an existing project):
+
+    ```bash
+    mkdir dolphindb-example
+    cd dolphindb-example
+    npm init --yes
+    ```
+3. Open the package.json file with an editor, and add the line `"type": "module"`, below `"main": "./index.js"`. This enables the ECMAScript modules. In the following code, you can use `import { DDB } from 'dolphindb'` to import npm packages.
+4. Install npm packages in your project.
+
+    ```bash
+    npm install dolphindb
+    ```
 
 ## Usage
-### 0. Initialize and connect to DolphinDB
+### Initializing and connecting to DolphinDB
 #### NPM
 ```ts
 import { DDB } from 'dolphindb'
@@ -70,9 +72,9 @@ await ddb.connect()
 </script>
 ```
 
-Code completion, function prompt data:  
-https://cdn.dolphindb.cn/assets/docs.zh.json  
-https://cdn.dolphindb.cn/assets/docs.en.json
+Data for code completion and function prompts:
+- https://cdn.dolphindb.cn/assets/docs.zh.json  
+- https://cdn.dolphindb.cn/assets/docs.en.json
 
 #### DDB options
 ```ts
@@ -102,7 +104,7 @@ let ddbsecure = new DDB('wss://dolphindb.com', {
 ```
 
 
-### 1. Call Functions
+### Calling functions
 #### Example
 ```ts
 import { DdbInt } from 'dolphindb'
@@ -113,19 +115,21 @@ const result = await ddb.call('add', [new DdbInt(1), new DdbInt(1)])
 console.log(result.value === 2)  // true
 ```
 
-#### The DolphinDB JavaScript API uses DdbObj objects to represent data types in DolphinDB
-In the above example, two parameters 1 (corresponding to the int type in DolphinDB) are uploaded to the DolphinDB database as parameters of the add function, then the result of the function call is received.
+#### Using DdbObj objects to represent data types in DolphinDB
+
+In the preceding example, two parameters (`new DdbInt(1)`, corresponding to the INT type in DolphinDB) are uploaded to the DolphinDB database as parameters of the add function, then the result of the function call is received.
 
 `<DdbInt>` is used by TypeScript to infer the type of the return value
 
 - result is a `DdbInt`, which is also a `DdbObj<number>`
 - result.form is a `DdbForm.scalar`
 - result.type is a `DdbType.int`
-- result.value is native `number` in JavaScript (the value range and precision of int can be accurately represented by JavaScript number)
+- result.value is data of `number` type in JavaScript (the value range and precision of INT can be accurately represented by JavaScript `number` type)
 
 It is recommended to first understand the concepts related to TypedArray in JavaScript, you can refer to:  
-https://stackoverflow.com/questions/42416783/where-to-use-arraybuffer-vs-typed-array-in-javascript  
-https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/TypedArray  
+
+- https://stackoverflow.com/questions/42416783/where-to-use-arraybuffer-vs-typed-array-in-javascript  
+- https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/TypedArray  
 
 
 ```ts
@@ -220,7 +224,10 @@ enum DdbType {
 }
 ```
 
-##### If there is no shortcut class, you can also specify form and type to manually create a DdbObj object
+##### Specifying form and type to manually create a DdbObj object
+
+If there is no shortcut class, you can also specify form and type to manually create a DdbObj object:
+
 ```ts
 // Created by the DdbDateTime shortcut class
 new DdbDateTime(1644573600)
@@ -257,7 +264,10 @@ const obj = new DdbSetInt(
 )
 ```
 
-##### NULL object in the form of scalar, the value corresponding to DdbObj is null in JavaScript
+##### NULL object in the form of scalar
+
+For the NULL object in the form of scalar, the value corresponding to DdbObj is null in JavaScript：
+
 ```ts
 ;(await ddb.eval('double()')).value === null
 
@@ -267,7 +277,7 @@ new DdbDouble(null)
 ```
 
 
-#### `call` Method Declaration
+#### `call` method declaration
 ```ts
 async call <T extends DdbObj> (
     /** function name */
@@ -297,7 +307,7 @@ async call <T extends DdbObj> (
 ```
 
 
-### 2. Execute Script
+### Executing the script
 #### Example
 ```ts
 const result = await ddb.eval(
@@ -314,7 +324,7 @@ const result = await ddb.eval(
 console.log(result.value === 2n)  // true
 ```
 
-In the above example, a script is uploaded through a string to the DolphinDB database for execution, and the execution result of the last statement `foo(1l, 1l)` is received.
+In the preceding example, a script is uploaded through a string to the DolphinDB database for execution, and the execution result of the last statement `foo(1l, 1l)` is received.
 
 `<DdbLong>` is used by TypeScript to infer the type of the return value
 
@@ -325,7 +335,8 @@ In the above example, a script is uploaded through a string to the DolphinDB dat
 
 As long as the WebSocket connection is not disconnected, the custom function `foo` will always exist in the subsequent session and can be reused, for example, you can use `await ddb.call<DdbInt>('foo', [new DdbInt(1), new DdbInt(1)])` to call this custom function
 
-#### `eval` Method Declaration
+#### `eval` Method declaration
+
 ```ts
 async eval <T extends DdbObj> (
     /** the script to execute */
@@ -340,7 +351,7 @@ async eval <T extends DdbObj> (
 ```
 
 
-### 3. Upload Variables
+### Uploading variables
 #### Example
 ```ts
 import { DdbVectorDouble } from 'dolphindb'
@@ -351,11 +362,11 @@ a.fill(1.0)
 ddb.upload(['bar1', 'bar2'], [new DdbVectorDouble(a), new DdbVectorDouble(a)])
 ```
 
-In the above example, two variables `bar1`, `bar2` are uploaded, and the variable value is a double vector of length 10000
+In the preceding example, two variables, `bar1` and `bar2`, are uploaded, and the variable value is a double vector of length 10000
 
-As long as the WebSocket connection is not disconnected, the variables `bar1`, `bar2` will always exist in the subsequent session and can be reused
+As long as the WebSocket connection is on, variables `bar1` and `bar2` will always exist in subsequent session and can be reused
 
-#### `upload` Method Declaration
+#### `upload` method declaration
 ```ts
 async upload (
     /** variable names */
@@ -367,7 +378,7 @@ async upload (
 ```
 
 
-### 4. Some Examples
+### Examples
 ```ts
 import { nulls, DdbInt, timestamp2str, DdbVectorSymbol, DdbTable, DdbVectorDouble } from 'dolphindb'
 
@@ -402,7 +413,8 @@ new DdbTable(
 )
 ```
 
-### 5. Streaming Data
+### Streaming data
+
 ```ts
 // New Streaming Data Connection Configuration
 let sddb = new DDB('ws://192.168.0.43:8800', {
@@ -474,6 +486,7 @@ export interface StreamingData extends StreamingParams {
 
 
 ### Development
+
 ```shell
 # Install the latest version of nodejs
 # https://nodejs.org/en/download/current/

package/README.zh.md

@@ -27,23 +27,24 @@ https://www.npmjs.com/package/dolphindb
 - 单次调用支持最大 2 GB 数据的序列化上传，下载数据量不受限制
 
 ## 安装
-```bash
-# 1. 在机器上安装最新版的 Node.js 及浏览器
-
-# 2. 创建新项目
-mkdir dolphindb-example
-cd dolphindb-example
-npm init --yes
-# 用编辑器打开 package.json 文件，在 "main": "./index.js", 下面加入一行 "type": "module",
-# 这样能够启用 ECMAScript modules，在后面代码中可以使用 import { DDB } from 'dolphindb' 导入 npm 包
-
-# 3. 在项目中安装 npm 包
-npm install dolphindb
-```
+
+1. 在机器上安装最新版的 Node.js 及浏览器。
+2. （可选）使用以下命令创建新项目。如果已有项目，可跳过此步。
+    ```bash
+    mkdir dolphindb-example
+    cd dolphindb-example
+    npm init --yes
+    ```
+3. 用编辑器打开 package.json 文件，在 `"main": "./index.js"` 下方加入一行 "type": "module", 这样能够启用 ECMAScript modules，在后面代码中可以使用 `import { DDB } from 'dolphindb'` 导入 npm 包。
+4. 在项目中安装 npm 包。
+    ```bash
+    npm install dolphindb
+    ```
 
 ## 用法
-### 0. 初始化并连接到 DolphinDB
+### 初始化并连接到 DolphinDB
 #### NPM
+
 ```ts
 import { DDB } from 'dolphindb'
 // 已有的使用 CommonJS 模块的项目的导入方法为 const { DDB } = await import('dolphindb')
@@ -60,6 +61,7 @@ await ddb.connect()
 ```
 
 #### CDN
+
 ```html
 <script type="module">
     import { DDB } from 'https://cdn.dolphindb.cn/assets/api.js'
@@ -71,11 +73,12 @@ await ddb.connect()
 ```
 
 代码补全、函数提示数据:  
-https://cdn.dolphindb.cn/assets/docs.zh.json  
-https://cdn.dolphindb.cn/assets/docs.en.json
+- https://cdn.dolphindb.cn/assets/docs.zh.json  
+- https://cdn.dolphindb.cn/assets/docs.en.json
 
 
 #### DDB 选项
+
 ```ts
 let ddb = new DDB('ws://127.0.0.1:8848', {
     // 是否在建立连接后自动登录，默认 `true`
@@ -100,7 +103,7 @@ let ddb = new DDB('ws://127.0.0.1:8848', {
 ```
 
 
-### 1. 调用函数
+### 调用函数
 #### 例子
 ```ts
 import { DdbInt } from 'dolphindb'
@@ -111,7 +114,8 @@ const result = await ddb.call('add', [new DdbInt(1), new DdbInt(1)])
 console.log(result.value === 2)  // true
 ```
 
-#### DolphinDB JavaScript API 用 DdbObj 对象来表示 DolphinDB 中的数据类型
+##### 用 DdbObj 对象来表示 DolphinDB 中的数据类型
+
 上面例子中，上传了两个参数 1 (对应 DolphinDB 中的 int 类型) 到 DolphinDB 数据库，作为 add 函数的参数，并接收函数调用的结果 result
 
 `<DdbInt>` 用于 TypeScript 推断返回值的类型
@@ -217,7 +221,10 @@ enum DdbType {
 }
 ```
 
-##### 没有快捷类的类型，也可以指定 form 和 type 手动创建 DdbObj 对象
+##### 无快捷类的类型
+
+对于没有快捷类的类型，可指定 form 和 type 手动创建 DdbObj 对象
+
 ```ts
 // 通过 DdbDateTime 快捷类创建
 new DdbDateTime(1644573600)
@@ -254,7 +261,10 @@ const obj = new DdbSetInt(
 )
 ```
 
-##### scalar 形式的 NULL 对象, 对应 DdbObj 的 value 为 JavaScript 中的 null
+#### scalar 形式的 NULL 对象
+
+scalar 形式的 NULL 对象，其对应 DdbObj 的 value 为 JavaScript 中的 null：
+
 ```ts
 ;(await ddb.eval('double()')).value === null
 
@@ -294,7 +304,7 @@ async call <T extends DdbObj> (
 ```
 
 
-### 2. 执行脚本
+### 执行脚本
 #### 例子
 ```ts
 const result = await ddb.eval(
@@ -337,7 +347,7 @@ async eval <T extends DdbObj> (
 ```
 
 
-### 3. 上传变量
+### 上传变量
 #### 例子
 ```ts
 import { DdbVectorDouble } from 'dolphindb'
@@ -364,7 +374,8 @@ async upload (
 ```
 
 
-### 4. 一些例子
+### 其他例子
+
 ```ts
 import { nulls, DdbInt, timestamp2str, DdbVectorSymbol, DdbTable, DdbVectorDouble } from 'dolphindb'
 
@@ -400,7 +411,8 @@ new DdbTable(
 ```
 
 
-### 5. 流数据
+### 流数据
+
 ```ts
 // 新建流数据连接配置
 let sddb = new DDB('ws://192.168.0.43:8800', {
@@ -471,7 +483,8 @@ export interface StreamingData extends StreamingParams {
 ```
 
 
-### 开发
+### 开发方法
+
 ```shell
 # 安装最新版的 nodejs
 # https://nodejs.org/en/download/current/

package/browser.js

@@ -9,7 +9,7 @@ import { concat, assert, Lock, genid } from 'xshell/utils.browser.js';
 import { connect_websocket } from 'xshell/net.browser.js';
 import { t } from './i18n/index.js';
 import { DdbDecimal128Serializor } from './data-types/decimal-128.js';
-import { is_decimal_type, is_decimal_null_value } from './shared/utils/decimal-type.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';
 export * from './shared/constants.js';
 /** 可以表示所有 DolphinDB 数据库中的数据类型  Can represent data types in all DolphinDB databases */
@@ -951,6 +951,14 @@ export class DdbObj {
             case DdbType.complex:
             case DdbType.point:
                 return [value];
+            case DdbType.duration:
+                let bufs = new Int32Array(length * 2);
+                for (let i = 0; i < length; i++) {
+                    const { data, unit } = value[i];
+                    bufs[2 * i] = data;
+                    bufs[2 * i + 1] = unit;
+                }
+                return [bufs];
             case DdbType.any: {
                 // [1, 2, 'a', 'aaa']
                 // any[4](<Buffer 
@@ -1470,7 +1478,7 @@ export function format(type, value, le, options = {}) {
         }
         case DdbType.duration: {
             const { data, unit } = value;
-            const str = `${data}${DdbDurationUnit[unit]}`;
+            const str = `${data}${DdbDurationUnit[unit] ?? get_duration_unit(unit)}`;
             return colors ? magenta(str) : str;
         }
         case DdbType.decimal32: