Skip to main content
Version: 1.2

TimeRange

A context representing a period of time. Any user interfaces that represent or visualize events or activity over time can be filtered or focused on a particular time period, e.g.:

  • A pricing chart
  • A trade blotter
  • A record of client contact/activity in a CRM

Example use cases:

  • User may want to view pricing/trades/customer activity for a security over a particular time period, the time range might be specified as the context for the ViewChart intent OR it might be embedded in another context (e.g. a context representing a chart to plot).
  • User filters a visualization (e.g. a pricing chart) to show a particular period, the TimeRange is broadcast and other visualizations (e.g. a heatmap of activity by instrument, or industry sector etc.) receive it and filter themselves to show data over the same range.

Notes:

  • A TimeRange may be closed (i.e. startTime and endTime are both known) or open (i.e. only one of startTime or endTime is known).
  • Ranges corresponding to dates (e.g. 2022-05-12 to 2022-05-19) should be specified using times as this prevents issues with timezone conversions and inclusive/exclusive date ranges.
  • String fields representing times are encoded according to ISO 8601-1:2019.
    • A timezone indicator should be specified, e.g. "2022-05-12T15:18:03Z" or "2022-05-12T16:18:03+01:00"
    • Times MAY be specified with millisecond precision, e.g. "2022-05-12T15:18:03.349Z"

Schema

https://github.com/finos/FDC3/tree/main/schemas/context/timerange.schema.json

Type

fdc3.timerange

Properties

startTime

The start time of the range, encoded according to ISO 8601-1:2019 with a timezone indicator.

Type: string

Example Value: 2022-03-30T15:44:44Z

Example Value: 2022-03-30T15:44:44+00:00

Example Value:

endTime

The end time of the range, encoded according to ISO 8601-1:2019 with a timezone indicator.

Type: string

Example Value: 2022-04-30T23:59:59ZS

Example Value:

Example Value: 2022-03-30T16:44:44.123Z

Examples

{
"type": "fdc3.timeRange",
"startTime": "2022-03-30T15:44:44Z",
"endTime": "2022-04-30T23:59:59ZS"
}
{
"type": "fdc3.timeRange",
"startTime": "2022-03-30T15:44:44+00:00"
}
{
"type": "fdc3.timeRange",
"endTime": "2022-03-30T16:44:44.123Z"
}