Función DATETIME( )

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

Sintaxis

DATETIME(<fechahora> <;formato>)

Parámetros

Nombre Tipo Descripción
fechahora

opcional

fechahora

El campo, expresión o valor literal a convertir. 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

Valor de entrada de fechahora literal

Devuelve "20141231 235959" en los formatos de visualización de fecha y hora actuales de Analytics:

DATETIME(`20141231 235959`)

Devuelve "31-Dic-2014 11:59 P":

DATETIME(`20141231 235959`; "DD-MMM-YYYY hh:mm A")

Devuelve la fecha y la hora actual del sistema operativo como una cadena de caracteres, utilizando los formatos de visualización actuales de la fecha y la hora de Analytics:

DATETIME()

Valor de entrada del campo

Devuelve cada valor del campo Marca_de_hora_recepción como una cadena de caracteres, utilizando los formatos actuales de visualización de la fecha y hora de Analytics:

DATETIME(Marca_de_hora_recepción)

Devuelve cada valor del campo Marca_de_hora_recepción como una cadena de caracteres utilizando los formatos de visualización de fecha y hora especificados:

DATETIME(Marca_de_hora_recepción; "DD/MM/YYYY hh:mm:ss")

Observaciones

Longitud de la cadena de salida

La longitud de la cadena de salida es siempre de 27 caracteres. Si el formato de salida especificado o los formatos de visualización de la fecha y hora de Analytics tienen menos de 27 caracteres, la cadena de salida se rellena con espacios finales en blanco.

Detalles del parámetro

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

Si utiliza el formato para controlar cómo se muestra la cadena de salida, solo puede utilizar los formatos de la siguiente tabla.

  • Se puede utilizar cualquier combinación de formatos de fecha, hora y AM/PM.
  • La fecha debe preceder a la hora. No es necesaria la colocación de un separador entre las dos ya que Analytics utiliza automáticamente un espacio como separador en la cadena de salida.
  • El formato AM/PM es opcional y se coloca al final.
  • El formato se debe especificar usando comillas simples o dobles.

    For example: "DD-MMM-AAAA hh:mm:ss AM"

Formatos de fecha

Formatos de hora

Formatos AM/PM

Ejemplos

todos los formatos de visualización de fecha admitidos por Analytics

hh:mm:ss

ninguno

reloj de 24 horas

"DD/MM/AAAA hh:mm:ss"

 

hhmmss

AM o PM

reloj de 12 horas

"MMDDAA hhmmss PM"

 

hh:mm

A o P

reloj de 12 horas

"DD-MMM-AAAA hh:mm A"

 

hhmm

 

 
 

hh

 

 

Especificar un valor de fechahora literal

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

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 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.

     

Otras funciones de conversión de fechahora

Conversión de datos de Fechahora a Carácter

Función Descripció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.

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