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.
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()
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
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()
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]
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()
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
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. |
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)
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
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
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.