Utilización de fechas en las funciones

Seguir

En BIME, se pueden usar las funciones de fecha para crear, comparar y realizar cálculos en las fechas. Este artículo ofrece una lista de todas las funciones de fecha disponibles y ejemplos de algunos casos de uso común. Si desea información sobre cómo usar otros tipos de funciones, consulte Recursos de escritura de fórmulas.

Este artículo contiene las siguientes secciones:

Funciones de fecha disponibles

En esta sección se presentan todas las funciones de fecha disponibles. En la ventana Funciones, se pueden ver solo las funciones de fecha haciendo clic en el botón Filtrar y luego seleccionando la categoría Fecha.

Para usar las funciones de fecha es necesario usar fechas preexistentes en un parámetro. Se pueden usar el atributo fecha, fechas ingresadas manualmente u otras funciones de fecha. En los ejemplos de este artículo se demuestra cómo usar otras funciones de fecha en el parámetro fecha para crear cálculos dinámicos (consulte Escritura de fórmulas con funciones de fecha).

Las funciones de fecha se pueden usar con dos propósitos:

Nota: En el parámetro fecha se pueden usar todas las funciones de fecha.

Devolver una nueva fecha o un nuevo intervalo de fechas

Las funciones de fecha se pueden usar para agregar un atributo calculado que contenga una nueva fecha o un nuevo intervalo de fechas. En la tabla a continuación se describen todas las funciones que se pueden utilizar para devolver una nueva fecha o un nuevo intervalo de fechas.

Tabla 1. Funciones que devuelven nuevas fechas
Función Descripción
DATE (año, mes, día, hora, minuto, segundo) Devuelve una nueva fecha que contiene los parámetros especificados. Todos ellos (incluidas las métricas) deben ser números, y el año, el mes y el día son obligatorios.
YEAR (fecha) Devuelve el año de la fecha especificada.
MONTH (fecha) Devuelve el mes de la fecha especificada.
HOURS (fecha) Devuelve la hora de la fecha especificada.
MINUTES (fecha) Devuelve el minuto de la fecha especificada.
SECONDS (fecha)

Devuelve el segundo de la fecha especificada.

