Google.Protobuf.WellKnownTypes.Duration

A Duration represents a signed, fixed-length span of time represented as a count of seconds and fractions of seconds at nanosecond resolution.

Summary

It is independent of any calendar and concepts like "day" or "month". It is related to Timestamp in that the difference between two Timestamp values is a Duration and it can be added or subtracted from a Timestamp. Range is approximately +-10,000 years.

Example 1: Compute Duration from two Timestamps in pseudo code.

Timestamp start = ...;
Timestamp end = ...;
Duration duration = ...;

duration.seconds = end.seconds - start.seconds;
duration.nanos = end.nanos - start.nanos;

if (duration.seconds < 0 && duration.nanos > 0) {
  duration.seconds += 1;
  duration.nanos -= 1000000000;
} else if (durations.seconds > 0 && duration.nanos < 0) {
  duration.seconds -= 1;
  duration.nanos += 1000000000;
}

Example 2: Compute Timestamp from Timestamp + Duration in pseudo code.

Timestamp start = ...;
Duration duration = ...;
Timestamp end = ...;

end.seconds = start.seconds + duration.seconds;
end.nanos = start.nanos + duration.nanos;

if (end.nanos < 0) {
  end.seconds -= 1;
  end.nanos += 1000000000;
} else if (end.nanos >= 1000000000) {
  end.seconds += 1;
  end.nanos -= 1000000000;
}

Example 3: Compute Duration from datetime.timedelta in Python.

td = datetime.timedelta(days=3, minutes=10)
duration = Duration()
duration.FromTimedelta(td)

Inheritance

Properties

pbr::MessageDescriptor Descriptor

pbr::MessageDescriptor pb::IMessage. Descriptor

int Nanos

pb::MessageParser< Duration > Parser

long Seconds

const long MaxSeconds = 315576000000L

const long MinSeconds = -315576000000L

const int NanosFieldNumber = 2

const int NanosecondsPerSecond = 1000000000

const int NanosecondsPerTick = 100

const int SecondsFieldNumber = 1

int CalculateSize()

Duration Clone()

 Duration()

 Duration(
  Duration other
)

override bool Equals(
  object other
)

bool Equals(
  Duration other
)

override int GetHashCode()

void MergeFrom(
  Duration other
)

void MergeFrom(
  pb::CodedInputStream input
)

string ToDiagnosticString()

override string ToString()

TimeSpan ToTimeSpan()

void WriteTo(
  pb::CodedOutputStream output
)

Duration FromTimeSpan(
  TimeSpan timeSpan
)

Duration operator+(
  Duration lhs,
  Duration rhs
)

Duration operator-(
  Duration value
)

Duration operator-(
  Duration lhs,
  Duration rhs
)