Reference documentation and code samples for the Cloud Monitoring V3 API class Google::Cloud::Monitoring::V3::TimeInterval.
Describes a time interval:
Reads: A half-open time interval. It includes the end time but
excludes the start time: (startTime, endTime]. The start time
must be specified, must be earlier than the end time, and should be
no older than the data retention period for the metric.
Writes: A closed time interval. It extends from the start time to the end
time,
and includes both: [startTime, endTime]. Valid time intervals
depend on the
MetricKind
of the metric value. The end time must not be earlier than the start
time, and the end time must not be more than 25 hours in the past or more
than five minutes in the future.
For GAUGE metrics, the startTime value is technically optional; if
no value is specified, the start time defaults to the value of the
end time, and the interval represents a single point in time. If both
start and end times are specified, they must be identical. Such an
interval is valid only for GAUGE metrics, which are point-in-time
measurements. The end time of a new interval must be at least a
millisecond after the end time of the previous interval.
For DELTA metrics, the start time and end time must specify a
non-zero interval, with subsequent points specifying contiguous and
non-overlapping intervals. For DELTA metrics, the start time of
the next interval must be at least a millisecond after the end time
of the previous interval.
For CUMULATIVE metrics, the start time and end time must specify a
non-zero interval, with subsequent points specifying the same
start time and increasing end times, until an event resets the
cumulative value to zero and sets a new start time for the following
points. The new start time must be at least a millisecond after the
end time of the previous interval.
The start time of a new interval must be at least a millisecond after
the
end time of the previous interval because intervals are closed. If the
start time of a new interval is the same as the end time of the
previous interval, then data written at the new start time could
overwrite data written at the previous end time.
(::Google::Protobuf::Timestamp) — Optional. The beginning of the time interval. The default value
for the start time is the end time. The start time must not be
later than the end time.
value (::Google::Protobuf::Timestamp) — Optional. The beginning of the time interval. The default value
for the start time is the end time. The start time must not be
later than the end time.
Returns
(::Google::Protobuf::Timestamp) — Optional. The beginning of the time interval. The default value
for the start time is the end time. The start time must not be
later than the end time.
[[["Easy to understand","easyToUnderstand","thumb-up"],["Solved my problem","solvedMyProblem","thumb-up"],["Other","otherUp","thumb-up"]],[["Hard to understand","hardToUnderstand","thumb-down"],["Incorrect information or sample code","incorrectInformationOrSampleCode","thumb-down"],["Missing the information/samples I need","missingTheInformationSamplesINeed","thumb-down"],["Other","otherDown","thumb-down"]],["Last updated 2025-09-04 UTC."],[],[],null,["# Cloud Monitoring V3 API - Class Google::Cloud::Monitoring::V3::TimeInterval (v1.6.1)\n\nVersion latestkeyboard_arrow_down\n\n- [1.6.1 (latest)](/ruby/docs/reference/google-cloud-monitoring-v3/latest/Google-Cloud-Monitoring-V3-TimeInterval)\n- [1.6.0](/ruby/docs/reference/google-cloud-monitoring-v3/1.6.0/Google-Cloud-Monitoring-V3-TimeInterval)\n- [1.5.1](/ruby/docs/reference/google-cloud-monitoring-v3/1.5.1/Google-Cloud-Monitoring-V3-TimeInterval)\n- [1.4.0](/ruby/docs/reference/google-cloud-monitoring-v3/1.4.0/Google-Cloud-Monitoring-V3-TimeInterval)\n- [1.3.0](/ruby/docs/reference/google-cloud-monitoring-v3/1.3.0/Google-Cloud-Monitoring-V3-TimeInterval)\n- [1.2.0](/ruby/docs/reference/google-cloud-monitoring-v3/1.2.0/Google-Cloud-Monitoring-V3-TimeInterval)\n- [1.1.0](/ruby/docs/reference/google-cloud-monitoring-v3/1.1.0/Google-Cloud-Monitoring-V3-TimeInterval)\n- [1.0.1](/ruby/docs/reference/google-cloud-monitoring-v3/1.0.1/Google-Cloud-Monitoring-V3-TimeInterval)\n- [0.18.0](/ruby/docs/reference/google-cloud-monitoring-v3/0.18.0/Google-Cloud-Monitoring-V3-TimeInterval)\n- [0.17.0](/ruby/docs/reference/google-cloud-monitoring-v3/0.17.0/Google-Cloud-Monitoring-V3-TimeInterval)\n- [0.16.0](/ruby/docs/reference/google-cloud-monitoring-v3/0.16.0/Google-Cloud-Monitoring-V3-TimeInterval)\n- [0.15.2](/ruby/docs/reference/google-cloud-monitoring-v3/0.15.2/Google-Cloud-Monitoring-V3-TimeInterval)\n- [0.14.0](/ruby/docs/reference/google-cloud-monitoring-v3/0.14.0/Google-Cloud-Monitoring-V3-TimeInterval)\n- [0.13.0](/ruby/docs/reference/google-cloud-monitoring-v3/0.13.0/Google-Cloud-Monitoring-V3-TimeInterval)\n- [0.12.1](/ruby/docs/reference/google-cloud-monitoring-v3/0.12.1/Google-Cloud-Monitoring-V3-TimeInterval)\n- [0.11.0](/ruby/docs/reference/google-cloud-monitoring-v3/0.11.0/Google-Cloud-Monitoring-V3-TimeInterval)\n- [0.10.0](/ruby/docs/reference/google-cloud-monitoring-v3/0.10.0/Google-Cloud-Monitoring-V3-TimeInterval)\n- [0.9.0](/ruby/docs/reference/google-cloud-monitoring-v3/0.9.0/Google-Cloud-Monitoring-V3-TimeInterval)\n- [0.8.0](/ruby/docs/reference/google-cloud-monitoring-v3/0.8.0/Google-Cloud-Monitoring-V3-TimeInterval)\n- [0.7.1](/ruby/docs/reference/google-cloud-monitoring-v3/0.7.1/Google-Cloud-Monitoring-V3-TimeInterval) \nReference documentation and code samples for the Cloud Monitoring V3 API class Google::Cloud::Monitoring::V3::TimeInterval.\n\nDescribes a time interval:\n\n- Reads: A half-open time interval. It includes the end time but excludes the start time: `(startTime, endTime]`. The start time must be specified, must be earlier than the end time, and should be no older than the data retention period for the metric.\n- Writes: A closed time interval. It extends from the start time to the end time, and includes both: `[startTime, endTime]`. Valid time intervals depend on the [`MetricKind`](https://cloud.google.com/monitoring/api/ref_v3/rest/v3/projects.metricDescriptors#MetricKind) of the metric value. The end time must not be earlier than the start time, and the end time must not be more than 25 hours in the past or more than five minutes in the future.\n - For `GAUGE` metrics, the `startTime` value is technically optional; if no value is specified, the start time defaults to the value of the end time, and the interval represents a single point in time. If both start and end times are specified, they must be identical. Such an interval is valid only for `GAUGE` metrics, which are point-in-time measurements. The end time of a new interval must be at least a millisecond after the end time of the previous interval.\n - For `DELTA` metrics, the start time and end time must specify a non-zero interval, with subsequent points specifying contiguous and non-overlapping intervals. For `DELTA` metrics, the start time of the next interval must be at least a millisecond after the end time of the previous interval.\n - For `CUMULATIVE` metrics, the start time and end time must specify a non-zero interval, with subsequent points specifying the same start time and increasing end times, until an event resets the cumulative value to zero and sets a new start time for the following points. The new start time must be at least a millisecond after the end time of the previous interval.\n- The start time of a new interval must be at least a millisecond after the end time of the previous interval because intervals are closed. If the start time of a new interval is the same as the end time of the previous interval, then data written at the new start time could overwrite data written at the previous end time. \n\nInherits\n--------\n\n- Object \n\nExtended By\n-----------\n\n- Google::Protobuf::MessageExts::ClassMethods \n\nIncludes\n--------\n\n- Google::Protobuf::MessageExts\n\nMethods\n-------\n\n### #end_time\n\n def end_time() -\u003e ::Google::Protobuf::Timestamp\n\n**Returns**\n\n- ([::Google::Protobuf::Timestamp](./Google-Protobuf-Timestamp)) --- Required. The end of the time interval.\n\n### #end_time=\n\n def end_time=(value) -\u003e ::Google::Protobuf::Timestamp\n\n**Parameter**\n\n- **value** ([::Google::Protobuf::Timestamp](./Google-Protobuf-Timestamp)) --- Required. The end of the time interval. \n**Returns**\n\n- ([::Google::Protobuf::Timestamp](./Google-Protobuf-Timestamp)) --- Required. The end of the time interval.\n\n### #start_time\n\n def start_time() -\u003e ::Google::Protobuf::Timestamp\n\n**Returns**\n\n- ([::Google::Protobuf::Timestamp](./Google-Protobuf-Timestamp)) --- Optional. The beginning of the time interval. The default value for the start time is the end time. The start time must not be later than the end time.\n\n### #start_time=\n\n def start_time=(value) -\u003e ::Google::Protobuf::Timestamp\n\n**Parameter**\n\n- **value** ([::Google::Protobuf::Timestamp](./Google-Protobuf-Timestamp)) --- Optional. The beginning of the time interval. The default value for the start time is the end time. The start time must not be later than the end time. \n**Returns**\n\n- ([::Google::Protobuf::Timestamp](./Google-Protobuf-Timestamp)) --- Optional. The beginning of the time interval. The default value for the start time is the end time. The start time must not be later than the end time."]]
