--- schema_version: "1" id: 6c42fa7c70d6cebbb8809313f1517edc4f31f2961bded0f6fc4e01f24b79198a title: Period collection: legacydeveloper version: current locale: en-us portal_url: https://docs.salesforce.com/legacydeveloper/current/en-us/object_reference/sforce_api_objects_period.md canonical_url: https://developer.salesforce.com/docs/atlas.en-us.object_reference.meta/object_reference/sforce_api_objects_period.htm source_site: developer.salesforce.com content_type: documentation content_hash: f2d3bdaa82d6bd612844650f4a7afa3351bf0c2358f616201fa7cdeede6d1a03 description: Represents a fiscal period defined in FiscalYearSettings. --- # Period Represents a fiscal period defined in FiscalYearSettings. ## Supported Calls describeSObjects(), getDeleted(), getUpdated(), query(), retrieve() ## Special Access Rules As of Spring ’20 and later, only Chatter Free users and standard users can access this object. ## Fields | Field | Details | | --- | --- | | EndDate | Type date Properties Filter, Group, Sort Description The last date of the fiscal period. | | FiscalYearSettingsId | Type reference Properties Filter, Nillable, Group, Sort Description The parent record for this period. This is a relationship field. Relationship Name FiscalYearSettings Relationship Type Lookup Refers To FiscalYearSettings | | FullyQualifiedLabel | Type string Properties Group, Nillable Description Represents the period’s complete name in the UI. For example, “September FY 2016”. | | IsForecastPeriod | Type boolean Properties Defaulted on create, Filter, Group, Sort Description Indicates whether the period is associated with Salesforce Forecasting (true) or not (false). | | Number | Type int Properties Filter, Nillable, Group, 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. | | PeriodLabel | 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. | | QuarterLabel | Type picklist Properties Defaulted on create, 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. | | StartDate | Type date Properties Filter, Group, Sort Description The first date of the fiscal period. | | Type | 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. | ## Usage 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. #### See Also - [FiscalYearSettings](https://developer.salesforce.com/docs/atlas.en-us.object_reference.meta/object_reference/sforce_api_objects_fiscalyearsettings.htm "Settings to define a custom or standard fiscal year for your organization. This object has a parent-child relationship with the Period object.")