# Date#Função de script e de gráfico
Date# avalia uma expressão como uma data no formato especificado no segundo argumento, se fornecida.
Sintaxe:
Date#(text[, format])
Tipo de dados de retorno: dual
Argumentos
| Argumento | Descrição |
| --- | --- |
| text | A string de texto a ser avaliada. |
| format | String que descreve o formato que deve ser usado para interpretar a string de texto. Se for omitido, será usado o formato de data definido nas variáveis do sistema no script de carregamento de dados ou no sistema operacional.
A função `Date#` oferece suporte a muitas opções de formato para diferentes estruturas de data, por exemplo:
`DD/MM/YYYY`: Dia/Mês/Ano (por exemplo, 15/02/2022)
`MM-DD-YYYY`: Mês-Dia-Ano com hifens (por exemplo, 02-15-2022)
`YYYY-MM-DD`: Ano-Mês-Dia, formato ISO (por exemplo, 2022-02-15)
`D-MMM-YYYY`: Dia, nome abreviado do mês, ano, com hifens (por exemplo, 15-Feb-2022)
`MMMM YYYY`: Nome longo do mês e ano (por exemplo, February 2022)
`MM/YYYY`: Mês e ano (por exemplo, 02/2022)
`DD MMMM YYYY`: Dia, Nome longo do mês e ano (por exemplo, 15 February 2022)
[Descrições para formatos de número e hora](https://help.qlik.com/pt-BR/sense/May2026/Subsystems/Hub/Content/Sense_Hub/Introduction/conventions-number-time-formats.htm) |
Exemplo: expressões de gráfico
| Exemplo | Resultado |
| --- | --- |
| ` Date#('8/7/97') ` | Retorna uma data válida de `8/7/97` quando a configuração de `DateFormat` é `M/D/YY.` |
| `Date#('21.10.2023', 'DD.MM.YYYY' )` | Retorna uma data válida de `21.10.2023` quando a configuração de data é `DD.MM.YYYY`. |
| `Date#('21.10.2023')` | Retorna `NULL` quando a configuração de `DateFormat` é `M/D/YY`. |
## Exemplo – Fundamentos de Date\#
[](https://help.qlik.com/en-US/sense/Subsystems/Hub/Content/Sense_Hub/Scripting/InterpretationFunctions/date_hash.htm)
#### Script de carregamento
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`.
* O seguinte campo em uma tabela de dados:
* `StringDate`
* A variável `DateFormat`, que usa o formato `M/D/YY`.
* Um carregamento anterior que cria um novo campo chamado `Date`. As funções `Date#` e `Num` são usadas para converter a string em uma data e, em seguida, retornar o valor como um número.
Script de carregamento
```
SET DateFormat='M/D/YY';
Example:
Load *,
Num(Date#(StringDate, 'D/M/YYYY')) as Date
;
LOAD * INLINE [
StringDate
13/12/2024
31/1/23
];
```
Resultados
Carregue os dados e abra uma pasta. Crie uma nova tabela e adicione esses campos como dimensões:
* ` StringDate
`
* `Date`
Crie as seguintes medidas:
* `=Date(Date)` para visualizar o valor como uma data formatada usando a variável de formato de data no script de carregamento.
* `=IsNum(StringDate)` para verificar se o valor é uma string e não é avaliado como uma data, pois o formato de data dos valores de campo não corresponde à configuração do sistema.
Results table
| StringDate | Date | Date(Date) | IsNum(StringDate) |
| --- | --- | --- | --- |
| 13/12/2024 | 45639 | 12/13/24 | 0 |
| 31/1/23 | 44957 | 1/31/23 | 0 |
Os resultados mostram que o campo `Date` na coluna 2, criado pelo carregamento anterior, converteu os valores de `StringDate` em uma data expressa como um número. A função de formato de `Date` na coluna 3 reconhece os valores de `Date` como datas e os formata de acordo com a variável `DateFormat` no script de carregamento.
## Exemplo – Cenário de Date\#
[](https://help.qlik.com/en-US/sense/Subsystems/Hub/Content/Sense_Hub/Scripting/InterpretationFunctions/date_hash.htm)
#### Script de carregamento
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:
* `Customer`
* `BirthDate`
* Um carregamento anterior que cria um novo campo chamado `ParsedBirthDate`.
Script de carregamento
```
Example:
Load *,
Date#(BirthDate, 'MM.DD.YYYY') as ParsedBirthDate;
Load * inline [
Customer, BirthDate
Customer A, 08.25.2022
Customer B, 08.25.2022
Customer C, 08.25.2022
];
```
Resultados
Carregue os dados e abra uma pasta. Crie uma nova tabela e adicione esses campos como dimensões:
* ` Customer
`
* `BirthDate`
* `ParsedBirthDate`
Crie a seguinte medida:
* `=Date(ParsedBirthDate,'DD/MM/YYYY')` para visualizar o valor como uma data formatada.
Results table
| Customer | BirthDate | ParsedBirthDate | Date(ParsedBirthDate, 'DD/MM/YYYY') |
| --- | --- | --- | --- |
| Customer A | 08.25.2022 | 08.25.2022 | 25/08/2022 |
| Customer B | 06.29.2022 | 06.29.2022 | 29/06/2022 |
| Customer C | 05.31.2022 | 05.31.2022 | 31/05/2022 |
Neste exemplo, podemos ver que, na coluna 2, o campo `BirthDate` é tratado como texto pelo sistema. A função `Date#` usada no carregamento anterior converte `BirthDate` em uma data reconhecível na coluna 3 `ParsedBirthDate`. A função de formato `Date` na coluna 4 pode exibir os valores `ParsedBirthDate` no formato `DD/MM/YYYY`.