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

Sintaxe

STOD(data_serial <;data_inicial>)

Parâmetros

Nome	Tipo	Descrição
data_serial	numérico	O campo, expressão ou valor literal a ser convertido. data_serial pode ser uma data serial ou uma datahora serial. Apenas a parte de data das datahoras seriais é considerada. A parte referente à hora é ignorada.
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

data_serial

numérico

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

data_serial pode ser uma data serial ou uma datahora serial. Apenas a parte de data das datahoras seriais é considerada. A parte referente à hora é ignorada.

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 data resultante usa o formato de exibição de data atual do Analytics.

Exemplos

Exemplos básicos

Retorna `20141231` exibido como 31 Dez 2014 presumindo um formato de exibição atual de data do Analytics de DD MMM AAAA:

STOD(42003)

Retorna `20181231` exibido como 31 Dez 2018 presumindo um formato de exibição atual de data do Analytics de DD MMM AAAA:

STOD(42003; `19040101`)

Retorna a data equivalente para cada data serial no campo Data_Fatura:

STOD(Data_fatura)

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 data 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 `20131231`):

STOD(42003) - 365

Observações

Como funciona?

A função STOD( ) permite converter datas seriais em datas normais. As datas seriais do Analytics representam o número de dias decorridos desde 1º de janeiro de 1900.

Data serial	Equivalente em data normal
1	2 de janeiro de 1900
365	31 de dezembro de 1900
42003	31 de dezembro de 2014
0	inválido

Para obter mais informações sobre datas 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 datas seriais são calculadas.

Data de início em um arquivo de dados de origem	Especifique:	Detalhes
1º de janeiro de 1900	STOD(campo_de_data)	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	STOD(campo_de_data; `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	STOD(campo_de_data) - 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 STOD( ).

Outras funções de conversão datahora

Conversão de serial para datahora

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

[ Voltar ao início ]

Guia de scripting do ACL 14.1