Yandex Cloud
Search
Contact UsGet started
  • Blog
  • Pricing
  • Documentation
  • All Services
  • System Status
    • Featured
    • Infrastructure & Network
    • Data Platform
    • Containers
    • Developer tools
    • Serverless
    • Security
    • Monitoring & Resources
    • ML & AI
    • Business tools
  • All Solutions
    • By industry
    • By use case
    • Economics and Pricing
    • Security
    • Technical Support
    • Customer Stories
    • Cloud credits to scale your IT product
    • Gateway to Russia
    • Cloud for Startups
    • Education and Science
    • Yandex Cloud Partner program
  • Blog
  • Pricing
  • Documentation
© 2025 Direct Cursus Technology L.L.C.
Yandex DataLens
    • Overview
    • Formula syntax
      • All Functions
        • Overview
        • AGO
        • AT_DATE
      • Function Availability
    • Parameters
  • Audit Trails events
  1. Calculated fields
  2. Function reference
  3. Time series functions
  4. AGO

AGO

Written by
Yandex Cloud
Updated at November 6, 2024

SyntaxSyntax

Standard
Extended
AGO( measure, date_dimension [ , unit [ , number ] ] )
AGO( measure, date_dimension [ , unit [ , number ] ]
     [ BEFORE FILTER BY ... ]
     [ IGNORE DIMENSIONS ... ]
   )

More info:

  • BEFORE FILTER BY
  • IGNORE DIMENSIONS

DescriptionDescription

Re-evaluate measure for a date/time with a given offset.
The date_dimension argument is the dimension along which the offset is made.
The number argument sets the offset in units of the unit argument. Set as an integer. It may take negative values. The default value is 1.
The unit argument sets the unit for number. It may take the following values:

  • "year";
  • "month";
  • "week";
  • "day" (default value);
  • "hour";
  • "minute";
  • "second".

Can also be used as AGO( measure, date_dimension, number ). In this case, the unit argument takes the "day" value.

See also AT_DATE, LAG.

Argument types:

  • measure — Any
  • date_dimension — Date | Datetime
  • unit — Integer | String
  • number — Integer

Return type: Same type as (measure)

Note

Only constant values are accepted for the arguments (unit, number).

Note

The first argument must be a measure (aggregated expression), otherwise an error will be raised.

ExamplesExamples

AGO(SUM([Sales]), [Order Date], "month", 3)
AGO(SUM([Sales]), [Order Date], "year")
AGO(SUM([Sales]), [Order Date], 1)

Data source supportData source support

ClickHouse 21.8, Files, Google Sheets, Yandex Metrica, Microsoft SQL Server 2017 (14.0), MySQL 5.7, Oracle Database 12c (12.1), PostgreSQL 9.3, Yandex Documents, YDB.

Was the article helpful?

Previous
Overview
Next
AT_DATE
© 2025 Direct Cursus Technology L.L.C.