Funciones de fecha y hora

Las funciones de fecha y hora se utilizan para realizar operaciones de fecha y hora en valores dentro de Profile Query Language (PQL). Puede encontrar más información sobre otras funciones de PQL en Profile Query Language overview.

Mes actual

La función currentMonth devuelve el mes actual como un número entero.

Format

currentMonth()

Ejemplo

La siguiente consulta PQL comprueba si el mes de nacimiento de la persona es el mes actual.

person.birthMonth = currentMonth()

Obtener mes

La función getMonth devuelve el mes, como un número entero, en función de una marca de tiempo determinada.

Formato

{TIMESTAMP}.getMonth()

Ejemplo

La siguiente consulta PQL comprueba si el mes de nacimiento de la persona es en junio.

person.birthdate.getMonth() = 6

Año actual

La función currentYear devuelve el año actual como un número entero.

Formato

currentYear()

Ejemplo

La siguiente consulta PQL comprueba si el producto se vendió en el año en curso.

product.saleYear = currentYear()

Obtener año

La función getYear devuelve el año como un número entero, en función de una marca de tiempo determinada.

Formato

{TIMESTAMP}.getYear()

Ejemplo

La siguiente consulta de PQL comprueba si el año de nacimiento de la persona cae en 1991, 1992, 1993, 1994 o 1995.

person.birthday.getYear() in [1991, 1992, 1993, 1994, 1995]

Día actual del mes

La función currentDayOfMonth devuelve el día actual del mes como un número entero.

Formato

currentDayOfMonth()

Ejemplo

La siguiente consulta PQL comprueba si el día de nacimiento de la persona coincide con el día actual del mes.

person.birthDay = currentDayOfMonth()

Obtener día del mes

La función getDayOfMonth devuelve el día, como un número entero, en función de una marca de tiempo determinada.

Formato

{TIMESTAMP}.getDayOfMonth()

Ejemplo

La siguiente consulta PQL comprueba si el artículo se vendió en los primeros 15 días del mes.

product.sale.getDayOfMonth() <= 15

Ocurrencias

La función occurs compara la función de marca de tiempo dada con un período de tiempo fijo.

Formato

La función occurs se puede escribir con cualquiera de los siguientes formatos:

{TIMESTAMP} occurs {COMPARISON} {INTEGER} {TIME_UNIT} {DIRECTION} {TIME}
{TIMESTAMP} occurs {DIRECTION} {TIME}
{TIMESTAMP} occurs (on) {TIME}
{TIMESTAMP} occurs between {TIME} and {TIME}
Argumento Descripción
{COMPARISON} Un operador de comparación. Puede ser cualquiera de los siguientes operadores: >, >=, <, <=, =, !=. Puede encontrar más información sobre las funciones de comparación en el documento de funciones de comparación.
{INTEGER} Un entero no negativo.
{TIME_UNIT} Unidad de tiempo. Puede ser cualquiera de las siguientes palabras: millisecond(s), second(s), minute(s), hour(s), day(s), week(s), month(s), year(s), decade(s), century, centuries, millennium, millennia.
{DIRECTION} Una preposición que describe cuándo comparar la fecha. Puede ser cualquiera de las siguientes palabras: before, after, from.
{TIME} Puede ser un literal con marca de hora (today, now, yesterday, tomorrow), una unidad de tiempo relativa (una de this, last o next seguida de una unidad de tiempo) o un atributo con marca de hora.
NOTA

El uso de la palabra on es opcional. Está ahí para mejorar la legibilidad de algunas combinaciones, como timestamp occurs on date(2019,12,31).

Ejemplo

La siguiente consulta PQL comprueba si el artículo se vendió la semana pasada.

product.saleDate occurs last week

La siguiente consulta PQL comprueba si un artículo se vendió entre el 8 de enero de 2015 y el 1 de julio de 2017.

product.saleDate occurs between date(2015, 1, 8) and date(2017, 7, 1)

Ahora

now es una palabra reservada que representa la marca de tiempo de la ejecución de PQL.

Ejemplo

La siguiente consulta PQL comprueba si un artículo se vendió exactamente tres horas antes.

product.saleDate occurs = 3 hours before now

Hoy

today es una palabra reservada que representa la marca de tiempo del inicio del día de la ejecución de PQL.

Ejemplo

La siguiente consulta PQL comprueba si el cumpleaños de una persona era hace tres días.

person.birthday occurs = 3 days before today

Pasos siguientes

Ahora que ha aprendido sobre las funciones de fecha y hora, puede utilizarlas en sus consultas PQL. Para obtener más información sobre otras funciones de PQL, lea la información general del lenguaje de consulta de perfil.

En esta página