Period

Represents a fiscal period defined in FiscalYearSettings.

Introduced in API version 7.0.

describeSObjects(), getDeleted(), getUpdated(), query(), retrieve()

  • As of Spring ’20 and later, only Chatter Free users and standard users can access this object.
  • Type: date
  • Properties: Filter, Group, Sort
  • Description: The last date of the fiscal period.

  • Type: reference

  • Properties: Filter, Group, Nillable, Sort

  • Introduced: API version 8.0

  • Description:

    The parent record for this period.

    This is a relationship field.

  • Relationship name: FiscalYearSettings

  • Relationship type: relationship

  • Refers to: FiscalYearSettings

  • Type: string
  • Properties: Group, Nillable
  • Introduced: API version 37.0
  • Description: Represents the period’s complete name in the UI. For example, “September FY 2016”.
  • Type: boolean
  • Properties: Defaulted on create, Filter, Group, Sort
  • Description: Indicates whether the period is associated with Salesforce Forecasting (true) or not (false).
  • Default value: false
  • Type: int
  • Properties: Filter, Group, Nillable, Sort
  • Description: If the labeling scheme of your fiscal year’s quarters or months is numbered, this field indicates the relative number of the row.
  • Type: picklist
  • Properties: Filter, Group, Nillable, Sort
  • Description: If the months in your fiscal year use custom names, then this field contains the appropriate name for rows of type Month.
  • Type: picklist
  • Properties: Filter, Group, Nillable, Sort
  • Description: If the quarters in your fiscal year use custom names, then this field contains the appropriate name for rows of type Quarter.
  • Type: date
  • Properties: Filter, Group, Sort
  • Description: The first date of the fiscal period.
  • Type: picklist
  • Properties: Filter, Group, Nillable, Restricted picklist, Sort
  • Description: Indicates whether the period is of type Month, Quarter, Week, or Year. Label is the field value.

In API version 36.0 and earlier, querying the Period object yields no results. In API version 37.0 and later, a query returns period records.