Função 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".

Sintaxe

STOT(hora_em_série)

Parâmetros

Nome Tipo Descrição
hora_em_série

numérico

O campo, expressão ou valor literal a ser convertido.

hora_serial pode ser uma hora serial ou uma datahora serial. Somente a parte da hora de uma datahora em série é considerada. A parte referente à data é ignorada.

Saída

Datahora. O valor de hora nos resultados é mostrado usando o formato de exibição de hora atual do Analytics.

Exemplos

Exemplos básicos

Retorna `t060000` exibido como 06:00:00 AM presumindo um formato de exibição atual da hora do Analytics de hh:mm:ss PM:

STOT(0,25000)

Retorna `t191530` exibido como 07:15:30 PM presumindo um formato de exibição atual da hora do Analytics de hh:mm:ss PM:

STOT(0,802431)

Retorna a hora normal equivalente para cada valor de hora serial no campo Hora_login:

STOT(Hora_login)

Observações

Quando usar STOT( )

Use a função STOT( ) para converter horas seriais em horas regulares.

O que são horas seriais?

As horas seriais do Analytics representam uma fração de 24 horas, sendo 24 horas igual a 1.

Por exemplo:

  • a hora serial equivalente a uma hora é 1/24, ou 0,04167
  • a hora serial equivalente a um minuto é 1/1440, ou 0,0006945

As horas seriais podem ser precedidas de '0' (zero) e uma vírgula decimal ou somente uma vírgula decimal.

1,000000 não é uma hora serial válida

Apesar das 24 horas serem iguais a 1 para fins de cálculo de horas em série, 1,000000 não é uma hora em série válida. Horas seriais válidas são todas as frações decimais menores que 1. Por exemplo: 0,75000 (06:00:00 PM).

O Analytics trata o número em série 1,000000 como uma datahora serial equivalente a 02 Jan 1900 12:00:00 AM. Pelo fato de STOT( ) ignorar a parte da data de uma datahora, STOT(1,000000) é equivalente a STOT(0,000000) e ambos são equivalentes a hora normal 12:00:00 AM.

Equivalências entre horas seriais e horas normais

Hora em série

Equivalente em hora normal

0,00

12:00:00 AM

0,0006945

12:01:00 AM

0,04167

01:00:00 AM

0,0423645

01:01:00 AM

0,042998

01:01:55 AM

0,25

06:00:00 AM

0,50

12:00:00 PM

0,75

06:00:00 PM

0,79167

07:00:00 PM

0,802431

07:15:30 PM

1,00

12:00:00 AM

Outras funções de conversão datahora

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".

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 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.

TIME( )

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.

Guia de scripting do ACL 14.1