# Time Função de script e de gráfico
Time() formata uma expressão como um valor de tempo, no formato de tempo 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:
Time(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 hora resultante será formatada. Se for omitido, serão usados o formato de hora e o separador decimal definidos no sistema operacional.
A função `Time` aceita muitas opções de formato para diferentes estruturas de tempo, por exemplo:
`hh:mm:ss` — formata um valor de tempo em um formato de hora padrão e exibe horas, minutos e segundos com zeros à esquerda.
`hh:mm TT` —usa um formato de 12 horas com o sufixo AM/PM.
`hh:mm` — mostra apenas horas e minutos, omitindo os segundos.
`hh.mm.ss`— formato de hora com separadores diferentes, como um ponto (`.`) em vez de dois pontos.
`hh TT` —inclui apenas hora e AM/PM.
`hh "Hrs" mm "Mins"`—exibe a hora com texto personalizado, como Hrs.
[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 |
| --- | --- |
| `Time( 0.375 )` | Retorna `09:00:00` quando a configuração de `TimeFormat` é `'hh:mm:ss'`. |
| `Time( 35648.375 )` | Retorna `09:00:00` quando o `Timeformat` fornecido é `'hh:mm:ss'`. |
| `Time( 0.99999, 'hh-mm' )` | Retorna `23-59` ignorando a configuração de `TimeFormat`, pois o formato é fornecido na medida. |
## Exemplo – Fundamentos de Time
[](https://help.qlik.com/en-US/sense/Subsystems/Hub/Content/Sense_Hub/Scripting/FormattingFunctions/Time.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:
* `TimeValue`
* A variável `TimeFormat`, que usa o formato `hh:mm:ss`.
Script de carregamento
```
SET TimeFormat='hh:mm:ss';
Example:
Load * inline [
TimeValue
0.375
35648.375
0.99999
];
```
Resultados
Carregue os dados e abra uma pasta. Crie uma nova tabela e adicione esse campo como uma dimensão:
* ` TimeValue
`
Crie as seguintes medidas:
* `=Time(TimeValue )` para visualizar o valor como uma hora formatada usando a configuração do sistema.
* `=Time(TimeValue, 'hh-mm' )` para visualizar o valor como uma hora no formato fornecido na função.
* `=Time(TimeValue, 'hh:mm:ss' )` para visualizar o valor como uma hora no formato fornecido na função.
* `=Time(TimeValue, 'hh:mm TT' )` para visualizar o valor como uma hora no formato fornecido na função.
* `=Time(TimeValue, 'hh:mm' )` para visualizar o valor como uma hora no formato fornecido na função.
* `=Time(TimeValue, 'hh.mm.ss' )` para visualizar o valor como uma hora no formato fornecido na função.
* `=Time(TimeValue, 'hh TT' )` para visualizar o valor como uma hora no formato fornecido na função.
* `=Time(TimeValue, 'hh "Hrs" mm "Mins"' )` para visualizar o valor como uma hora no formato fornecido na função.
Tabela de resultados
| TimeValue | Time(TimeValue) | Time(TimeValue, 'hh-mm') | Time(TimeValue, 'hh:mm:ss') | Time(TimeValue, 'hh:mm TT') | Time(TimeValue, 'hh:mm') | Time(TimeValue, 'hh.mm.ss') | Time(TimeValue, 'hh TT') | Time(TimeValue, 'hh "Hrs" mm "Mins"') |
| --- | --- | --- | --- | --- | --- | --- | --- | --- |
| 0.375 | 09:00:00 | 09-00 | 09:00:00 | 09:00 AM | 09:00 | 09.00.00 | 09 AM | 09 Hrs 00 Mins |
| 0.99999 | 23:59:59 | 23-59 | 23:59:59 | 11:59 PM | 23:59 | 23.59.59 | 11 PM | 23 Hrs 59 Mins |
| 35648.375 | 09:00:00 | 09-00 | 09:00:00 | 09:00 AM | 09:00 | 09.00.00 | 09 AM | 09 Hrs 00 Mins |
Os resultados mostram como a função `Time` pode exibir valores com base no formato fornecido na expressão da função.
## Exemplo – Fundamentos de tempo usando uma configuração de TimeFormat diferente
[](https://help.qlik.com/en-US/sense/Subsystems/Hub/Content/Sense_Hub/Scripting/FormattingFunctions/Time.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:
* `TimeValue`
* A variável `TimeFormat`, que usa o formato `hh.mm.ss`.
Script de carregamento
```
SET TimeFormat='hh.mm.ss';
Example:
Load * inline [
TimeValue
0.375
35648.375
0.99999
];
```
Resultados
Carregue os dados e abra uma pasta. Crie uma nova tabela e adicione esse campo como uma dimensão:
* ` TimeValue
`
Crie as seguintes medidas:
* `=Time(TimeValue )` para visualizar o valor como uma hora formatada usando a configuração do sistema.
* `=Time(TimeValue, 'hh-mm' )` para visualizar o valor como uma hora no formato fornecido na função.
* `=Time(TimeValue, 'hh:mm:ss' )` para visualizar o valor como uma hora no formato fornecido na função.
* `=Time(TimeValue, 'hh:mm TT' )` para visualizar o valor como uma hora no formato fornecido na função.
* `=Time(TimeValue, 'hh:mm' )` para visualizar o valor como uma hora no formato fornecido na função.
* `=Time(TimeValue, 'hh.mm.ss' )` para visualizar o valor como uma hora no formato fornecido na função.
* `=Time(TimeValue, 'hh TT' )` para visualizar o valor como uma hora no formato fornecido na função.
* `=Time(TimeValue, 'hh "Hrs" mm "Mins"' )` para visualizar o valor como uma hora no formato fornecido na função.
Tabela de resultados
| TimeValue | Time(TimeValue) | Time(TimeValue, 'hh-mm') | Time(TimeValue, 'hh:mm:ss') | Time(TimeValue, 'hh:mm TT') | Time(TimeValue, 'hh:mm') | Time(TimeValue, 'hh.mm.ss') | Time(TimeValue, 'hh TT') | Time(TimeValue, 'hh "Hrs" mm "Mins"') |
| --- | --- | --- | --- | --- | --- | --- | --- | --- |
| 0.375 | 09.00.00 | 09-00 | 09:00:00 | 09:00 AM | 09:00 | 09.00.00 | 09 AM | 09 Hrs 00 Mins |
| 0.99999 | 23.59.59 | 23-59 | 23:59:59 | 11:59 PM | 23:59 | 23.59.59 | 11 PM | 23 Hrs 59 Mins |
| 35648.375 | 09.00.00 | 09-00 | 09:00:00 | 09:00 AM | 09:00 | 09.00.00 | 09 AM | 09 Hrs 00 Mins |
Os resultados mostram como a função `Time` pode exibir valores com base no formato fornecido na expressão da função.