Class TimeInterval.Builder (3.56.0)

public static final class TimeInterval.Builder extends GeneratedMessageV3.Builder<TimeInterval.Builder> implements TimeIntervalOrBuilder

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.

Protobuf type google.monitoring.v3.TimeInterval

Static Methods

getDescriptor()

public static final Descriptors.Descriptor getDescriptor()
Returns
Type Description
Descriptor

Methods

addRepeatedField(Descriptors.FieldDescriptor field, Object value)

public TimeInterval.Builder addRepeatedField(Descriptors.FieldDescriptor field, Object value)
Parameters
Name Description
field FieldDescriptor
value Object
Returns
Type Description
TimeInterval.Builder
Overrides

build()

public TimeInterval build()
Returns
Type Description
TimeInterval

buildPartial()

public TimeInterval buildPartial()
Returns
Type Description
TimeInterval

clear()

public TimeInterval.Builder clear()
Returns
Type Description
TimeInterval.Builder
Overrides

clearEndTime()

public TimeInterval.Builder clearEndTime()

Required. The end of the time interval.

.google.protobuf.Timestamp end_time = 2;

Returns
Type Description
TimeInterval.Builder

clearField(Descriptors.FieldDescriptor field)

public TimeInterval.Builder clearField(Descriptors.FieldDescriptor field)
Parameter
Name Description
field FieldDescriptor
Returns
Type Description
TimeInterval.Builder
Overrides

clearOneof(Descriptors.OneofDescriptor oneof)

public TimeInterval.Builder clearOneof(Descriptors.OneofDescriptor oneof)
Parameter
Name Description
oneof OneofDescriptor
Returns
Type Description
TimeInterval.Builder
Overrides

clearStartTime()

public TimeInterval.Builder clearStartTime()

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.

.google.protobuf.Timestamp start_time = 1;

Returns
Type Description
TimeInterval.Builder

clone()

public TimeInterval.Builder clone()
Returns
Type Description
TimeInterval.Builder
Overrides

getDefaultInstanceForType()

public TimeInterval getDefaultInstanceForType()
Returns
Type Description
TimeInterval

getDescriptorForType()

public Descriptors.Descriptor getDescriptorForType()
Returns
Type Description
Descriptor
Overrides

getEndTime()

public Timestamp getEndTime()

Required. The end of the time interval.

.google.protobuf.Timestamp end_time = 2;

Returns
Type Description
Timestamp

The endTime.

getEndTimeBuilder()

public Timestamp.Builder getEndTimeBuilder()

Required. The end of the time interval.

.google.protobuf.Timestamp end_time = 2;

Returns
Type Description
Builder

getEndTimeOrBuilder()

public TimestampOrBuilder getEndTimeOrBuilder()

Required. The end of the time interval.

.google.protobuf.Timestamp end_time = 2;

Returns
Type Description
TimestampOrBuilder

getStartTime()

public Timestamp getStartTime()

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.

.google.protobuf.Timestamp start_time = 1;

Returns
Type Description
Timestamp

The startTime.

getStartTimeBuilder()

public Timestamp.Builder getStartTimeBuilder()

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.

.google.protobuf.Timestamp start_time = 1;

Returns
Type Description
Builder

getStartTimeOrBuilder()

public TimestampOrBuilder getStartTimeOrBuilder()

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.

.google.protobuf.Timestamp start_time = 1;

Returns
Type Description
TimestampOrBuilder

hasEndTime()

public boolean hasEndTime()

Required. The end of the time interval.

.google.protobuf.Timestamp end_time = 2;

Returns
Type Description
boolean

Whether the endTime field is set.

hasStartTime()

public boolean hasStartTime()

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.

.google.protobuf.Timestamp start_time = 1;

Returns
Type Description
boolean

Whether the startTime field is set.

internalGetFieldAccessorTable()

protected GeneratedMessageV3.FieldAccessorTable internalGetFieldAccessorTable()
Returns
Type Description
FieldAccessorTable
Overrides

isInitialized()

public final boolean isInitialized()
Returns
Type Description
boolean
Overrides

mergeEndTime(Timestamp value)

public TimeInterval.Builder mergeEndTime(Timestamp value)

Required. The end of the time interval.

.google.protobuf.Timestamp end_time = 2;

Parameter
Name Description
value Timestamp
Returns
Type Description
TimeInterval.Builder

mergeFrom(TimeInterval other)

public TimeInterval.Builder mergeFrom(TimeInterval other)
Parameter
Name Description
other TimeInterval
Returns
Type Description
TimeInterval.Builder

mergeFrom(CodedInputStream input, ExtensionRegistryLite extensionRegistry)

public TimeInterval.Builder mergeFrom(CodedInputStream input, ExtensionRegistryLite extensionRegistry)
Parameters
Name Description
input CodedInputStream
extensionRegistry ExtensionRegistryLite
Returns
Type Description
TimeInterval.Builder
Overrides
Exceptions
Type Description
IOException

mergeFrom(Message other)

public TimeInterval.Builder mergeFrom(Message other)
Parameter
Name Description
other Message
Returns
Type Description
TimeInterval.Builder
Overrides

mergeStartTime(Timestamp value)

public TimeInterval.Builder mergeStartTime(Timestamp value)

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.

.google.protobuf.Timestamp start_time = 1;

Parameter
Name Description
value Timestamp
Returns
Type Description
TimeInterval.Builder

mergeUnknownFields(UnknownFieldSet unknownFields)

public final TimeInterval.Builder mergeUnknownFields(UnknownFieldSet unknownFields)
Parameter
Name Description
unknownFields UnknownFieldSet
Returns
Type Description
TimeInterval.Builder
Overrides

setEndTime(Timestamp value)

public TimeInterval.Builder setEndTime(Timestamp value)

Required. The end of the time interval.

.google.protobuf.Timestamp end_time = 2;

Parameter
Name Description
value Timestamp
Returns
Type Description
TimeInterval.Builder

setEndTime(Timestamp.Builder builderForValue)

public TimeInterval.Builder setEndTime(Timestamp.Builder builderForValue)

Required. The end of the time interval.

.google.protobuf.Timestamp end_time = 2;

Parameter
Name Description
builderForValue Builder
Returns
Type Description
TimeInterval.Builder

setField(Descriptors.FieldDescriptor field, Object value)

public TimeInterval.Builder setField(Descriptors.FieldDescriptor field, Object value)
Parameters
Name Description
field FieldDescriptor
value Object
Returns
Type Description
TimeInterval.Builder
Overrides

setRepeatedField(Descriptors.FieldDescriptor field, int index, Object value)

public TimeInterval.Builder setRepeatedField(Descriptors.FieldDescriptor field, int index, Object value)
Parameters
Name Description
field FieldDescriptor
index int
value Object
Returns
Type Description
TimeInterval.Builder
Overrides

setStartTime(Timestamp value)

public TimeInterval.Builder setStartTime(Timestamp value)

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.

.google.protobuf.Timestamp start_time = 1;

Parameter
Name Description
value Timestamp
Returns
Type Description
TimeInterval.Builder

setStartTime(Timestamp.Builder builderForValue)

public TimeInterval.Builder setStartTime(Timestamp.Builder builderForValue)

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.

.google.protobuf.Timestamp start_time = 1;

Parameter
Name Description
builderForValue Builder
Returns
Type Description
TimeInterval.Builder

setUnknownFields(UnknownFieldSet unknownFields)

public final TimeInterval.Builder setUnknownFields(UnknownFieldSet unknownFields)
Parameter
Name Description
unknownFields UnknownFieldSet
Returns
Type Description
TimeInterval.Builder
Overrides