Função @YEAR

Revisão de 14h16min de 3 de março de 2025 por Admin (discussão | contribs) (Exemplo)
(dif) ← Edição anterior | Revisão atual (dif) | Versão posterior → (dif)

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');
    Q.ParambyName('AnoFiltro').Asinteger  := 2025;
    Q.Open;
  finally
    Q.Free;
  end;
end;
begin
  FiltrarPorAno;
end.