DATE_FROM_TIMESTAMP Devuelve una fecha a partir de la marca de tiempo especificada en segundos.
DATE_FROM_MILLI_TIMESTAMP Devuelve una fecha a partir de la marca de tiempo especificada en milisegundos.
DATE_TO_TIMESTAMP Devuelve una marca de tiempo obtenida a partir de la fecha especificada.
DATE_TO_MILLI_TIMESTAMP Devuelve una marca de tiempo en milisegundos obtenida a partir de la fecha especificada.
ND_OF_MONTH(fecha) Devuelve la última fecha del mes de la fecha especificada.
START_OF_MONTH(fecha) Devuelve la primera fecha del mes de la fecha especificada.
START_OF_QUARTER(fecha) Devuelve la primera fecha del trimestre de la fecha especificada.
END_OF_QUARTER(fecha) Devuelve la última fecha del trimestre de la fecha especificada.
START_OF_WEEK_ISO(fecha) Devuelve la primera fecha de la semana de la fecha especificada.
END_OF_WEEK_ISO(fecha) Devuelve la última fecha de la semana de la fecha especificada.
START_OF_WEEK_MONDAY(fecha) Devuelve la primera fecha de la semana de la fecha especificada, para las semanas que empiezan en lunes.
END_OF_WEEK_MONDAY(fecha) Devuelve la última fecha de la semana de la fecha especificada, para las semanas que empiezan en lunes.
START_OF_WEEK_FRIDAY(fecha) Devuelve la primera fecha de la semana de la fecha especificada, para las semanas que empiezan en viernes.
END_OF_WEEK_FRIDAY(fecha) Devuelve la última fecha de la semana de la fecha especificada, para las semanas que empiezan en viernes.
START_OF_WEEK_SATURDAY(fecha) Devuelve la primera fecha de la semana de la fecha especificada, para las semanas que empiezan en sábado.
END_OF_WEEK_SATURDAY(fecha) Devuelve la última fecha de la semana de la fecha especificada, para las semanas que empiezan en sábado.
START_OF_WEEK_SUNDAY(fecha) Devuelve la primera fecha de la semana de la fecha especificada, para las semanas que empiezan en domingo.
END_OF_WEEK_SUNDAY(fecha) Devuelve la última fecha de la semana de la fecha especificada, para las semanas que empiezan en domingo.
TODAY() Devuelve la fecha actual.
NOW() Devuelve la fecha y la hora GMT actuales.
CURRENT_YEAR() Devuelve el año en curso.
CURRENT_HALFYEAR() Devuelve el semestre en curso en forma de texto (S1 o S2).
CURRENT_QUARTER() Devuelve el trimestre en curso en forma de texto (T1, T2, T3, T4).
CURRENT_MONTH() Devuelve el mes en curso en forma de texto (enero, febrero o lo que corresponda).
CURRENT_MONTH_NUMERIC() Devuelve el mes en curso en forma de número (1 para enero, 2 para febrero y así sucesivamente).
CURRENT_DAY() Devuelve el número del día correspondiente al mes actual (1-31).
CURRENT_WEEKDAY() Devuelve el día de la semana en curso en forma de texto (lunes, martes o lo que corresponda).
CURRENT_WEEKDAY_NUMERIC() Devuelve el día de la semana en curso en forma de número (0 para domingo, 1 para lunes y así sucesivamente).
CURRENT_HOUR() Devuelve la hora actual en forma de número.
CURRENT_MINUTE() Devuelve el minuto actual en forma de número.
CURRENT_SECOND() Devuelve el segundo actual en forma de número.
FISCAL_YEAR(fecha, mes de inicio) Devuelve el año fiscal según el periodo fiscal definido en el menú Estructura de datos.
FISCAL_QUARTER(fecha, mes de inicio) Devuelve el trimestre fiscal según el periodo fiscal definido en el menú Estructura de datos.
FISCAL_WEEK_NUMBER(fecha, mes de inicio) Devuelve el número de la semana fiscal según el periodo fiscal definido en el menú Estructura de datos.

Realizar cálculos en fechas o intervalos de fechas

De igual manera, las funciones de fecha se pueden usar para realizar cálculos en las fechas. Estos cálculos pueden modificar el formato de las fechas, compararlas o realizar operaciones matemáticas en ellas.

