Funções de data e hora
As funções de data e hora são usadas para executar operações de data e hora em valores dentro do Profile Query Language (PQL). Mais informações sobre outras funções PQL podem ser encontradas no Profile Query Language visão geral.
Mês atual
A variável currentMonth A função 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 variável getMonth A função retorna o mês como um número inteiro, com base em um determinado carimbo de data e hora.
Formato
{TIMESTAMP}.getMonth()
Exemplo
A consulta PQL a seguir verifica se o mês de nascimento da pessoa é em junho.
person.birthdate.getMonth() = 6
Ano atual
A variável currentYear A função retorna o ano atual como um número inteiro.
Formato
currentYear()
Exemplo
A consulta PQL a seguir verifica se o produto foi vendido no ano atual.
product.saleYear = currentYear()
Obter ano
A variável getYear A função retorna o ano como um número inteiro, com base em um determinado carimbo de data e hora.
Formato
{TIMESTAMP}.getYear()
Exemplo
A consulta PQL a seguir verifica se o ano de nascimento da pessoa ocorre em 1991, 1992, 1993, 1994 ou 1995.
person.birthday.getYear() in [1991, 1992, 1993, 1994, 1995]
Dia do mês atual
A variável currentDayOfMonth A função 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 variável getDayOfMonth A função retorna o dia, como um número inteiro, com base em um determinado carimbo de data e hora.
Formato
{TIMESTAMP}.getDayOfMonth()
Exemplo
A consulta PQL a seguir verifica se o item foi vendido nos primeiros 15 dias do mês.
product.sale.getDayOfMonth() <= 15
Ocorre
A variável occurs A função compara a função de carimbo de data e hora fornecida com um período de tempo fixo.
Formato
A variável 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, lastou next seguido por uma unidade de tempo) ou um atributo de carimbo de data e hora.on é opcional. Isso melhora a legibilidade de algumas combinações, como timestamp occurs on date(2019,12,31).Exemplo
A consulta PQL a seguir verifica se o item foi vendido na semana passada.
product.saleDate occurs last week
A consulta PQL 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 e hora da execução de PQL.
Exemplo
A consulta 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 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 PQL. Para obter mais informações sobre outras funções PQL, leia o Visão geral do idioma de consulta do perfil.