Função DTOU( )

Converte um valor de data do Analytics para uma cadeia Unicode no idioma e no formato de localidade especificados. Abreviação de "Data para Unicode".

Nota

Essa função é específica para a edição Unicode do Analytics. Não é uma função suportada na edição não-Unicode.

Sintaxe

DTOU(<data> <;local> <;estilo>)

Parâmetros

Nome	Tipo	Descrição
data opcional	datahora	O campo, expressão ou valor literal que será convertido em uma cadeia Unicode. Se for omitido, a data atual do sistema operacional é utilizada. A data pode conter um valor datahora, mas a parte correspondente ao horário é ignorada. Valores de hora independentes não são compatíveis. É possível especificar um campo ou um valor de data literal: Campo pode usar qualquer formato de data, desde que a definição do campo defina corretamente o formato Literal precisa usar um dos formatos AAAAMMDD ou AAMMDD, por exemplo `20141231` O valor mínimo de data permitido é 31 de dezembro de 1969.
local opcional	caractere	O código da localidade que especifica o idioma da cadeia de saída e, como opção, a versão do idioma associado a um país ou região específica. Por exemplo, "zh" especifica chinês, e "pt_BR" especifica português brasileiro. Se for omitido, é utilizada a localidade padrão do computador. Se um idioma especificado, mas não o país, o país padrão para o idioma será usado. Não é possível especificar uma localidade se você não tiver especificado uma data. Para obter informações sobre os códigos de locais, consulte www.unicode.org.
estilo opcional	numérico	O estilo de formato de dados a ser usado para a cadeia Unicode. O estilo de formato corresponde ao padrão para a localidade especificada: 0 – formato de especificação completa, como "Domingo, 18 de setembro de 2016" 1 – formato longo, como "18 de setembro de 2016" 2 – formato médio, como "18 de set. de 2016" 3 – formato numérico curto, como "18/09/16" Se omitido, o valor padrão 2 é usado. Não é possível especificar um estilo se você não tiver especificado uma data e uma localidade.

Nome

Tipo

Descrição

data

opcional

datahora

O campo, expressão ou valor literal que será convertido em uma cadeia Unicode. Se for omitido, a data atual do sistema operacional é utilizada.

A data pode conter um valor datahora, mas a parte correspondente ao horário é ignorada. Valores de hora independentes não são compatíveis.

É possível especificar um campo ou um valor de data literal:

Campo pode usar qualquer formato de data, desde que a definição do campo defina corretamente o formato
Literal precisa usar um dos formatos AAAAMMDD ou AAMMDD, por exemplo `20141231`

O valor mínimo de data permitido é 31 de dezembro de 1969.

local

opcional

caractere

O código da localidade que especifica o idioma da cadeia de saída e, como opção, a versão do idioma associado a um país ou região específica.

Por exemplo, "zh" especifica chinês, e "pt_BR" especifica português brasileiro.

Se for omitido, é utilizada a localidade padrão do computador. Se um idioma especificado, mas não o país, o país padrão para o idioma será usado.

Não é possível especificar uma localidade se você não tiver especificado uma data.

Para obter informações sobre os códigos de locais, consulte www.unicode.org.

estilo

opcional

numérico

O estilo de formato de dados a ser usado para a cadeia Unicode. O estilo de formato corresponde ao padrão para a localidade especificada:

0 – formato de especificação completa, como "Domingo, 18 de setembro de 2016"
1 – formato longo, como "18 de setembro de 2016"
2 – formato médio, como "18 de set. de 2016"
3 – formato numérico curto, como "18/09/16"

Se omitido, o valor padrão 2 é usado. Não é possível especificar um estilo se você não tiver especificado uma data e uma localidade.

Saída

Caractere.

Exemplos

Exemplos básicos

Valores de entrada literal

Retorna "31 de dezembro de 2014":

DTOU(`20141231`; "pt_BR"; 1)

Retorna "31 grudnia 2014":

DTOU(`20141231`; "pl"; 1)

Valores de entrada de campo

Retorna cada data numérica no campo Data_Fatura como uma cadeia Unicode:

DTOU(Data_fatura; "zh"; 1)

A saída usa o estilo de data completa

Retorna "星期三, 2014 十二月 31" (sem identificador de região especificado):

DTOU(`20141231`; "zh"; 0)

Retorna "2014年12月31日星期三" (identificador de região especificado):

DTOU(`20141231`; "zh_CN"; 0)

A saída usa o estilo de data longa

Retorna "2014 十二月 31" (sem identificador de região especificado):

DTOU(`20141231`; "zh"; 1)

Retorna "2014年12月31日" (identificador de região especificado):

DTOU(`20141231`; "zh_CN"; 1)

Observações

Funções relacionadas

DTOU( ) é o inverso da função UTOD( ) que converte caracteres Unicode em uma data.

[ Voltar ao início ]

Guia de scripting do ACL 14.1