Extrai a hora a partir de uma hora ou datahora específica e retorna como sequência de caracteres. Também pode retornar a hora atual do sistema operacional.

TIME(<hora/datahora> <;formato>)
Nome Tipo Descrição
hora/datahora

opcional

datahora

O campo, expressão ou valor literal do qual será extraída a hora. Se for omitido, a hora atual do sistema operacional é retornada no formato hh:mm:ss.
formato

opcional

 caractere

O formato a ser aplicado à cadeia de saída, por exemplo "hh:mm:ss". Se omitido, o formato atual de exibição da hora do Analytics é utilizado. Você não pode especificar formato se tiver omitido data/datahora.

Caractere.

Exemplos básicos

Valores de entrada literal

Retorna "23:59:59", supondo um formato de exibição de hora do Analytics de hh:mm:ss:

TIME(`20141231 235959`)

Retorna "11:59 P":

TIME(`20141231 235959`; "hh:mm A")

A hora atual do sistema operacional retornada como uma cadeia de caracteres no formato hh:mm:ss (24 horas):

TIME()

Campo como valores de entrada

Retorna uma cadeia de caracteres para cada valor no campo Carimbo_de_data_e_hora_do_recebimento, usando o formato atual de exibição de hora do Analytics:

TIME(Carimbo_de_data_e_hora_do_recebimento)

Retorna uma cadeia de caracteres para cada valor no campo Carimbo_de_data_e_hora_do_recebimento, usando o formato específico de exibição de hora:

TIME(Carimbo_datahora_recebimento;  "hh:mm:ss")

Exemplos avançados

Cálculo do tempo decorrido para execução de um comando ou script

Use a função TIME( ) para ajudar a calcular quanto tempo um determinado comando ou script completo do Analytics demora a executar.

Imediatamente antes do comando que você deseja cronometrar, ou no início do script, especifique essa linha para criar uma variável que armazena a hora atual do sistema operacional:

ASSIGN Hora_início = TIME()

Imediatamente após o comando, ou ao final do script, especifique as duas linhas abaixo.

A primeira linha cria uma variável que armazena a hora do sistema operacional após a conclusão do comando ou do script. A segunda linha calcula a diferença entre as horas de início e fim e converte o resultado em um formato de fácil leitura.

Dica

Você pode clicar duas vezes na entrada do log CALCULATE para ver o tempo decorrido para o comando ou script.

ASSIGN Hora_fim = TIME()
CALCULATE STOT(CTOT(Hora_fim) - CTOT(Hora_início))

Se o comando ou script executará além da meia-noite, use esta linha em vez da anterior:

CALCULATE `T000000` - (CTOT(Hora_início) - CTOT(Hora_fim))

Às vezes, pode ser um desafio usar corretamente as data e hora. Na Ajuda, os tópicos de função descrevem os detalhes específicos do funcionamento de cada função. Para obter informações sobre algumas considerações gerais ao usar as funções de data e hora, consulte os seguintes tópicos:

Comprimento da cadeia de saída

O comprimento da cadeia de saída é sempre 14 caracteres. Se o formato de saída especificado ou o formato de exibição de data do Analytics for menos do que 14 caracteres, a cadeia de saída será preenchida com espaços em branco à direita.

Detalhes do parâmetro

Um campo especificado para hora/datahora pode usar qualquer formato de data ou datahora, desde que a definição do campo defina corretamente o formato.

Se você usa formato para controlar como a cadeia de saída é exibida, fica restrito aos formatos na tabela abaixo. Você pode usar qualquer combinação de formatos de data e AM/PM. O formato AM/PM é opcional e é posicionado ao final.

Especifique formato usando apóstrofos ou aspas. Por exemplo: "hh:mm:ss AM".

Formatos de hora

Formatos AM/PM

Exemplos

hh:mm:ss

nenhum

Relógio de 24 horas

"hh:mm:ss"

hhmmss

AM ou PM

Relógio de 12 horas

"hhmmss PM"

hh:mm

A ou P

Relógio de 12 horas

"hh:mm A"

hhmm

 

  

hh

 

 

Especificação de uma hora literal ou de um valor datahora

Ao especificar um valor literal de hora ou datahora para hora/datahora, você fica restrito aos formatos na tabela abaixo e o valor deve estar entre apóstrofos invertidos – por exemplo, `20141231 235959`.

Não use separadores como barras (/) ou dois pontos (:) entre os componentes individuais de datas ou horas.

  • Valores de hora – você pode usar qualquer dos formatos de hora listados na tabela abaixo. Você deve usar um separador antes de um valor de hora independente para que a função funcione corretamente. Os separadores válidos são as letras 't' ou 'T'. As horas devem ser especificadas usando o relógio de 24 horas. Os ajustes do Tempo Universal Coordenado (UTC) devem ser precedidos por um sinal de mais (+) ou de menos (-).

  • Valores de datahora – você pode usar qualquer combinação de formatos de data, separador e hora listados na tabela abaixo. A data deve preceder a hora e um separador deve ser usado entre os dois. Os separadores válidos são um único espaço em branco ou as letras 't' ou 'T'.

    Exemplos de formato

    Exemplos de valores literais

    thhmmss

    `t235959`

    Thhmm

    `T2359`

    AAAAMMDD hhmmss

    `20141231 235959`

    AAMMDDthhmm

    `141231t2359`

    AAAAMMDDThh

    `20141231T23`

    AAAAMMDD hhmmss+/-hhmm

    (ajuste UTC)

    `20141231 235959-0500`

    AAMMDD hhmm+/-hh

    (ajuste UTC)

    `141231 2359+01`

    Nota

    Não use somente hh no formato de hora principal com dados que têm um ajuste UTC. Por exemplo, evite: hh+hhmm. Os resultados podem ser não confiáveis.

     

Funções relacionadas

Se você precisar retornar a hora atual do sistema operacional como um valor datahora, use NOW( ) em vez de TIME( ).

Conversão de datahora para caractere

Função Descrição

DATE( )

Extrai a data a partir de uma data ou datahora específica e retorna como sequência de caracteres. Também pode retornar a data atual do sistema operacional.

DATETIME( )

Converte uma datahora em uma sequência de caracteres. Também pode retornar a datahora atual do sistema operacional.

Conversão de caractere ou numérico para datahora

Função Descrição

CTOD( )

Converte um valor em caractere ou numérico de data em uma data. Também é possível extrair a data de um valor de datahora em formato de caracteres ou numérico e retorná-lo como uma data. Abreviação de "Caractere para Data".

CTODT( )

Converte um valor em caractere ou numérico de datahora em uma datahora. Abreviação de "Caractere para Datahora".

CTOT( )

Converte um valor em caractere ou numérico de hora em uma hora. Também é possível extrair a hora de um valor de datahora em formato de caracteres ou numérico e retorná-lo como uma hora. Abreviação de "Caractere para Hora".

Conversão de serial para datahora

Função Descrição

STOD( )

Converte uma data serial, ou seja, uma data expressa como um inteiro, em um valor de data. É abreviação de "Serial to Date".

STODT( )

Converte uma datahora serial, ou seja, uma datahora expressa como um inteiro e uma fração de 24 horas, em um valor de datahora. É abreviação de "Serial to Datetime".

STOT( )

Converte uma hora em série, ou seja, uma hora expressa como uma fração de 24 horas, sendo 24 horas representando 1, para um valor de hora. Abreviação de "Série para hora".