Função @YEAR

Revisão de 20h19min de 24 de fevereiro de 2025 por Admin (discussão | contribs) (Parâmetros)

A função @YEAR é utilizada para extrair o componente "ano" de uma data específica, retornando-o como um valor inteiro. Esta função é particularmente útil em consultas SQL que necessitam filtrar ou agrupar dados com base no ano de uma determinada data.

Sintaxe

@YEAR(DATA)

Parâmetros

Nome Banco Descrição
@YEAR PostgreSQL EXTRACT(YEAR FROM DATE)
@YEAR Oracle TO_CHAR(DATE, 'YYYY')
@YEAR FireBird EXTRACT(YEAR FROM DATE)
@YEAR SQLServer YEAR(DATE)

Exemplo

procedure FiltrarPorAno;
var
  Q: TPHQuery;
begin
  try
    Q := NewPHQuery;
    Q.Add('SELECT * ' +
          'FROM VENDAS ' +
          'WHERE @YEAR(DATA_VENDA) = :AnoFiltro');
  finally
    Q.Free;
  end;
end;
begin
  FiltrarPorAno;
end.