# <a id="bitdrift.public.unary.common.v1.TimeRange"></a>TimeRange

**Source definition:** [`src/bitdrift/public/unary/common/v1/common.proto#L79-L107`](<https://github.com/bitdriftlabs/api/blob/main/src/bitdrift/public/unary/common/v1/common.proto#L79-L107>)

<section class="proto-fields-table" markdown>
| Field | Type | Description |
|---|---|---|
| fixed_time_range | <span class="proto-type proto-type-message">[<i class="proto-type-part">bitdrift</i><i class="proto-type-dot">.</i><i class="proto-type-part">public</i><i class="proto-type-dot">.</i><i class="proto-type-part">unary</i><i class="proto-type-dot">.</i><i class="proto-type-part">common</i><i class="proto-type-dot">.</i><i class="proto-type-part">v1</i><i class="proto-type-dot">.</i><i class="proto-type-part">TimeRange</i><i class="proto-type-dot">.</i><i class="proto-type-part">FixedTimeRange</i>](#bitdrift.public.unary.common.v1.TimeRange.FixedTimeRange "bitdrift.public.unary.common.v1.TimeRange.FixedTimeRange")</span><span class="proto-field-annotation">only one of <em>fixed_time_range</em>, or <em>relative_time_range</em> can be set</span> | A fixed time range with explicit start and end times. This will ignore any look back delay  settings. |
| relative_time_range | <span class="proto-type proto-type-message">[<i class="proto-type-part">bitdrift</i><i class="proto-type-dot">.</i><i class="proto-type-part">public</i><i class="proto-type-dot">.</i><i class="proto-type-part">unary</i><i class="proto-type-dot">.</i><i class="proto-type-part">common</i><i class="proto-type-dot">.</i><i class="proto-type-part">v1</i><i class="proto-type-dot">.</i><i class="proto-type-part">TimeRange</i><i class="proto-type-dot">.</i><i class="proto-type-part">RelativeTimeRange</i>](#bitdrift.public.unary.common.v1.TimeRange.RelativeTimeRange "bitdrift.public.unary.common.v1.TimeRange.RelativeTimeRange")</span><span class="proto-field-annotation">only one of <em>relative_time_range</em>, or <em>fixed_time_range</em> can be set</span> | A relative time range, defined as a duration back from 'now', minus any look back delay.  If this is 15 minutes, and the lookback delay is 5 minutes, this represents the time range  from 20 minutes ago to 5 minutes ago. |

</section>
<p class="h4">Example</p>
```json
{
  "relative_time_range": {
    "duration": "3600s",
    "offset": "3600s"
  }
}
```

# <a id="bitdrift.public.unary.common.v1.TimeRange.FixedTimeRange"></a>TimeRange.FixedTimeRange

**Source definition:** [`src/bitdrift/public/unary/common/v1/common.proto#L80-L86`](<https://github.com/bitdriftlabs/api/blob/main/src/bitdrift/public/unary/common/v1/common.proto#L80-L86>)

<section class="proto-fields-table" markdown>
| Field | Type | Description |
|---|---|---|
| start_time | <span class="proto-type proto-type-well-known">[google.protobuf.Timestamp](https://protobuf.dev/reference/protobuf/google.protobuf/#timestamp "google.protobuf.Timestamp")</span> | The start time of the time range. |
| end_time | <span class="proto-type proto-type-well-known">[google.protobuf.Timestamp](https://protobuf.dev/reference/protobuf/google.protobuf/#timestamp "google.protobuf.Timestamp")</span> | The end time of the time range. |

</section>
<p class="h4">Example</p>
```json
{
  "end_time": "2024-01-15T09:30:00Z",
  "start_time": "2024-01-15T09:30:00Z"
}
```

# <a id="bitdrift.public.unary.common.v1.TimeRange.RelativeTimeRange"></a>TimeRange.RelativeTimeRange

**Source definition:** [`src/bitdrift/public/unary/common/v1/common.proto#L88-L94`](<https://github.com/bitdriftlabs/api/blob/main/src/bitdrift/public/unary/common/v1/common.proto#L88-L94>)

<section class="proto-fields-table" markdown>
| Field | Type | Description |
|---|---|---|
| duration | <span class="proto-type proto-type-well-known">[google.protobuf.Duration](https://protobuf.dev/reference/protobuf/google.protobuf/#duration "google.protobuf.Duration")</span> | The duration back from 'now' for the start of the time range. |
| offset | <span class="proto-type proto-type-well-known">[google.protobuf.Duration](https://protobuf.dev/reference/protobuf/google.protobuf/#duration "google.protobuf.Duration")</span> | An optional offset to apply to both the start and end times. |

</section>
<p class="h4">Example</p>
```json
{
  "duration": "3600s",
  "offset": "3600s"
}
```

