---
source_url: https://docs.dolphindb.cn/zh/funcs/c/convertEncode.html
fetched_at: 2026-05-19T09:15:50Z
category: funcs
title: convertEncode
sha1: 2cda4d3b5c983db81687f6cae5ff185993ccc335
---

# convertEncode

## 语法

`convertEncode(str, srcEncode, destEncode)`

## 详情

转换字符串编码。DolphinDB 对编码名称的大小写敏感，所有编码名称必须用小写表示。

Window 版本目前仅支持 gbk 和 utf-8 两种编码的相互转换。Linux 版本支持任意两种编码之间的转换。

## 参数

**str** 是一个字符串标量/向量，值为字符串类型的字典，或表。

**srcEncode** 是一个字符串，表示 *str* 原来的编码名称。

**destEncode** 是一个字符串，表示 *str* 的目标编码名称。

## 返回值

STRING 类型标量/向量/字典/表。

## 例子

```dolphindb
convertEncode("高性能分布式时序数据库","utf-8","gbk");
// output: 高性能分布式时序数据库

convertEncode(["hello","DolphinDB"],"gbk","utf-8");
// output: ["hello","DolphinDB"]
```

`convertEncode`
可以对字典中的符串类型的值进行转换。

```dolphindb
x=1 2 3
y= `C1`C2`D1
d=dict(x,y)
convertEncode(d, "UTF-8", "GBK")
// output: 
1: C1
2: C2
3: D1
*/
```

`convertEncode`
函数会自动识别并转换表中所有字符串类型的列，其他数据类型的列将被自动忽略。

```dolphindb
t=table(["t1", "t1", "t2", "t3"] as type, [11, 11.5, 10, 14] as price)
convertEncode(t, "UTF-8", "GBK")
```

| type | price |
| --- | --- |
| t1 | 11 |
| t1 | 11.5 |
| t2 | 10 |
| t3 | 14 |

相关函数：[fromUTF8](../f/fromUTF8.html), [toUTF8](../t/toUTF8.html)
