Função UTOD( )

Converte uma cadeia Unicode que contém uma data formatada em um valor de data do Analytics. É abreviação de "Unicode to Date".

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.

Use esta função ao trabalhar com datas em idiomas e formatos diferentes da instalação padrão. Se a cadeia que você quer converter está no idioma padrão, use CTOD( ).

Sintaxe

UTOD(cadeia <;local> <;estilo>)

Parâmetros

Nome	Tipo	Descrição
cadeia	caractere	A cadeia Unicode a ser convertida em data. A cadeia Unicode pode conter um valor datahora, mas a parte correspondente à hora é ignorada. Valores de hora independentes não são compatíveis. cadeia deve corresponder ao formato de entrada exibido pelo valor de estilo para a localidade da data.
local opcional	caractere	O código que especifica o idioma e a localidade 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 mais informações sobre códigos de local, 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 localidade. Dica Para ajudar a determinar o formato esperado da cadeia de entrada, execute uma das seguintes ações: Use a função DTOU( ) para gerar um valor de exemplo usando o estilo e a localidade. Na linha de comando, use o comando DISPLAY para imprimir o valor: DISPLAY DTOU(`20160909`; "es_MX"; 3) Consulte uma origem confiável sobre o formato de data padrão para o estilo na localidade específica.

Nome

Tipo

Descrição

cadeia

caractere

A cadeia Unicode a ser convertida em data.

A cadeia Unicode pode conter um valor datahora, mas a parte correspondente à hora é ignorada. Valores de hora independentes não são compatíveis.

cadeia deve corresponder ao formato de entrada exibido pelo valor de estilo para a localidade da data.

local

opcional

caractere

O código que especifica o idioma e a localidade 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 mais informações sobre códigos de local, 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 localidade.

Dica

Para ajudar a determinar o formato esperado da cadeia de entrada, execute uma das seguintes ações:

Use a função DTOU( ) para gerar um valor de exemplo usando o estilo e a localidade.

Na linha de comando, use o comando DISPLAY para imprimir o valor:
```
DISPLAY DTOU(`20160909`; "es_MX"; 3)
```
Consulte uma origem confiável sobre o formato de data padrão para o estilo na localidade específica.

Saída

Datahora. O valor de data resultante usa o formato de exibição de data atual do Analytics.

Exemplos

Exemplos básicos

Nota

Todos os exemplos pressupõem um formato de exibição de data atual do Analytics como DD MMM AAAA.

Nos exemplos abaixo, os códigos da localidade para chinês ("zh") e chinês simplificado ("zh_CN") correspondem a cadeias de entrada diferentes e não são intercambiáveis.

Também é necessário especificar o estilo correto. Uma cadeia de caracteres de data Unicode longa (ou seja, estilo é 1) não retorna uma data do Analytics se você especifica um estilo de 2.

Valores de entrada literal

Retorna `20141231` exibido como 31 Dez 2014:

UTOD("31 de dezembro de 2014"; "pt_BR"; 1)

Retorna `20141231` exibido como 31 Dez 2014:

UTOD("31 grudnia 2014"; "pl"; 1)

Valores de entrada de campo

Retorna a data equivalente para cada cadeia Unicode no campo Data_fatura:

UTOD(Data_fatura; "zh"; 1)

A entrada usa o estilo de data completa

Retorna `20141231` exibido como 31 Dez 2014 (nenhum identificador de região especificado):

UTOD("星期三; 2014 十二月 31"; "zh"; 0)

Retorna `20141231` exibido como 31 Dez 2014 (identificador de região especificado):

UTOD("2014年12月31日星期三"; "zh_CN"; 0)

A entrada usa o estilo de data longa

Retorna `20141231` exibido como 31 Dez 2014 (nenhum identificador de região especificado):

UTOD("2014 十二月 31"; "zh"; 1)

Retorna `20141231` exibido como 31 Dez 2014 (identificador de região especificado):

UTOD("2014年12月31日"; "zh_CN"; 1)

Observações

Conversão bem-sucedida de cadeias Unicode

Para converter cadeias Unicode com datas em datas do Analytics com êxito, é necessário especificar parâmetros localidade e estilo que correspondam ao idioma do país/região (se aplicável) e ao estilo da data na cadeia Unicode.

Funções relacionadas

UTOD( ) é o inverso de DTOU( ), que converte uma data em uma cadeia Unicode. Se você não tiver certeza sobre qual país/região e estilo devem ser especificados para a função UTOD( ), pode usar DTOU( ) e experimentar com parâmetros diferentes para produzir uma cadeia Unicode de saída que corresponda à forma das cadeias Unicode de entrada que se deseja converter com UTOD( ).

[ Voltar ao início ]

Guia de scripting do ACL 14.1