# REGEXP_REPLACE

> StackQL 中的 REGEXP_REPLACE 函数：将字符串中与正则表达式匹配的部分替换为替换字符串。

Source: https://stackql.io/zh-hans/language-spec/functions/re/regexp_replace

将匹配的子字符串替换为替换字符串。  

另请参阅：  
[[` SELECT `]](/language-spec/select) [[ 正则表达式参考 ]](/language-spec/functions/re/reference) 

* * * 

## 语法

```sql
SELECT REGEXP_REPLACE(source, pattern, replacement) FROM <multipartIdentifier>;
```
## 参数

__*source*__  
要根据由正则表达式（`pattern`）定义的模式从中提取子字符串的字符串字面量或字符串列。  

__*pattern*__  
要搜索的正则表达式模式。  

__*replacement*__  
替换字符串。

> 替换字符串中支持对捕获组 `\1` 到 `\9` 的反向引用。  

## 返回值
返回一个字符串。

* * *

## 示例

### 替换列中的正则表达式模式

**StackQL**

```sql
select name,
regexp_replace(json_extract(properties, '$.timeCreated'), 'T.*', '') as date_created
from azure.compute.virtual_machines 
WHERE subscription_id = '273769f6-545f-45b2-8ab8-2f14ec5768dc';
```

**结果**

```
|------|--------------|
| name | date_created |
|------|--------------|
| vm0  | 2022-09-14   |
|------|--------------|
| vm1  | 2022-09-14   |
|------|--------------|
| vm2  | 2022-09-14   |
|------|--------------|
```

有关更多信息，请参阅 [https://github.com/nalgeon/sqlean/blob/main/docs/re.md](https://github.com/nalgeon/sqlean/blob/main/docs/re.md)