# Left Função de script e de gráfico

Left() retorna uma string que consiste nos primeiros caracteres (os mais à esquerda) da string de entrada, em que o número de caracteres é determinado pelo segundo argumento.

Sintaxe:

Left(text, count)

Tipo de dados de retorno: caractere

Argumentos

| Argumento | Descrição |
| --- | --- |
| text | A string original. |
| count | Define o número de caracteres a ser incluído a partir da parte esquerda da string text. |

Exemplo: expressão de gráfico

| Exemplo | Resultado |
| --- | --- |
| `Left( 'abcdef', 3 )` | Retorna `abc` |

## Exemplo - Fundamentos de Left

[](https://help.qlik.com/en-US/sense/Subsystems/Hub/Content/Sense_Hub/Scripting/StringFunctions/Left.htm)

#### Expressão de gráfico

Visão geral

Abra o editor da carga de dados e adicione o script de carregamento abaixo em uma nova seção.

O script de carregamento contém:

* Um conjunto de dados que é carregado em uma tabela de dados denominada `Example`.

* Os campos a seguir na tabela de dados:

  * `InputText`

  * `NoOfChars`

Script de carregamento

```
Example:
Load * inline [
InputText, NoOfChars
'abcdef', 3
'2021-07-14', 4
'2021-07-14', 2
];
```

Resultados

Carregue os dados e abra uma pasta. Crie uma nova tabela e adicione esses campos como dimensões:

* ` InputText
                                   `

* `NoOfChars`

Crie a seguinte dimensão calculada:

* `=Left(InputText,NoOfChars)`

Tabela de resultados

| InputText | NoOfChars | Left(InputText,NoOfChars) |
| --- | --- | --- |
| abcdef | 3 | abc |
| 2021-07-14 | 2 | 20 |
| 2021-07-14 | 4 | 2021 |

A primeira linha retorna `abc`, pois esses são os 3 primeiros caracteres da esquerda da string `InputText`.

A segunda linha retorna `20`, pois esses são os 2 primeiros caracteres da esquerda da string `InputText`.

A terceira linha retorna `2021`, pois esses são os 4 primeiros caracteres da esquerda da string `InputText`.

[](https://help.qlik.com/en-US/sense/Subsystems/Hub/Content/Sense_Hub/Scripting/StringFunctions/Left.htm)

#### Script de carregamento

O código a seguir mostra como usar a função em um script de carregamento.

```
Example:
Load
*,
left(Text,NoOfChars) as Left;
Load * inline [
Text, NoOfChars
'abcdef', 3
'2021-07-14', 4
'2021-07-14', 2
];
```

Tabela de resultados

| Texto | NoOfChars | Esquerda |
| --- | --- | --- |
| abcdef | 3 | abc |
| 2021-07-14 | 4 | 2021 |
| 2021-07-14 | 2 | 20 |

## Exemplo - Cenário de Left

[](https://help.qlik.com/en-US/sense/Subsystems/Hub/Content/Sense_Hub/Scripting/StringFunctions/Left.htm)

#### Expressão de gráfico

Visão geral

Esse exemplo analisa os códigos de pedido em um conjunto de dados, que contém um código de região, ano e número de pedido, para criar um novo campo para análise de dados.

Abra o editor da carga de dados e adicione o script de carregamento abaixo em uma nova seção.

O script de carregamento contém:

* Um conjunto de dados que é carregado em uma tabela de dados denominada `Example`.

* Os campos a seguir na tabela de dados:

  * `OrderID`

  * `CustomerName`

  * `SalesAmount`

Script de carregamento

```
Example:
Load * inline [
OrderID, CustomerName, SalesAmount
US2024001, John Doe, 1500
EU2024002, Jane Smith, 2300
AS2024003, Mike Davis, 1800
];
```

Resultados

Carregue os dados e abra uma pasta. Crie uma nova tabela e adicione esses campos como dimensões:

* `OrderID`

* `CustomerName`

* `SalesAmount`

Crie a seguinte dimensão calculada:

* `=Left(OrderID, 2)` para calcular a região.

Tabela de resultados

| OrderID | CustomerName | SalesAmount | Left(OrderID, 2) |
| --- | --- | --- | --- |
| AS2024003 | Mike Davis | 1800 | AS |
| EU2024002 | Jane Smith | 2300 | Europa |
| US2024001 | John Doe | 1500 | US |

A saída da função `Left` analisa o OrderID para extrair a região, criando um novo campo para ser usado em outras análises de dados.

## Exemplo - Cenário avançado à esquerda

[](https://help.qlik.com/en-US/sense/Subsystems/Hub/Content/Sense_Hub/Scripting/StringFunctions/Left.htm)

#### Expressão de gráfico

Visão geral

Este exemplo analisa os códigos de produtos em um conjunto de dados, que contém um código de categoria de departamento e um identificador exclusivo, para criar um novo campo para análise de dados.

Abra o editor da carga de dados e adicione o script de carregamento abaixo em uma nova seção.

O script de carregamento contém:

* Um conjunto de dados que é carregado em uma tabela de dados denominada Example.

* Um campo na tabela de dados chamado ProductCode.

Script de carregamento

```
Example:
Load * inline [
ProductCode
ELC12345
HOM67890
FAS09876
];
```

Resultados

Carregue os dados e abra uma pasta. Crie uma nova tabela e adicione esse campo como uma dimensão:

* ProductCode

Crie a seguinte dimensão calculada:

* =Pick(Match(left(ProductCode,3),'ELC','HOM','FAS'),'Electronics','Home Appliances','Fashion') para calcular o departamento.

Tabela de resultados

| ProductCode | Pick(Match(left(ProductCode,3),'ELC','HOM','FAS'),'Electronics','Home Appliances','Fashion') |
| --- | --- |
| ELC12345 | Eletrônicos |
| FAS09876 | Moda |
| HOM67890 | Eletrodomésticos |

A saída usa as funções Pick, Match e Left para extrair o departamento do código do produto, criando um novo campo para análise de dados.

Consulte também [Index Função de script e de gráfico](https://help.qlik.com/pt-BR/sense/May2026/Subsystems/Hub/Content/Sense_Hub/Scripting/StringFunctions/Index.htm), que permite uma análise de string mais complexa.