Tabla 2. Funciones para realizar cálculos en las fechas
Función Descripción
DATE (texto) Devuelve una nueva fecha que contiene el texto especificado. Este último debe incluir el mes, el día y el año.
MONTH_NUMERIC (fecha) Devuelve el mes de la fecha especificada en forma de número (1 para enero, 2 para febrero y así sucesivamente).
WEEK_NUMBER (fecha, desfase) Devuelve el número de la semana correspondiente a la fecha especificada, teniendo en cuenta el desfase indicado (el día marcado como inicio de la semana). Por ejemplo, el desfase para las semanas que empiezan en domingo es 0.
WEEK_NUMBER_ISO(fecha) Devuelve el número correcto de la semana correspondiente a la fecha especificada.
WEEK_NUMBER_MONDAY(fecha) Devuelve el número de la semana correspondiente a la fecha especificada, para las semanas que empiezan en lunes.
WEEK_NUMBER_FRIDAY(fecha) Devuelve el número de la semana correspondiente a la fecha especificada, para las semanas que empiezan en viernes.
WEEK_NUMBER_SATURDAY(fecha) Devuelve el número de la semana correspondiente a la fecha especificada, para las semanas que empiezan en sábado.
WEEK_NUMBER_SUNDAY(fecha) Devuelve el número de la semana correspondiente a la fecha especificada, para las semanas que empiezan en domingo.
WEEKDAY(fecha) Devuelve el día de la fecha especificada en forma de texto (lunes, martes o lo que corresponda).
WEEKDAY_NUMERIC(fecha) Devuelve el día de la fecha especificada, en forma de número (0 para domingo, 1 para lunes y así sucesivamente).
DAY(fecha) Devuelve el día de la fecha especificada en forma de número.
TO_MONTH_NUMERIC(texto) Devuelve el valor numérico del mes especificado (01 para enero, 02 para febrero y así sucesivamente). Devuelve NA si el parámetro especificado no coincide con ningún mes.
TO_MONTH_TEXT(texto) Devuelve el valor de texto del mes especificado (enero para 01, febrero para 02 y así sucesivamente). Devuelve NaN si el número especificado no coincide con ningún mes.
SECONDS_TO_TIME(hora) Convierte los segundos al formato HH:MM:SS.
DATE_EQUAL(fecha, fecha) Devuelve TRUE si las dos fechas especificadas son iguales.
DATE_NOT_EQUAL(fecha, fecha) Devuelve TRUE si las dos fechas especificadas son distintas.
DATE_LESS(fecha, fecha) Devuelve TRUE si la primera fecha especificada es anterior a la segunda.
DATE_LESS_OR_EQUAL(fecha, fecha) Devuelve TRUE si la primera fecha especificada es anterior o igual a la segunda.
DATE_GREATER(fecha, fecha) Devuelve TRUE si la primera fecha especificada es posterior a la segunda.
DATE_GREATER_OR_EQUAL(fecha, fecha)

Devuelve TRUE si la primera fecha especificada es posterior o igual a la segunda.

DATE_FORMAT Devuelve la fecha especificada en el formato indicado.
DATE_ADD(fecha, parte_fecha, incremento) Devuelve la fecha dada, actualizada con el incremento especificado. El parámetro parte_fecha podría ser, por ejemplo, "año", "trimestre", "mes", "día", "hora", etc. El incremento especificado debe ser un valor entero, pero puede ser negativo.
DATE_DIFF(fecha, fecha, parte_fecha) Devuelve la diferencia entre las dos fechas especificadas, calculada a partir del parámetro parte_fecha. Para computar la diferencia relativa, parte_fecha debe ser un valor similar a "año", "mes" o "día".
DATE_DIFF([Fecha métrica],[Fecha métrica],"número_de_días") Para calcular la diferencia absoluta, ingrese las distintas fechas de las métricas y, a continuación, "número_de_días", "número_de_meses" o "número_de_años".

Escritura de fórmulas con funciones de fecha

Esta sección ofrece algunos ejemplos de cómo se pueden usar las funciones de fecha en los informes. En los ejemplos se utilizan los dos tipos de funciones de fecha para crear métricas dinámicas personalizadas.

Calcular el número de días entre dos fechas

La función DATE_DIFF sirve para calcular la diferencia entre dos días, años, trimestres, semestres, horas, minutos o segundos. En este ejemplo se usa la función DATE_DIFF para calcular el número de días entre cuando un ticket fue creado y la fecha actual.

Para calcular la diferencia entre la fecha de creación y el día de hoy
  1. En el menú Cálculos, seleccione Métrica calculada estándar.
  2. Póngale nombre a la métrica. En este ejemplo se utiliza Días desde la creación.
  3. Haga clic en el botón +Agregar bajo Funciones.
  4. Seleccione la función DATE_DIFF.

  5. En el primer parámetro _fecha, ingrese la fecha más antigua. Hay tres opciones para ingresar la fecha:
    • Ingrese una fecha específica con el formato mes/día/año.
    • Seleccione un atributo de fecha en la lista desplegable Seleccionar un campo. En este ejemplo se usa el atributo de fecha Date(fecha_creación_ticket)
    • Seleccione una función de fecha.
  1. En el segundo parámetro _fecha, ingrese la fecha más reciente. En este ejemplo se utiliza la función TODAY() lo que garantiza que el cálculo siempre usará la fecha actual.
  2. En la _parte_fecha seleccione la parte de la fecha que desea sustraer y enciérrela entre “comillas dobles”. En este ejemplo se mide el número de días, entonces se ingresa “días”.

  3. Haga clic en Guardar.
  4. Haga clic en el botón + en Métricas para agregar la métrica calculada a la consulta.

