# hour - Função de script e de gráfico
Esta função retorna um número inteiro que representa a hora em que a fração da expression é interpretada como uma hora, de acordo com a interpretação numérica padrão.
Sintaxe:
hour(expression)
Tipo de dados de retorno: inteiro
## Configurações regionais
A menos que especificado de outra forma, os exemplos neste tópico usam o seguinte formato de data: MM/DD/AAAA. O formato de data é especificado na instrução `SET DateFormat` no seu script de carregamento de dados. A formatação de data padrão pode ser diferente no seu sistema devido às suas configurações regionais e outros fatores. Você pode alterar os formatos nos exemplos abaixo para atender às suas necessidades. Ou pode alterar os formatos no seu script de carregamento para corresponder a esses exemplos.
As configurações regionais padrão nos aplicativos são baseadas nas configurações regionais do sistema do computador ou servidor em que o Qlik Sense está instalado. Se o servidor Qlik Sense que você está acessando estiver definido como Suécia, o Editor de carregamento de dados usará as configurações regionais suecas para datas, horas e moedas. Essas configurações de formato regional não estão relacionadas ao idioma exibido na interface do usuário do Qlik Sense. O Qlik Sense será exibido no mesmo idioma do navegador que você está usando.
Exemplos de funções
| Exemplo | Resultado |
| --- | --- |
| `hour(
'09:14:36' )` | A string de texto fornecida é implicitamente convertida em um carimbo de data/hora, pois corresponde ao formato de carimbo de data/hora definido na variável TimestampFormat. A expressão retorna 9. |
| `hour(
'0.5555' )` | A expressão retorna 13 (porque 0,5555 = 13:19:55). |
## Exemplo 1 – Variável (script)
[](https://help.qlik.com/en-US/sense/Subsystems/Hub/Content/Sense_Hub/Scripting/DateAndTimeFunctions/hour.htm)
#### Script de carregamento e resultados
Visão geral
Abra o Editor de carregamento de dados e adicione o script de carregamento abaixo em uma nova guia.
O script de carregamento contém:
* Um conjunto de dados contendo transações por carimbo de data/hora.
* A variável de sistema `TimeStamp` padrão `(M/D/YYYY h:mm:ss[.fff] TT)`
Crie um campo, '`hour`', calculando quando as compras ocorreram.
Script de carregamento
```
SET TimestampFormat='M/D/YYYY h:mm:ss[.fff] TT';
Transactions:
Load
*,
hour(date) as hour
;
Load
*
Inline
[
id,date,amount
9497,'2022-01-05 19:04:57',47.25,
9498,'2022-01-03 14:21:53',51.75,
9499,'2022-01-03 05:40:49',73.53,
9500,'2022-01-04 18:49:38',15.35,
9501,'2022-01-01 22:10:22',31.43,
9502,'2022-01-05 19:34:46',13.24,
9503,'2022-01-04 22:58:34',74.34,
9504,'2022-01-06 11:29:38',50.00,
9505,'2022-01-02 08:35:54',36.34,
9506,'2022-01-06 08:49:09',74.23
];
```
Resultados
Carregue os dados e abra uma pasta. Crie uma nova tabela e adicione esses campos como dimensões:
* `date`
* `hour`
Tabela de resultados
| data | hora |
| --- | --- |
| 2022-01-01 22:10:22 | 22 |
| 2022-01-02 08:35:54 | 8 |
| 2022-01-03 05:40:49 | 5 |
| 2022-01-03 14:21:53 | 14 |
| 2022-01-04 18:49:38 | 18 |
| 2022-01-04 22:58:34 | 22 |
| 2022-01-05 19:04:57 | 19 |
| 2022-01-05 19:34:46 | 19 |
| 2022-01-06 08:49:09 | 8 |
| 2022-01-06 11:29:38 | 11 |
Os valores no campo de hora são criados usando a função `hour()` função e transferindo a data como a expressão no comando de carregamento anterior.
## Exemplo 2 – Objeto de gráfico (gráfico)
[](https://help.qlik.com/en-US/sense/Subsystems/Hub/Content/Sense_Hub/Scripting/DateAndTimeFunctions/hour.htm)
#### Script de carregamento e expressão de gráfico
Visão geral
Abra o Editor de carregamento de dados e adicione o script de carregamento abaixo em uma nova guia.
O script de carregamento contém:
* O mesmo conjunto de dados do primeiro exemplo.
* A variável de sistema `TimeStamp` padrão `(M/D/YYYY h:mm:ss[.fff] TT)`.
No entanto, neste exemplo, o conjunto de dados inalterado é carregado no aplicativo. Os valores de '`hour`' são calculados por meio de uma medida em um objeto de gráfico.
Script de carregamento
```
SET TimestampFormat='M/D/YYYY h:mm:ss[.fff] TT';
Transactions:
Load
*
Inline
[
id,date,amount
9497,'2022-01-05 19:04:57',47.25,
9498,'2022-01-03 14:21:53',51.75,
9499,'2022-01-03 05:40:49',73.53,
9500,'2022-01-04 18:49:38',15.35,
9501,'2022-01-01 22:10:22',31.43,
9502,'2022-01-05 19:34:46',13.24,
9503,'2022-01-04 22:58:34',74.34,
9504,'2022-01-06 11:29:38',50.00,
9505,'2022-01-02 08:35:54',36.34,
9506,'2022-01-06 08:49:09',74.23
];
```
Resultados
Carregue os dados e abra uma pasta. Crie uma nova tabela e adicione esse campo como uma dimensão: `date`.
Para calcular "`hour`", crie a seguinte medida:
`=hour(date)`
Tabela de resultados
| due\_date | =hour(date) |
| --- | --- |
| 2022-01-01 22:10:22 | 22 |
| 2022-01-02 08:35:54 | 8 |
| 2022-01-03 05:40:49 | 5 |
| 2022-01-03 14:21:53 | 14 |
| 2022-01-04 18:49:38 | 18 |
| 2022-01-04 22:58:34 | 22 |
| 2022-01-05 19:04:57 | 19 |
| 2022-01-05 19:34:46 | 19 |
| 2022-01-06 08:49:09 | 8 |
| 2022-01-06 11:29:38 | 11 |
Os valores para "`hour`" são criados usando a função `hour()` e transmitindo a data como a expressão em uma medida para o objeto de gráfico.