Funções de data e hora
Funções de data e hora são usadas para executar operações de data e hora em valores dentro de Profile Query Language (PQL). Mais informações sobre outras funções do PQL podem ser encontradas na Profile Query Language visão geral.
Mês atual
A função currentMonth retorna o mês atual como um número inteiro.
Formato
currentMonth()
Exemplo
A consulta PQL a seguir verifica se o mês de nascimento da pessoa é o mês atual.
person.birthMonth = currentMonth()
Obter mês
A função getMonth retorna o mês como um número inteiro, com base em um carimbo de data/hora especificado.
Formato
{TIMESTAMP}.getMonth()
Exemplo
A consulta do PQL a seguir verifica se o mês de nascimento da pessoa é em junho.
person.birthdate.getMonth() = 6
Ano atual
A função currentYear retorna o ano atual como um número inteiro.
Formato
currentYear()
Exemplo
A consulta do PQL a seguir verifica se o produto foi vendido no ano atual.
product.saleYear = currentYear()
Obter ano
A função getYear retorna o ano como um número inteiro, com base em um carimbo de data/hora especificado.
Formato
{TIMESTAMP}.getYear()
Exemplo
A consulta do PQL a seguir verifica se o ano de nascimento da pessoa cai em 1991, 1992, 1993, 1994 ou 1995.
person.birthday.getYear() in [1991, 1992, 1993, 1994, 1995]
Dia do mês atual
A função currentDayOfMonth retorna o dia atual do mês como um número inteiro.
Formato
currentDayOfMonth()
Exemplo
A consulta PQL a seguir verifica se o dia de nascimento da pessoa corresponde ao dia atual do mês.
person.birthDay = currentDayOfMonth()
Obter dia do mês
A função getDayOfMonth retorna o dia, como um número inteiro, com base em um carimbo de data/hora especificado.
Formato
{TIMESTAMP}.getDayOfMonth()
Exemplo
A consulta do PQL a seguir verifica se o item foi vendido nos primeiros 15 dias do mês.
product.sale.getDayOfMonth() <= 15
Ocorre
A função occurs compara a função de carimbo de data/hora fornecida a um período de tempo fixo como um booleano.
Formato
A função occurs pode ser gravada usando qualquer um dos seguintes formatos:
{TIMESTAMP} occurs {COMPARISON} {INTEGER} {TIME_UNIT} {DIRECTION} {TIME}
{TIMESTAMP} occurs {DIRECTION} {TIME}
{TIMESTAMP} occurs (on) {TIME}
{TIMESTAMP} occurs between {TIME} and {TIME}
{COMPARISON}>, >=, <, <=, =, !=. Mais informações sobre as funções de comparação podem ser encontradas no documento de funções de comparação.{INTEGER}{TIME_UNIT}millisecond(s), second(s), minute(s), hour(s), day(s), week(s), month(s), year(s), decade(s), century, centuries, millennium, millennia.{DIRECTION}before, after, from.{TIME}today, now, yesterday, tomorrow), uma unidade de tempo relativa (uma de this, last ou next seguida de uma unidade de tempo) ou um atributo de carimbo de data/hora.on é opcional. Ele existe para melhorar a legibilidade de algumas combinações, como timestamp occurs on date(2019,12,31).Exemplo
A consulta do PQL a seguir verifica se o item foi vendido na semana passada.
product.saleDate occurs last week
PQL A consulta a seguir verifica se um item foi vendido entre 8 de janeiro de 2015 e 1º de julho de 2017.
product.saleDate occurs between date(2015, 1, 8) and date(2017, 7, 1)
Agora
now é uma palavra reservada que representa o carimbo de data/hora da execução do PQL.
Exemplo
A consulta do PQL a seguir verifica se um item foi vendido exatamente três horas antes.
product.saleDate occurs = 3 hours before now
Hoje
today é uma palavra reservada que representa o carimbo de data e hora do início do dia da execução do PQL.
Exemplo
A consulta do PQL a seguir verifica se o aniversário de uma pessoa foi há três dias.
person.birthday occurs = 3 days before today
Próximas etapas
Agora que você aprendeu sobre funções de data e hora, é possível usá-las em consultas do PQL. Para obter mais informações sobre outras funções do PQL, leia a visão geral do Profile Query Language.