Mostrar los resultados de un periodo de tiempo anterior

Con la función DATE_ADD se pueden mostrar los resultados de la semana, el mes o el año anterior. En este ejemplo se usa DATE_ADD para comparar los ingresos semanales. Esta fórmula se puede usar para comparar cualquier intervalo de fechas seleccionando una función de fechas diferente como punto de referencia. Esta fórmula puede cambiar según la fuente de datos que se utilice.

Para comparar la semana anterior con hoy

  1. En el menú Cálculos, seleccione Métrica calculada estándar.
  2. Ingrese un nombre para la métrica calculada. En este ejemplo se usan Tickets de la semana anterior.
  3. Haga clic en el botón +Agregar bajo Funciones.
  4. Seleccione la función IF THEN ELSE.
  5. Haga clic dentro de los paréntesis de la _condición_booleana.
  6. Seleccione un atributo de fecha en la lista desplegable Seleccionar un campo o escriba el nombre del atributo. En este ejemplo se usa el atributo WEEK(fecha).
    Nota: Si se ingresa el atributo manualmente, se debe elegir la sugerencia de autocompletar o replicar el formato exacto ya que si el formato es incorrecto, los cálculos no se efectúan.

  7. Después del paréntesis de cierre, ingrese un signo de igual.
  8. Haga clic en el botón +Agregar bajo Funciones.
  9. Seleccione la función para el periodo de fecha que desea usar. En este ejemplo se usa la función WEEK_NUMBER_ISO para que los resultados se presenten por semana.
    Nota: Si la consulta viene de una fuente de datos local, en su lugar use la función WEEK_NUMBER.
  10. Haga clic en el botón +Agregar bajo Funciones.
  11. Haga clic en el botón + junto a la función DATE_ADD.

  12. En el parámetro _fecha, ingrese la fecha con la cual desea comparar los resultados anteriores. En este ejemplo se comparan los resultados anteriores con la fecha actual, entonces se selecciona la función TODAY().
  13. Para la _parte_fecha, ingrese la porción de la fecha que desea que aumente o disminuya. La _parte_fecha debe entrecomillarse con “comillas dobles”. En este ejemplo se usa la parte de fecha “día”.

    https://zen-marketing-documentation.s3.amazonaws.com/docs/en/dateadd_3.png

  14. Para el _incremento, ingrese un entero que indique hasta dónde debe remontarse en el pasado o avanzar en el futuro la fecha devuelta. En este ejemplo, se compara la semana anterior con la parte_fecha “días”, entonces se ingresa -7.
  15. Si está usando la función WEEK_NUMBER en lugar de WEEK_NUMBER_ISO, ingrese la función CURRENT_WEEKDAY_NUMERIC a modo de desfase para que la fecha de inicio sea la misma entre una semana y otra.
  16. Para el _valor_si_es_verdadero seleccione una métrica en la lista desplegable Seleccionar un campo o escriba el nombre de la métrica. En este ejemplo se usa SUM(ingresos).
  17. Borre ELSE y _valor_si_es_falso.

  18. Haga clic en Guardar.

Si quiere comparar los resultados con la semana actual, puede crear una métrica calculada de intervalo de fechas, o bien crear otra métrica calculada estándar con la siguiente fórmula:

IF ([WEEK(DATE)=WEEK_NUMBER_ISO(TODAY())) THEN SUM(Tickets) ENDIF
¿Tiene más preguntas? Enviar una solicitud

0 Comentarios

Inicie sesión para dejar un comentario.
Tecnología de Zendesk