# TIME

> Função TIME no StackQL: retornar uma hora como string HH:MM:SS a partir de um valor de tempo e de modificadores opcionais.

Source: https://stackql.io/pt-br/language-spec/functions/datetime/time

Retorna uma string de hora no formato HH:MM:SS.  

Veja também:  
[[` SELECT `]](/language-spec/select) [[ Modificadores de data ]](/language-spec/functions/datetime/date_modifiers) 

* * * 

## Sintaxe

```sql
SELECT TIME(datetime_expression [, modifier, ...]) FROM <multipartIdentifier>;
```

## Argumentos

__*datetime_expression*__  
O valor de data e hora.

__*modifier*__  
Zero ou mais modificadores a serem aplicados à *datetime_expression*.  Para obter mais informações sobre modificadores, consulte [**Modificadores de data**](/language-spec/functions/datetime/date_modifiers)

## Valor(es) retornado(s)

Retorna uma string que representa o componente de hora da *datetime_expression* de entrada com o *modifier* aplicado.

* * *

## Exemplos

### Retornar o componente de hora de um valor de data e hora

```sql
SELECT name, timeCreated,
time(timeCreated) as time_only
FROM google.storage.buckets WHERE project = 'stackql';
```

### Retornar o componente de hora local de um valor de data e hora

```sql
SELECT name, timeCreated,
time(timeCreated, 'localtime') as local_time
FROM google.storage.buckets WHERE project = 'stackql';
```

Para obter mais informações, consulte [https://www.sqlite.org/lang_datefunc.html](https://www.sqlite.org/lang_datefunc.html)
