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

Sintaxe

STODT(datahora_serial <;data_inicial>)

Parâmetros

Nome	Tipo	Descrição
datahora_serial	numérico	O campo, expressão ou valor literal a ser convertido. São necessários valores de datahora seriais com as partes de data e hora separadas por ponto decimal. Por exemplo: 42003,75000
data_inicial opcional	datahora	A data inicial usada para cálculo de datas seriais. Se for omitido, a data inicial padrão de 1º de janeiro de 1900 é aplicada.

Nome

Tipo

Descrição

datahora_serial

numérico

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

São necessários valores de datahora seriais com as partes de data e hora separadas por ponto decimal. Por exemplo: 42003,75000

data_inicial

opcional

datahora

A data inicial usada para cálculo de datas seriais. Se for omitido, a data inicial padrão de 1º de janeiro de 1900 é aplicada.

Saída

Datahora. O valor de datahora nos resultados é mostrado usando os formatos atuais de exibição de data e hora do Analytics.

Exemplos

Exemplos básicos

Datas iniciais não ajustadas

Retorna `20141231t060000` exibido como 31 Dez 2014 06:00:00 AM presumindo formatos de exibição atuais de data e hora do Analytics de DD MMM AAAA e hh:mm:ss PM:

STODT(42003,25000)

Retorna `20141231t191530` exibido como 31 Dez 2014 07:15:30 PM presumindo formatos de exibição atuais de data e hora do Analytics de DD MMM AAAA e hh:mm:ss PM:

STODT(42003,802431)

Datas iniciais ajustadas

Retorna `20181231t120000` exibido como 31 Dez 2018 12:00:00 PM presumindo formatos de exibição atuais de data e hora do Analytics de DD MMM AAAA e hh:mm:ss PM:

STODT(42003,50000; `19040101`)

Campos como entrada

Retorna a datahora equivalente para cada datahora serial no campo Data_e_hora_do_recebimento:

STODT(Data_e_hora_do_recebimento)

Exemplos avançados

Ajuste para data inicial anterior a 1900-01-01

Use aritmética de datas para ajustar a data inicial para um valor anterior à data mínima do Analytics, 1 de janeiro de 1900:

Converta a datahora serial usando a data de início padrão.
Subtraia o número de dias antes de 1900-01-01 referentes a data de início real.

Para usar 1899-01-01 como a data inicial (avaliada como `20131231t180000`):

STODT(42003,75000) - 365

Observações

À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:

Como funciona?

A função STODT( ) permite converter datahoras seriais em datahoras normais. As datahoras seriais do Analytics representam o número de dias decorridos desde 1º de janeiro de 1900 e, após o ponto decimal, representam uma fração de 24 horas, com 24 horas equivalendo a 1.

Datahora serial	Equivalente em datahora normal
1,25	02 Janeiro 1900 06:00:00 AM
365,75000	31 de dezembro de 1900 06:00:00 PM
42003,79167	31 de dezembro de 2014 07:00:00 PM
42003,802431	31 de dezembro de 2014 07:15:30 PM
42003,00000	31 de dezembro de 2014 12:00:00 AM
42003,50000	31 de dezembro de 2014 12:00:00 PM
0,0	inválido

Para obter mais informações sobre datahoras seriais, consulte Datahoras seriais.

Datas seriais do Analytics comparadas com datas seriais do Excel

As datas seriais do Analytics são semelhantes às datas seriais do Microsoft Excel. Você deve estar ciente de um ponto importante de semelhança e outro ponto importante de diferença. Os dois pontos não são relacionados.

Ponto de similaridade

Tanto o Analytics quanto o Excel tratam o ano 1900 como um ano bissexto, com 366 dias. Embora 1900 não tenha sido realmente um ano bissexto, o Excel considera o ano bissexto para manter a compatibilidade com o Lotus 1-2-3.

Ponto de diferença

As datas seriais do Analytics são deslocadas em um dia em relação às datas seriais do Excel. No Excel, 1º de janeiro de 1900 corresponde à data serial '1'. No Analytics, 1º de janeiro de 1900 não é contado e 2 de janeiro de 1900 corresponde à data serial '1'.

A data_inicial

Alguns arquivos de dados de origem podem usar uma data inicial diferente de 1º de janeiro de 1900. A data_inicial permite corresponder a data de início em um arquivo de dados de origem. A data de início é a data a partir da qual as datahoras seriais são calculadas.

Data de início em um arquivo de dados de origem	Especifique:	Detalhes
1º de janeiro de 1900	STODT(campo_de_datahora)	Não é necessário especificar uma data_de_início, pois a data de início padrão é 1º de janeiro de 1900.
1º de janeiro de 1901	STODT(campo_de_datahora; `19010101`)	Você especifica uma data_de_início de `19010101` para corresponder a data de início de 1º de janeiro de 1901 usada no arquivo de dados de origem.
1º de janeiro de 1899	STODT(campo_de_datahora) - 365	Não é possível especificar uma data_inicial anterior a 1º de janeiro de 1900. Se um arquivo de dados de origem usar uma data de início anterior a 1º de janeiro de 1900, você poderá criar uma expressão de datahora que subtrai o número apropriado de dias dos resultados da saída da função STODT( ).

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

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.