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

Timestamp#() avalia uma expressão como um valor de tempo e data, no formato de carimbo de data e hora definido no script de carga de dados ou o sistema operacional, a não ser que uma string de formato seja fornecida.

Sintaxe:

timestamp#(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 omitida, serão utilizados formatos de data abreviada, formato de hora e separador decimal configurados no sistema operacional. A ISO 8601 é suportada para carimbos de data/hora.<br><br>A função `Timestamp#` aceita muitas opções de formato para diferentes estruturas de tempo, por exemplo:<br><br>`DD/MM/YYYY`: concentra-se apenas na data (por exemplo: `15/11/2024`).<br><br>​`YYYY-MM-DD hh:mm:ss`: ​exibe o carimbo de data/hora completo (por exemplo: `2024-11-15 13:30:45`).<br><br>`​MMM DD, YYYY`: ​exibe uma versão curta do mês e do ano completo (por exemplo: `Nov 15, 2024`).<br><br>​`hh:mm:ss TT`: ​mostra apenas a hora no formato de 12 horas (por exemplo: `01:30:45 PM`)<br><br>`​HH:mm:ss`: ​exibe a hora no formato de 24 horas (por exemplo: `13:30:45`)<br><br>`​wwww, MMM DD YYYY`: ​mostra o dia da semana e a data completos (por exemplo: `Friday, Nov 15 2024`)<br><br>`​YYYY-MM-DD hh:mm:ss.fff`: ​inclui milissegundos (por exemplo: `2024-11-15 13:30:45.123`​).<br><br>[Descrições para formatos de número e hora](https://help.qlik.com/pt-BR/cloud-services/Subsystems/Hub/Content/Sense_Hub/Introduction/conventions-number-time-formats.htm) |

Exemplo: expressões de gráfico

| Exemplo | Resultado |
| --- | --- |
| `Timestamp#('12-03-2023 10:25:30', 'DD-MM-YYYY hh:mm:ss')` | Retorna `12-03-2023 10:25:30` |
| `Timestamp#('2023/03/15 13:45', 'YYYY/MM/DD hh:mm')` | Retorna `2023/03/15 13:45` |

## Exemplo - Fundamentos de Timestamp\#

[](https://help.qlik.com/en-US/cloud-services/Subsystems/Hub/Content/Sense_Hub/Scripting/InterpretationFunctions/timestamp_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:

  * `InputString`

* Um carregamento anterior que usa a função `Timestamp#` para tratar a expressão como um valor de data e hora. Quando executado, ele cria um campo adicional chamado `TimeStamp_InputString`.

Script de carregamento

```
SET DateFormat='M/D/YYYY'
Example:
Load *,
Timestamp(Timestamp#(InputString)) as TimeStamp_InputString;
LOAD * INLINE [
InputString
2015-09-15T12:13:14
1952-10-16T13:14:00+0200
1109-03-01T14:15
];
```

Resultados

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

* ` InputString
                                       `

* `TimeStamp_InputString`

Tabela de resultados

| InputString | TimeStamp\_InputString |
| --- | --- |
| 1109-03-01T14:15 | 3/1/1109 2:15:00 PM |
| 1952-10-16T13:14:00+0200 | 10/16/1952 11:14:00 AM |
| 2015-09-15T12:13:14 | 9/15/2015 12:13:14 PM |

Neste exemplo, você pode ver como os valores de string podem ser avaliados como um carimbo de data/hora usando a função `Timestamp#`.

## Exemplo – Cenário de Timestamp\#

[](https://help.qlik.com/en-US/cloud-services/Subsystems/Hub/Content/Sense_Hub/Scripting/InterpretationFunctions/timestamp_hash.htm)

#### Script de carregamento

Visão geral

Os dados de um log de eventos contêm um formato de carimbo de data/hora que você deseja usar.

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:

  * `Event`
  * `EventDateTime`

* Um carregamento anterior que usa a função `Timestamp#` para converter os valores no campo `EventDateTime` em um formato de data e hora que o sistema pode entender. Quando executado, ele cria um campo adicional chamado `EventTimestamp`.

Script de carregamento

```
SET TimestampFormat='M/D/YYYY h:mm:ss[.fff] TT';
Example:
LOAD
Event,
EventDateTime,
Timestamp#(EventDateTime, 'DD-MM-YYYY hh:mm:ss') AS EventTimestamp
INLINE [
Event, EventDateTime
"Login", "12-03-2023 10:25:30"
"Logout", "12-03-2023 12:45:10"
"Login", "13-03-2023 09:10:15"
"Logout", "13-03-2023 17:30:20"
"Login", "14-03-2023 08:00:00"
];
```

Resultados

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

* ` Event
                                       `

* `EventDateTime`

* `EventTimestamp`

Crie a seguinte medida:

* `=Timestamp(EventTimestamp)` para visualizar o carimbo de data/hora formatado usando o formato fornecido no script de carregamento como configuração padrão.

Tabela de resultados

| Evento | EventDateTime | EventTimestamp | Timestamp(EventTimestamp) |
| --- | --- | --- | --- |
| Login | 12-03-2023 10:25:30 | 12-03-2023 10:25:30 | 3/12/2023 10:25:30 AM |
| Login | 13-03-2023 09:10:15 | 13-03-2023 09:10:15 | 3/13/2023 9:10:15 AM |
| Login | 14-03-2023 08:00:00 | 14-03-2023 08:00:00 | 3/14/2023 8:00:00 AM |
| Logout | 12-03-2023 12:45:10 | 12-03-2023 12:45:10 | 3/12/2023 12:45:10 PM |
| Logout | 13-03-2023 17:30:20 | 13-03-2023 17:30:20 | 3/13/2023 5:30:20 PM |

Neste exemplo, você pode ver como os valores podem ser convertidos usando a função `Timestamp#`.