# Timestamp - Função de script e de gráfico
TimeStamp() formata uma expressão como um valor de data e hora, no formato de carimbo de data e hora definido nas variáveis de sistema no script de carga de dados ou no sistema operacional, a não ser que uma string de formato seja fornecida.
Sintaxe:
Timestamp(number[, format])
Tipo de dados de retorno: dual
Argumentos
| Argumento | Descrição |
| --- | --- |
| number | O número a ser formatado. |
| format | String descrevendo como a string de carimbo de data/hora resultante será formatada. Se omitida, serão utilizados formatos de data abreviada, formato de hora e separador decimal configurados no sistema operacional.
A função `Timestamp` aceita muitas opções de formato para diferentes estruturas de tempo, por exemplo:
`DD/MM/YYYY`: concentra-se apenas na data (por exemplo: `15/11/2024`).
`YYYY-MM-DD hh:mm:ss`: exibe o carimbo de data/hora completo (por exemplo: `2024-11-15 13:30:45`).
`MMM DD, YYYY`: exibe uma versão curta do mês e do ano completo (por exemplo: `Nov 15, 2024`).
`hh:mm:ss TT`: mostra apenas a hora no formato de 12 horas (por exemplo: `01:30:45 PM`)
`HH:mm:ss`: exibe a hora no formato de 24 horas (por exemplo: `13:30:45`)
`wwww, MMM DD YYYY`: mostra o dia da semana e a data completos (por exemplo: `Friday, Nov 15 2024`)
`YYYY-MM-DD hh:mm:ss.fff`: inclui milissegundos (por exemplo: `2024-11-15 13:30:45.123`).
[Descrições para formatos de número e hora](https://help.qlik.com/pt-BR/sense/November2025/Subsystems/Hub/Content/Sense_Hub/Introduction/conventions-number-time-formats.htm) |
Exemplo: expressões de gráfico
| Exemplo | Resultado |
| --- | --- |
| `Timestamp( 35648 )` | Retorna `97-08-06 00:00:00` quando o `TimestampFormat` é `YY-MM-DD hh:mm:ss`. |
| `Timestamp(35648,'YYYY-MM-DD hh.mm')` | Retorna `1997-08-06 00.00` quando o formato fornecido é `YYYY-MM-DD hh.mm`. |
| `Timestamp( 35648,'M/D/YYYY h:mm:ss[.fff] TT')` | Retorna `8/6/1997 12:00:00 AM` quando o formato fornecido é `M/D/YYYY h:mm:ss[.fff] TT`. |
| `Timestamp( 35648,'www, DD MMM YYYY hh:mm TT')` | Retorna `Wed, 06 Aug 1997 12:00 AM` quando o formato fornecido é `www, DD MMM YYYY hh:mm TT`. |
## Exemplo – Fundamentos de Timestamp
[](https://help.qlik.com/en-US/sense/Subsystems/Hub/Content/Sense_Hub/Scripting/FormattingFunctions/Timestamp.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`.
* O seguinte campo em uma tabela de dados:
* `TimeStampValue`
* A variável `TimestampFormat`, que usa o formato `YY-MM-DD hh:mm:ss`.
Script de carregamento
```
SET TimestampFormat='YY-MM-DD hh:mm:ss';
Example:
Load * inline [
TimeStampValue
35648.375
35648
36648.875
36648.8756789
];
```
Resultados
Carregue os dados e abra uma pasta. Crie uma nova tabela e adicione esse campo como uma dimensão:
* `TimeStampValue`
Crie as seguintes medidas:
* `=Timestamp(TimeStampValue)` para visualizar o valor como um formato de carimbo de data/hora usando a configuração do sistema.
* `=Timestamp(TimeStampValue,'YYYY-MM-DD hh.mm')` para visualizar o valor como um formato de carimbo de data/hora usando o formato fornecido na função.
* `=Timestamp(TimeStampValue,'M/D/YYYY h:mm:ss[.fff] TT')` para visualizar o valor como um formato de carimbo de data/hora usando o formato fornecido na função.
* `=Timestamp(TimeStampValue,'YYYY-MM-DD hh:mm:ss.fff')` para visualizar o valor como um formato de carimbo de data/hora usando o formato fornecido na função.
* `=Timestamp(TimeStampValue,'www, DD MMM YYYY hh:mm TT')` para visualizar o valor como um formato de carimbo de data/hora usando o formato fornecido na função.
* `=Timestamp(TimeStampValue,'wwww, MMM DD YYYY')` para visualizar o valor como um formato de carimbo de data/hora usando o formato fornecido na função.
Tabela de resultados
| TimeStampValue | Timestamp(TimeStampValue) | Timestamp(TimeStampValue,'YYYY-MM-DD hh.mm' | Timestamp(TimeStampValue,'M/D/YYYY h:mm:ss[.fff] TT') | Timestamp(TimeStampValue,'YYYY-MM-DD hh:mm:ss.fff') | Timestamp(TimeStampValue,'www, DD MMM YYYY hh:mm TT') | Timestamp(TimeStampValue,'wwww, MMM DD YYYY') |
| --- | --- | --- | --- | --- | --- | --- |
| 35648 | 97-08-06 00:00:00 | 1997-08-06 00.00 | 8/6/1997 12:00:00 AM | 1997-08-06 00:00:00.000 | Wed, 06 Aug 1997 12:00 AM | Wednesday, Aug 06 1997 |
| 35648.375 | 97-08-06 09:00:00 | 1997-08-06 09.00 | 8/6/1997 9:00:00 AM | 1997-08-06 09:00:00.000 | Wed, 06 Aug 1997 09:00 AM | Wednesday, Aug 06 1997 |
| 36648.875 | 00-05-02 21:00:00 | 2000-05-02 21.00 | 5/2/2000 9:00:00 PM | 2000-05-02 21:00:00.000 | Tue, 02 May 2000 09:00 PM | Tuesday, May 02 2000 |
| 36648.8756789 | 00-05-02 21:00:58 | 2000-05-02 21.00 | 5/2/2000 9:00:58 PM | 2000-05-02 21:00:58.657 | Tue, 02 May 2000 09:00 PM | Tuesday, May 02 2000 |
Os resultados mostram como a função `TimestampFormat` pode exibir valores usando diferentes parâmetros de formato.
## Exemplo – Fundamentos de Timestamp usando uma configuração de TimestampFormat diferente
[](https://help.qlik.com/en-US/sense/Subsystems/Hub/Content/Sense_Hub/Scripting/FormattingFunctions/Timestamp.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`.
* O seguinte campo em uma tabela de dados:
* `TimeStampValue`
* A variável `TimestampFormat`, que usa o formato `YY-MM-DD hh:mm:ss`.
Script de carregamento
```
SET TimestampFormat='M/D/YY hh:mm:ss';
Example:
Load * inline [
TimeStampValue
35648.375
35648
36648.875
36648.8756789
];
```
Resultados
Carregue os dados e abra uma pasta. Crie uma nova tabela e adicione esse campo como uma dimensão:
* `TimeStampValue`
Crie as seguintes medidas:
* `=Timestamp(TimeStampValue)` para visualizar o valor como um formato de carimbo de data/hora usando a configuração do sistema.
* `=Timestamp(TimeStampValue,'YYYY-MM-DD hh.mm')` para visualizar o valor como um formato de carimbo de data/hora usando o formato fornecido na função.
* `=Timestamp(TimeStampValue,'M/D/YYYY h:mm:ss[.fff] TT')` para visualizar o valor como um formato de carimbo de data/hora usando o formato fornecido na função.
* `=Timestamp(TimeStampValue,'YYYY-MM-DD hh:mm:ss.fff')` para visualizar o valor como um formato de carimbo de data/hora usando o formato fornecido na função.
* `=Timestamp(TimeStampValue,'www, DD MMM YYYY hh:mm TT')` para visualizar o valor como um formato de carimbo de data/hora usando o formato fornecido na função.
* `=Timestamp(TimeStampValue,'wwww, MMM DD YYYY')` para visualizar o valor como um formato de carimbo de data/hora usando o formato fornecido na função.
Tabela de resultados
| TimeStampValue | Timestamp(TimeStampValue) | Timestamp(TimeStampValue,'YYYY-MM-DD hh.mm' | Timestamp(TimeStampValue,'M/D/YYYY h:mm:ss[.fff] TT') | Timestamp(TimeStampValue,'YYYY-MM-DD hh:mm:ss.fff') | Timestamp(TimeStampValue,'www, DD MMM YYYY hh:mm TT') | Timestamp(TimeStampValue,'wwww, MMM DD YYYY') |
| --- | --- | --- | --- | --- | --- | --- |
| 35648 | 8/6/97 00:00:00 | 1997-08-06 00.00 | 8/6/1997 12:00:00 AM | 1997-08-06 00:00:00.000 | Wed, 06 Aug 1997 12:00 AM | Wednesday, Aug 06 1997 |
| 35648.375 | 8/6/97 09:00:00 | 1997-08-06 09.00 | 8/6/1997 9:00:00 AM | 1997-08-06 09:00:00.000 | Wed, 06 Aug 1997 09:00 AM | Wednesday, Aug 06 1997 |
| 36648.875 | 5/2/00 21:00:00 | 2000-05-02 21.00 | 5/2/2000 9:00:00 PM | 2000-05-02 21:00:00.000 | Tue, 02 May 2000 09:00 PM | Tuesday, May 02 2000 |
| 36648.8756789 | 5/2/00 21:00:58 | 2000-05-02 21.00 | 5/2/2000 9:00:58 PM | 2000-05-02 21:00:58.657 | Tue, 02 May 2000 09:00 PM | Tuesday, May 02 2000 |
Os resultados mostram como a função `TimestampFormat` pode exibir valores usando diferentes parâmetros de formato.
## Exemplo – alterando o formato do carimbo de data/hora dos pedidos dos clientes
[](https://help.qlik.com/en-US/sense/Subsystems/Hub/Content/Sense_Hub/Scripting/FormattingFunctions/Timestamp.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:
* `Customer`
* `CustomerName`
* `OrderTimestamp`
Script de carregamento
```
Example:
Load * inline [
OrderID, CustomerName, OrderTimestamp
1, Alice, 2024-02-20 11:00:00
2, Bob, 2024-03-01 15:30:00
3, Charlie, 2024-04-12 09:45:00
4, David, 2024-05-21 21:10:00
5, Eve, 2024-06-30 14:25:00
];
```
Resultados
Carregue os dados e abra uma pasta. Crie uma nova tabela e adicione esses campos como dimensões:
* `OrderID`
* `CustomerName`
Crie a seguinte medida:
* `=Timestamp(OrderTimestamp, 'WWWW, DD MMM YYYY hh:mm TT')` para exibir o carimbo de data/hora da ordem em um formato que mostre o dia da semana, a data e a hora.
Tabela de resultados
| OrderID | CustomerName | Timestamp(OrderTimestamp, 'WWWW, DD MMM YYYY hh:mm TT') |
| --- | --- | --- |
| 1 | Alice | Tuesday, 20 Feb 2024 11:00 AM |
| 2 | Bob | Friday, 01 Mar 2024 03:30 PM |
| 3 | Charlie | Friday, 12 Apr 2024 09:45 AM |
| 4 | David | Tuesday, 21 May 2024 09:10 PM |
| 5 | Eva | Sunday, 30 Jun 2024 02:25 PM |
Usando a função `Timestamp`, os dados do carimbo de data/hora agora são formatados para incluir o dia da semana e o novo formato para a data e hora.