# Time# - Função de script e de gráfico
Time#() avalia uma expressão como um valor de tempo, no formato de tempo definido no script de carga de dados ou sistema operacional, a não ser que uma string de formato seja fornecida.
Sintaxe:
time#(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ã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/November2025/Subsystems/Hub/Content/Sense_Hub/Introduction/conventions-number-time-formats.htm) |
Exemplo: expressões de gráfico
| Exemplo | Resultado |
| --- | --- |
| `Time#('09:00:00')` | Retorna `09:00:00` quando a configuração de `TimeFormat` é `'hh:mm:ss'`. |
| `Time#( '09:00:00','hh:mm:ss' )` | Retorna `09:00:00` quando o formato fornecido é `'hh:mm:ss'`. |
| `Time#('03:25 PM', 'hh:mm TT')` | Retorna `03:25 PM` quando o formato fornecido é `'hh:mm TT'`. |
## Exemplo – Fundamentos de Time\#
[](https://help.qlik.com/en-US/sense/Subsystems/Hub/Content/Sense_Hub/Scripting/InterpretationFunctions/time_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:
* `InputTime`
* A variável `TimeFormat`, que usa o formato `h:mm:ss TT`.
* Um carregamento anterior que usa a função `Time#` para converter o valor de texto de `InputTime` em um campo de tempo/numérico chamado `ParsedTime` que o sistema pode usar.
Script de carregamento
```
SET TimeFormat='h:mm:ss TT';
Example:
Load
InputTime,
Time#(InputTime, 'hh-mm-ss') as ParsedTime
Inline [
InputTime
12-30-45
05-15-00
22-10-55
08-20-35
19-45-15
];
```
Resultados
Carregue os dados e abra uma pasta. Crie uma nova tabela e adicione esses campos como dimensões:
* ` InputTime
`
* `ParsedTime`
Crie a seguinte medida:
* `=Time(ParsedTime)` para visualizar a hora usando o formato fornecido no script de carregamento como configuração padrão.
Tabela de resultados
| InputTime | ParsedTime | Time(ParsedTime) |
| --- | --- | --- |
| 05-15-00 | 05-15-00 | 5:15:00 AM |
| 08-20-35 | 08-20-35 | 8:20:35 AM |
| 12-30-45 | 12-30-45 | 12:30:45 PM |
| 19-45-15 | 19-45-15 | 7:45:15 PM |
| 22-10-55 | 22-10-55 | 10:10:55 PM |
Os valores no campo `InputTime` são exibidos como texto e alinhados à esquerda. Depois que os valores em `InputTime` são analisados pela função `Time#`, o campo `ParsedTime` resultante é criado. Os valores no novo campo são alinhados à direita, pois agora são tratados como um valor de hora válido. A terceira coluna usa a função `Time` para avaliar os valores de `ParsedTime` e formatá-los de acordo com o `TimeFormat` no script de carregamento.
## Exemplo – Cenário de Time\#
[](https://help.qlik.com/en-US/sense/Subsystems/Hub/Content/Sense_Hub/Scripting/InterpretationFunctions/time_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:
* `NoDelimiterTime`
* A variável `TimeFormat`, que usa o formato `hh.mm.ss`.
* Um carregamento precedente que usa a função `Time#` para converter o valor de texto de `NoDelimiterTime` em um campo de tempo/numérico chamado `ParsedNoDelimiterTime`.
Script de carregamento
```
SET TimeFormat='hh.mm.ss';
Example:
Load
NoDelimiterTime,
Time#(NoDelimiterTime, 'hhmmss') as ParsedNoDelimiterTime
Inline [
NoDelimiterTime
143015
091045
235959
060530
184010
];
```
Resultados
Carregue os dados e abra uma pasta. Crie uma nova tabela e adicione esse campo como uma dimensão:
* ` NoDelimiterTime
`
Crie a seguinte medida:
* `=Time(ParsedNoDelimiterTime,'hh:mm:ss')` para visualizar a hora usando o formato fornecido no script de carregamento como configuração padrão.
Tabela de resultados
| NoDelimiterTime | Time(ParsedNoDelimiterTime,'hh:mm:ss') |
| --- | --- |
| 060530 | 06:05:30 |
| 091045 | 09:10:45 |
| 143015 | 14:30:15 |
| 184010 | 18:40:10 |
| 235959 | 23:59:59 |
Os resultados mostram como você pode usar a função `Time#` para analisar e converter valores de texto em um valor de hora/numérico.