# REGEXP_REPLACE

> StackQL の REGEXP_REPLACE 関数：文字列のうち正規表現に一致する部分を置換文字列に置き換えます。

Source: https://stackql.io/ja/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) を参照してください。