# REGEXP_REPLACE

> Função REGEXP_REPLACE no StackQL: substituir as partes de uma string que correspondem a uma expressão regular por uma string de substituição.

Source: https://stackql.io/pt-br/language-spec/functions/re/regexp_replace

Substitui uma substring correspondente pela string de substituição.  

Veja também:  
[[` SELECT `]](/language-spec/select) [[ Referência de expressões regulares ]](/language-spec/functions/re/reference) 

* * * 

## Sintaxe

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

__*source*__  
Uma string literal ou coluna de string na qual as correspondências da expressão regular `pattern` são substituídas por `replacement`.  

__*pattern*__  
O padrão de expressão regular a ser procurado.  

__*replacement*__  
A string de substituição.

> Oferece suporte a referências retroativas aos grupos capturados `\1` a `\9` na string de substituição.  

## Valor(es) retornado(s)
Retorna uma string.

* * *

## Exemplos

### Substituir um padrão de expressão regular em uma coluna

**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';
```

**Resultados**

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

Para obter mais informações, consulte [https://github.com/nalgeon/sqlean/blob/main/docs/re.md](https://github.com/nalgeon/sqlean/blob/main/docs/re.md)
