All Products
Search
Document Center

Dataphin:Create a new statistical period

Last Updated:Aug 13, 2025

A statistical period defines the time span for statistical data, such as the past 7 or 30 days. This topic explains how to create a new statistical period.

Prerequisites

  • The intelligent R&D version or asset operation feature must be enabled to utilize the statistical period function.

  • Ensure the compute engine type is configured. For more information, see Compute settings. After the compute engine type is set, the system automatically initializes a set of statistical periods, including commonly used periods built into the system.

Permission requirements

Only super administrators and system administrators have the authority to create statistical periods.

Procedure

  1. Navigate to the Dataphin home page, and from the top menu bar, select Planning > Common Business Logic.

  2. On the Common Business Logic page, click the + Create New Statistical Period button.

  3. In the Create New Statistical Period dialog box, enter the required parameters.

    Parameter

    Description

    Statistical Period

    The name of the statistical period can include Chinese characters, numbers, letters, underscores (_), or hyphens (-).

    Note

    The name must not exceed 64 characters.

    English Abbreviation

    The English abbreviation for the statistical period can include letters, numbers, or underscores (_).

    Note

    The abbreviation must not exceed 64 characters.

    Time Granularity

    Choose from day, hour, or minute for the time granularity.

    Note

    StarRocks, SelectDB, and Doris compute engines only support day, not hour or minute.

    Description

    Provide a concise description of the statistical period, within 128 characters.

    Calculation Expression

    Define the calculation expression for the statistical period. For guidance, see Appendix: Statistical Period Expression Parameters .

    Calendar

    When the time granularity is day, you can configure the calendar type, choosing between the regular and financial calendars.

    For financial calendars, the system outputs dates based on the financial calendar's cycle settings when using cBeginDate, cEndDate, and tdBeginDate.

    Start Time

    Set the Start Time for the statistical period:

    • Select Parameter and input the parameter's expression.

    • After selecting Function Expression, click the fagaga icon and select a function from the drop-down list. The system automatically selects the expression corresponding to the function.

    End Time

    Set the End Time for the statistical period:

    • Select Parameter and input the parameter's expression.

    • After selecting Function Expression, click the fagaga icon and select a function from the drop-down list. The system automatically selects the expression corresponding to the function.

    Note
    • The system does not allow the creation of periods with identical Start Time and End Time.

    • The system prohibits the creation of duplicate Statistical Period names or English Abbreviations.

  4. Click OK to finalize the creation of the statistical period.