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 de Profile Query Language (PQL). Para obter mais informações sobre outras funções PQL, consulte Profile Query Language overview.

Mês atual

A função currentMonth retorna o mês atual como um número inteiro.

Formato

currentMonth()

Exemplo

O query 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 determinado carimbo de data e hora.

Formato

{TIMESTAMP}.getMonth()

Exemplo

O query 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

O query 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 determinado carimbo de data e hora.

Formato

{TIMESTAMP}.getYear()

Exemplo

O query 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 atual do mês

A função currentDayOfMonth retorna o dia atual do mês como um número inteiro.

Formato

currentDayOfMonth()

Exemplo

O query PQL a seguir verifica se o dia de nascimento da pessoa corresponde ao dia atual do mês.

person.birthDay = currentDayOfMonth()

Obter o dia do mês

A função getDayOfMonth retorna o dia, como um número inteiro, com base em um determinado carimbo de data e hora.

Formato

{TIMESTAMP}.getDayOfMonth()

Exemplo

O query 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 e hora fornecida com um período fixo.

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}
Argumento Descrição
{COMPARISON} Um operador de comparação. Pode ser qualquer um dos seguintes operadores: >, >=, <, <=, =, !=. Mais informações sobre as funções de comparação podem ser encontradas no documento de funções de comparação.
{INTEGER} Um número inteiro não negativo.
{TIME_UNIT} Uma unidade de tempo. Pode ser qualquer uma das seguintes palavras: millisecond(s), second(s), minute(s), hour(s), day(s), week(s), month(s), year(s), decade(s), century, centuries, millennium, millennia.
{DIRECTION} Uma preposição que descreve quando comparar a data com. Pode ser qualquer uma das seguintes palavras: before, after, from.
{TIME} Pode ser um literal de carimbo de data e hora (today, now, yesterday, tomorrow), uma unidade de hora relativa (um de this, last ou next seguido por uma unidade de hora) ou um atributo de carimbo de data e hora.
OBSERVAÇÃO

O uso da palavra on é opcional. Ele está lá para melhorar a legibilidade de algumas combinações, como timestamp occurs on date(2019,12,31).

Exemplo

O seguinte query PQL verifica se o item foi vendido na semana passada.

product.saleDate occurs last week

O seguinte query PQL 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

O query 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 start do dia de execução do PQL.

Exemplo

O query 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 nos query PQL. Para obter mais informações sobre outras funções PQL, leia a visão geral da linguagem do Query do Perfil.

Nesta página

Adobe Summit Banner

A virtual event April 27-28.

Expand your skills and get inspired.

Register for free
Adobe Summit Banner

A virtual event April 27-28.

Expand your skills and get inspired.

Register for free
Adobe Maker Awards Banner

Time to shine!

Apply now for the 2021 Adobe Experience Maker Awards.

Apply now
Adobe Maker Awards Banner

Time to shine!

Apply now for the 2021 Adobe Experience Maker Awards.

Apply now