Time periods

A time period is an object that represents a domain-scoped date range that can be set on goals.


TimePeriodCompact

A Compact object reflects the default fields returned after a successful API request. See input/output options to include more fields in the response.

PropertyTypeDescription
gidstringGlobally unique identifier of the resource, as a string.
resource_typestringThe base type of this resource.
display_namestringA string representing the cadence code and the fiscal year.
end_onstringThe localized end date of the time period in YYYY-MM-DD format.
periodstringThe cadence and index of the time period. The value is one of: FY, H1, H2, Q1, Q2, Q3, or Q4.
start_onstringThe localized start date of the time period in YYYY-MM-DD format.
{
  "gid": "12345",
  "resource_type": "time_period",
  "display_name": "Q1 FY22",
  "end_on": "2019-09-14",
  "period": "Q1",
  "start_on": "2019-09-13"
}

TimePeriod

PropertyTypeDescription
gidstringGlobally unique identifier of the resource, as a string.
resource_typestringThe base type of this resource.
display_namestringA string representing the cadence code and the fiscal year.
end_onstringThe localized end date of the time period in YYYY-MM-DD format.
parentobjectA generic Asana Resource, containing a globally unique identifier.
parent.gidstringGlobally unique identifier of the resource, as a string.
parent.resource_typestringThe base type of this resource.
parent.display_namestringA string representing the cadence code and the fiscal year.
parent.end_onstringThe localized end date of the time period in YYYY-MM-DD format.
parent.periodstringThe cadence and index of the time period. The value is one of: FY, H1, H2, Q1, Q2, Q3, or Q4.
parent.start_onstringThe localized start date of the time period in YYYY-MM-DD format.
periodstringThe cadence and index of the time period. The value is one of: FY, H1, H2, Q1, Q2, Q3, or Q4.
start_onstringThe localized start date of the time period in YYYY-MM-DD format.
{
  "gid": "12345",
  "resource_type": "time_period",
  "display_name": "Q1 FY22",
  "end_on": "2019-09-14",
  "parent": {
    "gid": "12345",
    "resource_type": "time_period",
    "display_name": "Q1 FY22",
    "end_on": "2019-09-14",
    "period": "Q1",
    "start_on": "2019-09-13"
  },
  "period": "Q1",
  "start_on": "2019-09-13"
}