Función DATE( )

Extrae la fecha a partir de una fecha o fechahora especificada y la devuelve como una cadena de caracteres. También puede devolver la fecha actual del sistema operativo.

Sintaxis

DATE(<fecha/fechahora> <;formato>)

Parámetros

Nombre Tipo Descripción
fecha/fechahora

opcional

fechahora

El campo, expresión o el valor literal de donde extraer la fecha. Si se omite, se devuelve la fecha actual del sistema operativo.

formato

opcional

carácter

El formato que se debe aplicar a la cadena de salida, por ejemplo "DD/MM/AAAA". Si se omite, se utiliza el formato de visualización de la fecha actual de Analytics. No puede especificar un formato si ha omitido fecha/fechahora.

Salida

Carácter.

Ejemplos

Ejemplos básicos

Devuelve "20141231" en el formato de visualización de fecha actual de Analytics:

DATE(`20141231 235959`)

Devuelve "31-Dic-2014":

DATE(`20141231 235959`; "DD-MMM-YYYY")

Devuelve la fecha actual del sistema operativo como una cadena de caracteres, utilizando el formato de visualización de la fecha actual de Analytics

DATE()

Devuelve cada valor del campo Marca_de_hora_recepción como una cadena de caracteres, utilizando el formato de visualización de la fecha actual de Analytics:

DATE(Marca_de_hora_recepción)

Devuelve cada valor del campo Marca_de_hora_recepción como una cadena de caracteres utilizando el formato de visualización de fecha especificado:

DATE(Marca_de_hora_recepción; "DD/MM/YYYY")

Observaciones

Longitud de la cadena de salida

La longitud de la cadena de salida es siempre de 12 caracteres. Si el formato de salida especificado, o el formato de visualización de la fecha de Analytics, tiene menos de 12 caracteres, la cadena de salida se rellena con espacios finales en blanco.

Detalles del parámetro

Un campo especificado para fecha/fechahora puede utilizar cualquier formato de fecha o fechahora, siempre que la definición del campo establezca correctamente el formato.

Si utiliza formato para controlar cómo se muestra la cadena de salida, puede utilizar cualquier formato de visualización de fecha admitido por Analytics. Por ejemplo:

  • DD/MM/AAAA

  • MM-DD-AA

  • DD MMM AAAA

El formato se debe especificar usando comillas simples o dobles; por ejemplo, "DD MMM AAAA".

Especificar un valor de fechahora o fecha literal

Al especificar un valor literal de fecha o fechahora para fecha/fechahora, solo puede utilizar los formatos de la siguiente tabla y debe encerrar el valor entre acentos graves; por ejemplo, `20141231`.

No utilice ningún separador, como barras (/) o dos puntos (:), entre los componentes individuales de fechas u horas.

  • Valores de fechahora: puede utilizar cualquier combinación de formatos de fecha, separador y hora de la siguiente tabla. La fecha debe preceder a la hora y se debe utilizar un separador entre las dos. Los separadores válidos son un espacio en blanco, la letra 't' o la letra 'T'.

  • Valores de hora: debe especificar las horas con el reloj de 24 horas. Los desplazamientos respecto del Horario Universal Coordinado (UTC, por sus siglas en inglés) deben ir precedidos de un signo más (+) o un signo menos (-).

    Formatos de ejemplo

    Valores literales de ejemplo

    AAAAMMDD

    `20141231`

    AAMMDD

    `141231`

    AAAAMMDD hhmmss

    `20141231 235959`

    AAMMDDthhmm

    `141231t2359`

    AAAAMMDDThh

    `20141231T23`

    AAAAMMDD hhmmss+/-hhmm

    (desplazamiento de UTC)

    `20141231 235959-0500`

    AAMMDD hhmm+/-hh

    (desplazamiento de UTC)

    `141231 2359+01`

    Nota

    No use solo hh en el formato de la hora principal con datos que tienen un desplazamiento del UTC. Por ejemplo, evite: hh+hhmm. Los resultados pueden no ser confiables.

     

Funciones relacionadas

Si necesita devolver la fecha actual del sistema operativo como un valor de fechahora, utilice TODAY( ) en lugar de DATE( ).

Otras funciones de conversión de fechahora

Conversión de datos de Fechahora a Carácter

Función Descripción

DATETIME( )

Convierte una fechahora en una cadena de caracteres. También puede devolver la fechahora actual del sistema operativo.

TIME( )

Extrae la porción hora a partir de una hora o fechahora especificada y la devuelve como una cadena de caracteres. También puede devolver la hora actual del sistema operativo.

Conversión de datos de Carácter o Numéricos a Fechahora

Función Descripción

CTOD( )

Convierte un valor de fecha numérico o de caracteres en una fecha. También se puede extraer la fecha del valor en caracteres o numérico de fechahora y devolverlo como una fecha. Abreviatura de la expresión "Carácter a fecha", en inglés.

CTODT( )

Convierte un valor de caracteres o numérico de fechahora en una fechahora. Abreviatura de la expresión "Carácter a fechahora", en inglés.

CTOT( )

Convierte un valor de caracteres o numérico de hora en una hora. También se puede extraer la hora de un valor de caracteres o numérico de fechahora y devolverlo como una hora. Abreviatura de la expresión "Carácter a hora", en inglés.

Conversión de datos de Serie a Fechahora

Función Descripción

STOD( )

Convierte una fecha de serie - es decir, una fecha expresada como un entero - a un valor de fecha. Abreviatura de la expresión "Fecha de serie a fecha", en inglés.

STODT( )

Convierte una fechahora de serie - es decir, una fechahora expresada como un entero, y una porción fraccionaria de 24 horas - en un valor de fechahora. Abreviatura de la expresión "Fecha de serie a fechahora", en inglés.

STOT( )

Convierte una hora de serie - es decir, una hora expresada como una porción fraccionaria de 24 horas, con 24 horas equivalentes a 1 - en un valor de hora. Abreviatura de la expresión "Hora de serie a hora", en inglés.

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