Función DTOU( )

Convierte un valor de fecha de Analytics en una cadena Unicode en el formato de configuración regional y de idioma especificado. Abreviatura de la expresión "Fecha a Unicode", en inglés.

Nota

Esta función es específica de la edición Unicode de Analytics. No es una función admitida en la edición no Unicode.

Sintaxis

DTOU(<fecha> <;localidad> <;estilo>)

Parámetros

Nombre	Tipo	Descripción
fecha opcional	fechahora	El campo, expresión o valor literal para convertir en una cadena Unicode. Si se omite, se utiliza la fecha actual del sistema operativo. La fecha puede contener un valor de fechahora, pero la porción de la hora del valor se ignora. Los valores de hora independientes no son compatibles. Puede especificar un valor de fecha literal o un campo: El campo puede utilizar cualquier formato de fecha, siempre que la definición del campo establezca correctamente el formato El Literal debe utilizar uno de los formatos AAAAMMDD o AAMMDD; por ejemplo `20141231` La fecha mínima admitida es 31 de diciembre de 1969.
localidad opcional	carácter	El código de configuración regional especifica el idioma de la cadena de salida y, como opción, la versión del idioma asociado con un país o una región en particular. Por ejemplo, "zh" especifica chino y "pt_BR" especifica portugués de Brasil. Si se omite, se utiliza la configuración regional predeterminada para su computadora. Si se especifica un idioma, pero no es especifica un país, se usa el país predeterminado para el idioma. No se puede especificar una configuración regional si no ha especificado una fecha. Para obtener información sobre los códigos de localización, consulte www.unicode.org.
estilo opcional	numérico	El estilo de formato de fecha que se debe usar para la cadena Unicode. El estilo de formato coincide con el estándar de la configuración regional que usted especifique: 0: formato de especificación completa, como "Domingo, 18 de septiembre de 2016" 1: formato extenso, como "18 de septiembre de 2016" 2: formato medio, como "Sep 18, 2016" 3: formato numérico breve, como "9/18/16" Si se omite, se utiliza el valor predeterminado 2. No se puede especificar un estilo si no ha especificado una fecha y una configuración regional.

Nombre

Tipo

Descripción

fecha

opcional

fechahora

El campo, expresión o valor literal para convertir en una cadena Unicode. Si se omite, se utiliza la fecha actual del sistema operativo.

La fecha puede contener un valor de fechahora, pero la porción de la hora del valor se ignora. Los valores de hora independientes no son compatibles.

Puede especificar un valor de fecha literal o un campo:

El campo puede utilizar cualquier formato de fecha, siempre que la definición del campo establezca correctamente el formato
El Literal debe utilizar uno de los formatos AAAAMMDD o AAMMDD; por ejemplo `20141231`

La fecha mínima admitida es 31 de diciembre de 1969.

localidad

opcional

carácter

El código de configuración regional especifica el idioma de la cadena de salida y, como opción, la versión del idioma asociado con un país o una región en particular.

Por ejemplo, "zh" especifica chino y "pt_BR" especifica portugués de Brasil.

Si se omite, se utiliza la configuración regional predeterminada para su computadora. Si se especifica un idioma, pero no es especifica un país, se usa el país predeterminado para el idioma.

No se puede especificar una configuración regional si no ha especificado una fecha.

Para obtener información sobre los códigos de localización, consulte www.unicode.org.

estilo

opcional

numérico

El estilo de formato de fecha que se debe usar para la cadena Unicode. El estilo de formato coincide con el estándar de la configuración regional que usted especifique:

0: formato de especificación completa, como "Domingo, 18 de septiembre de 2016"
1: formato extenso, como "18 de septiembre de 2016"
2: formato medio, como "Sep 18, 2016"
3: formato numérico breve, como "9/18/16"

Si se omite, se utiliza el valor predeterminado 2. No se puede especificar un estilo si no ha especificado una fecha y una configuración regional.

Salida

Carácter.

Ejemplos

Ejemplos básicos

Valores de entrada literales

Devuelve "31 de dezembro de 2014"

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

Devuelve "31 grudnia 2014":

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

Valores de entrada de campo

Devuelve cada fecha numérica del campo Fecha_de_factura como una cadena Unicode:

DTOU(Fecha_de_factura ; "zh" ; 1)

La salida utiliza el estilo de fecha completo

Devuelve "星期三, 2014 十二月 31" (no se especificó el identificador de región):

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

Devuelve "2014年12月31日星期三" (se especificó el identificador de región):

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

La salida utiliza el estilo de fecha extenso

Devuelve "2014 十二月 31" (no se especificó el identificador de región):

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

Devuelve "2014年12月31日" (se especificó el identificador de región):

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

Observaciones

Funciones relacionadas

DTOU( ) es la función inversa de la función UTOD( ), que convierte la cadena Unicode en una fecha.

[ Volver al inicio ]

Guía de creación de scripts de ACL 14.1