Os filtros para campos de Data e/ou Hora podem ser utilizados da seguinte forma:
• Campos de data e hora: datetime'2010-10-25T12:34:56'.
• Campos somente com data: datetime'2010-10-25'.
• Campos somente com hora: filtro não é suportado.
Nota: fitros para atributos customizados de eventos devem utilizar "datetime2".
Os operadores suportados estão descritos na tabela abaixo:
Operador |
Descrição |
eq |
Igual |
ne |
Diferente |
gt |
Maior que |
ge |
Maior que ou igual a |
lt |
Menor que |
le |
Menor que ou igual a |
EXEMPLOS:
Filtrar eventos que tenham Deadline maior ou igual que o dia 5 de outubro de 2013:
{WSUrl}/api/events?$filter=Deadline ge datetime'2013-10-05'
Para criar um filtro para uma data específica, por exemplo, eventos criados no dia 19 de setembro de 2011 não deve-se usar o filtro "eq" e sim o seguinte:
{WSUrl}/api/events?$filter=(Created ge datetime'2011-09-19')and(Created lt datetime'2011-09-20')
Para criar um filtro que tenha data e hora específicas, por exemplo, filtro dos eventos atualizados após às 21:30 do dia 05 de novembro de 2013:
{WSUrl}/api/events?$filter=UpdatedOn ge datetime'2013-11-05T21:30:00'
Para criar um filtro para eventos que tenha um atributo customizado do tipo Data e Hora específicas, por exemplo, filtro dos eventos com data e hora de validação às 11:30 do dia 25 de Junho de 2024:
{WSUrl}/api/v2/events?$filter=CustomAttributes/prazo_valiacao ge datetime2'2024-06-25T11:30:00'