blob: 79e2427da0eed984aae019de23f48471aa5eba72 [file] [log] [blame]
// Protocol Buffers - Google's data interchange format
// Copyright 2008 Google Inc. All rights reserved.
// https://developers.google.com/protocol-buffers/
//
// Redistribution and use in source and binary forms, with or without
// modification, are permitted provided that the following conditions are
// met:
//
// * Redistributions of source code must retain the above copyright
// notice, this list of conditions and the following disclaimer.
// * Redistributions in binary form must reproduce the above
// copyright notice, this list of conditions and the following disclaimer
// in the documentation and/or other materials provided with the
// distribution.
// * Neither the name of Google Inc. nor the names of its
// contributors may be used to endorse or promote products derived from
// this software without specific prior written permission.
//
// THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS
// "AS IS" AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT
// LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR
// A PARTICULAR PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT
// OWNER OR CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL,
// SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT
// LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE,
// DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY
// THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT
// (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE
// OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
#include <google/protobuf/util/time_util.h>
#include <cstdint>
#include <ctime>
#include <google/protobuf/duration.pb.h>
#include <google/protobuf/timestamp.pb.h>
#include <google/protobuf/testing/googletest.h>
#include <gtest/gtest.h>
namespace google {
namespace protobuf {
namespace util {
using google::protobuf::Duration;
using google::protobuf::Timestamp;
namespace {
TEST(TimeUtilTest, TimestampStringFormat) {
Timestamp begin, end;
EXPECT_TRUE(TimeUtil::FromString("0001-01-01T00:00:00Z", &begin));
EXPECT_EQ(TimeUtil::kTimestampMinSeconds, begin.seconds());
EXPECT_EQ(0, begin.nanos());
EXPECT_TRUE(TimeUtil::FromString("9999-12-31T23:59:59.999999999Z", &end));
EXPECT_EQ(TimeUtil::kTimestampMaxSeconds, end.seconds());
EXPECT_EQ(999999999, end.nanos());
EXPECT_EQ("0001-01-01T00:00:00Z", TimeUtil::ToString(begin));
EXPECT_EQ("9999-12-31T23:59:59.999999999Z", TimeUtil::ToString(end));
// Test negative timestamps.
Timestamp time = TimeUtil::NanosecondsToTimestamp(-1);
EXPECT_EQ(-1, time.seconds());
// Timestamp's nano part is always non-negative.
EXPECT_EQ(999999999, time.nanos());
EXPECT_EQ("1969-12-31T23:59:59.999999999Z", TimeUtil::ToString(time));
// Generated output should contain 3, 6, or 9 fractional digits.
EXPECT_EQ("1970-01-01T00:00:00Z",
TimeUtil::ToString(TimeUtil::NanosecondsToTimestamp(0)));
EXPECT_EQ("1970-01-01T00:00:00.010Z",
TimeUtil::ToString(TimeUtil::NanosecondsToTimestamp(10000000)));
EXPECT_EQ("1970-01-01T00:00:00.000010Z",
TimeUtil::ToString(TimeUtil::NanosecondsToTimestamp(10000)));
EXPECT_EQ("1970-01-01T00:00:00.000000010Z",
TimeUtil::ToString(TimeUtil::NanosecondsToTimestamp(10)));
// Parsing accepts an fractional digits as long as they fit into nano
// precision.
EXPECT_TRUE(TimeUtil::FromString("1970-01-01T00:00:00.1Z", &time));
EXPECT_EQ(100000000, TimeUtil::TimestampToNanoseconds(time));
EXPECT_TRUE(TimeUtil::FromString("1970-01-01T00:00:00.0001Z", &time));
EXPECT_EQ(100000, TimeUtil::TimestampToNanoseconds(time));
EXPECT_TRUE(TimeUtil::FromString("1970-01-01T00:00:00.0000001Z", &time));
EXPECT_EQ(100, TimeUtil::TimestampToNanoseconds(time));
// Also accepts offsets.
EXPECT_TRUE(TimeUtil::FromString("1970-01-01T00:00:00-08:00", &time));
EXPECT_EQ(8 * 3600, TimeUtil::TimestampToSeconds(time));
}
TEST(TimeUtilTest, DurationStringFormat) {
Timestamp begin, end;
EXPECT_TRUE(TimeUtil::FromString("0001-01-01T00:00:00Z", &begin));
EXPECT_TRUE(TimeUtil::FromString("9999-12-31T23:59:59.999999999Z", &end));
EXPECT_EQ("315537897599.999999999s", TimeUtil::ToString(end - begin));
EXPECT_EQ(999999999, (end - begin).nanos());
EXPECT_EQ("-315537897599.999999999s", TimeUtil::ToString(begin - end));
EXPECT_EQ(-999999999, (begin - end).nanos());
// Generated output should contain 3, 6, or 9 fractional digits.
EXPECT_EQ("1s", TimeUtil::ToString(TimeUtil::SecondsToDuration(1)));
EXPECT_EQ("0.010s", TimeUtil::ToString(TimeUtil::MillisecondsToDuration(10)));
EXPECT_EQ("0.000010s",
TimeUtil::ToString(TimeUtil::MicrosecondsToDuration(10)));
EXPECT_EQ("0.000000010s",
TimeUtil::ToString(TimeUtil::NanosecondsToDuration(10)));
// Parsing accepts an fractional digits as long as they fit into nano
// precision.
Duration d;
EXPECT_TRUE(TimeUtil::FromString("0.1s", &d));
EXPECT_EQ(100, TimeUtil::DurationToMilliseconds(d));
EXPECT_TRUE(TimeUtil::FromString("0.0001s", &d));
EXPECT_EQ(100, TimeUtil::DurationToMicroseconds(d));
EXPECT_TRUE(TimeUtil::FromString("0.0000001s", &d));
EXPECT_EQ(100, TimeUtil::DurationToNanoseconds(d));
// Duration must support range from -315,576,000,000s to +315576000000s
// which includes negative values.
EXPECT_TRUE(TimeUtil::FromString("315576000000.999999999s", &d));
EXPECT_EQ(int64_t{315576000000}, d.seconds());
EXPECT_EQ(999999999, d.nanos());
EXPECT_TRUE(TimeUtil::FromString("-315576000000.999999999s", &d));
EXPECT_EQ(int64_t{-315576000000}, d.seconds());
EXPECT_EQ(-999999999, d.nanos());
}
TEST(TimeUtilTest, GetEpoch) {
EXPECT_EQ(0, TimeUtil::TimestampToNanoseconds(TimeUtil::GetEpoch()));
}
TEST(TimeUtilTest, DurationIntegerConversion) {
EXPECT_EQ("0.000000001s",
TimeUtil::ToString(TimeUtil::NanosecondsToDuration(1)));
EXPECT_EQ("-0.000000001s",
TimeUtil::ToString(TimeUtil::NanosecondsToDuration(-1)));
EXPECT_EQ("0.000001s",
TimeUtil::ToString(TimeUtil::MicrosecondsToDuration(1)));
EXPECT_EQ("-0.000001s",
TimeUtil::ToString(TimeUtil::MicrosecondsToDuration(-1)));
EXPECT_EQ("0.001s", TimeUtil::ToString(TimeUtil::MillisecondsToDuration(1)));
EXPECT_EQ("-0.001s",
TimeUtil::ToString(TimeUtil::MillisecondsToDuration(-1)));
EXPECT_EQ("1s", TimeUtil::ToString(TimeUtil::SecondsToDuration(1)));
EXPECT_EQ("-1s", TimeUtil::ToString(TimeUtil::SecondsToDuration(-1)));
EXPECT_EQ("60s", TimeUtil::ToString(TimeUtil::MinutesToDuration(1)));
EXPECT_EQ("-60s", TimeUtil::ToString(TimeUtil::MinutesToDuration(-1)));
EXPECT_EQ("3600s", TimeUtil::ToString(TimeUtil::HoursToDuration(1)));
EXPECT_EQ("-3600s", TimeUtil::ToString(TimeUtil::HoursToDuration(-1)));
EXPECT_EQ(
1, TimeUtil::DurationToNanoseconds(TimeUtil::NanosecondsToDuration(1)));
EXPECT_EQ(
-1, TimeUtil::DurationToNanoseconds(TimeUtil::NanosecondsToDuration(-1)));
EXPECT_EQ(
1, TimeUtil::DurationToMicroseconds(TimeUtil::MicrosecondsToDuration(1)));
EXPECT_EQ(-1, TimeUtil::DurationToMicroseconds(
TimeUtil::MicrosecondsToDuration(-1)));
EXPECT_EQ(
1, TimeUtil::DurationToMilliseconds(TimeUtil::MillisecondsToDuration(1)));
EXPECT_EQ(-1, TimeUtil::DurationToMilliseconds(
TimeUtil::MillisecondsToDuration(-1)));
EXPECT_EQ(1, TimeUtil::DurationToSeconds(TimeUtil::SecondsToDuration(1)));
EXPECT_EQ(-1, TimeUtil::DurationToSeconds(TimeUtil::SecondsToDuration(-1)));
EXPECT_EQ(1, TimeUtil::DurationToMinutes(TimeUtil::MinutesToDuration(1)));
EXPECT_EQ(-1, TimeUtil::DurationToMinutes(TimeUtil::MinutesToDuration(-1)));
EXPECT_EQ(1, TimeUtil::DurationToHours(TimeUtil::HoursToDuration(1)));
EXPECT_EQ(-1, TimeUtil::DurationToHours(TimeUtil::HoursToDuration(-1)));
// Test truncation behavior.
EXPECT_EQ(1, TimeUtil::DurationToMicroseconds(
TimeUtil::NanosecondsToDuration(1999)));
// For negative values, Duration will be rounded towards 0.
EXPECT_EQ(-1, TimeUtil::DurationToMicroseconds(
TimeUtil::NanosecondsToDuration(-1999)));
}
TEST(TestUtilTest, TimestampIntegerConversion) {
EXPECT_EQ("1970-01-01T00:00:00.000000001Z",
TimeUtil::ToString(TimeUtil::NanosecondsToTimestamp(1)));
EXPECT_EQ("1969-12-31T23:59:59.999999999Z",
TimeUtil::ToString(TimeUtil::NanosecondsToTimestamp(-1)));
EXPECT_EQ("1970-01-01T00:00:00.000001Z",
TimeUtil::ToString(TimeUtil::MicrosecondsToTimestamp(1)));
EXPECT_EQ("1969-12-31T23:59:59.999999Z",
TimeUtil::ToString(TimeUtil::MicrosecondsToTimestamp(-1)));
EXPECT_EQ("1970-01-01T00:00:00.001Z",
TimeUtil::ToString(TimeUtil::MillisecondsToTimestamp(1)));
EXPECT_EQ("1969-12-31T23:59:59.999Z",
TimeUtil::ToString(TimeUtil::MillisecondsToTimestamp(-1)));
EXPECT_EQ("1970-01-01T00:00:01Z",
TimeUtil::ToString(TimeUtil::SecondsToTimestamp(1)));
EXPECT_EQ("1969-12-31T23:59:59Z",
TimeUtil::ToString(TimeUtil::SecondsToTimestamp(-1)));
EXPECT_EQ(
1, TimeUtil::TimestampToNanoseconds(TimeUtil::NanosecondsToTimestamp(1)));
EXPECT_EQ(-1, TimeUtil::TimestampToNanoseconds(
TimeUtil::NanosecondsToTimestamp(-1)));
EXPECT_EQ(1, TimeUtil::TimestampToMicroseconds(
TimeUtil::MicrosecondsToTimestamp(1)));
EXPECT_EQ(-1, TimeUtil::TimestampToMicroseconds(
TimeUtil::MicrosecondsToTimestamp(-1)));
EXPECT_EQ(1, TimeUtil::TimestampToMilliseconds(
TimeUtil::MillisecondsToTimestamp(1)));
EXPECT_EQ(-1, TimeUtil::TimestampToMilliseconds(
TimeUtil::MillisecondsToTimestamp(-1)));
EXPECT_EQ(1, TimeUtil::TimestampToSeconds(TimeUtil::SecondsToTimestamp(1)));
EXPECT_EQ(-1, TimeUtil::TimestampToSeconds(TimeUtil::SecondsToTimestamp(-1)));
// Test truncation behavior.
EXPECT_EQ(1, TimeUtil::TimestampToMicroseconds(
TimeUtil::NanosecondsToTimestamp(1999)));
// For negative values, Timestamp will be rounded down.
// For example, "1969-12-31T23:59:59.5Z" (i.e., -0.5s) rounded to seconds
// will be "1969-12-31T23:59:59Z" (i.e., -1s) rather than
// "1970-01-01T00:00:00Z" (i.e., 0s).
EXPECT_EQ(-2, TimeUtil::TimestampToMicroseconds(
TimeUtil::NanosecondsToTimestamp(-1999)));
}
TEST(TimeUtilTest, TimeTConversion) {
time_t value = time(nullptr);
EXPECT_EQ(value,
TimeUtil::TimestampToTimeT(TimeUtil::TimeTToTimestamp(value)));
EXPECT_EQ(
1, TimeUtil::TimestampToTimeT(TimeUtil::MillisecondsToTimestamp(1999)));
}
TEST(TimeUtilTest, TimevalConversion) {
timeval value = TimeUtil::TimestampToTimeval(
TimeUtil::NanosecondsToTimestamp(1999999999));
EXPECT_EQ(1, value.tv_sec);
EXPECT_EQ(999999, value.tv_usec);
value = TimeUtil::TimestampToTimeval(
TimeUtil::NanosecondsToTimestamp(-1999999999));
EXPECT_EQ(-2, value.tv_sec);
EXPECT_EQ(0, value.tv_usec);
value =
TimeUtil::DurationToTimeval(TimeUtil::NanosecondsToDuration(1999999999));
EXPECT_EQ(1, value.tv_sec);
EXPECT_EQ(999999, value.tv_usec);
value =
TimeUtil::DurationToTimeval(TimeUtil::NanosecondsToDuration(-1999999999));
EXPECT_EQ(-2, value.tv_sec);
EXPECT_EQ(1, value.tv_usec);
}
TEST(TimeUtilTest, DurationOperators) {
Duration one_second = TimeUtil::SecondsToDuration(1);
Duration one_nano = TimeUtil::NanosecondsToDuration(1);
// Test +/-
Duration a = one_second;
a += one_second;
a -= one_nano;
EXPECT_EQ("1.999999999s", TimeUtil::ToString(a));
Duration b = -a;
EXPECT_EQ("-1.999999999s", TimeUtil::ToString(b));
EXPECT_EQ("3.999999998s", TimeUtil::ToString(a + a));
EXPECT_EQ("0s", TimeUtil::ToString(a + b));
EXPECT_EQ("0s", TimeUtil::ToString(b + a));
EXPECT_EQ("-3.999999998s", TimeUtil::ToString(b + b));
EXPECT_EQ("3.999999998s", TimeUtil::ToString(a - b));
EXPECT_EQ("0s", TimeUtil::ToString(a - a));
EXPECT_EQ("0s", TimeUtil::ToString(b - b));
EXPECT_EQ("-3.999999998s", TimeUtil::ToString(b - a));
// Test *
EXPECT_EQ(a + a, a * 2);
EXPECT_EQ(b + b, a * (-2));
EXPECT_EQ(b + b, b * 2);
EXPECT_EQ(a + a, b * (-2));
EXPECT_EQ("0.999999999s", TimeUtil::ToString(a * 0.5));
EXPECT_EQ("-0.999999999s", TimeUtil::ToString(b * 0.5));
// Multiplication should not overflow if the result fits into the supported
// range of Duration (intermediate result may be larger than int64).
EXPECT_EQ("315575999684.424s", TimeUtil::ToString((one_second - one_nano) *
int64_t{315576000000}));
EXPECT_EQ("-315575999684.424s", TimeUtil::ToString((one_nano - one_second) *
int64_t{315576000000}));
EXPECT_EQ("-315575999684.424s", TimeUtil::ToString((one_second - one_nano) *
(int64_t{-315576000000})));
// Test / and %
EXPECT_EQ("0.999999999s", TimeUtil::ToString(a / 2));
EXPECT_EQ("-0.999999999s", TimeUtil::ToString(b / 2));
Duration large =
TimeUtil::SecondsToDuration(int64_t{315576000000}) - one_nano;
// We have to handle division with values beyond 64 bits.
EXPECT_EQ("0.999999999s", TimeUtil::ToString(large / int64_t{315576000000}));
EXPECT_EQ("-0.999999999s",
TimeUtil::ToString((-large) / int64_t{315576000000}));
EXPECT_EQ("-0.999999999s",
TimeUtil::ToString(large / (int64_t{-315576000000})));
Duration large2 = large + one_nano;
EXPECT_EQ(large, large % large2);
EXPECT_EQ(-large, (-large) % large2);
EXPECT_EQ(large, large % (-large2));
EXPECT_EQ(one_nano, large2 % large);
EXPECT_EQ(-one_nano, (-large2) % large);
EXPECT_EQ(one_nano, large2 % (-large));
// Some corner cases about negative values.
//
// (-5) / 2 = -2, remainder = -1
// (-5) / (-2) = 2, remainder = -1
a = TimeUtil::NanosecondsToDuration(-5);
EXPECT_EQ(TimeUtil::NanosecondsToDuration(-2), a / 2);
EXPECT_EQ(TimeUtil::NanosecondsToDuration(2), a / (-2));
b = TimeUtil::NanosecondsToDuration(2);
EXPECT_EQ(-2, a / b);
EXPECT_EQ(TimeUtil::NanosecondsToDuration(-1), a % b);
EXPECT_EQ(2, a / (-b));
EXPECT_EQ(TimeUtil::NanosecondsToDuration(-1), a % (-b));
// Test relational operators.
EXPECT_TRUE(one_nano < one_second);
EXPECT_FALSE(one_second < one_second);
EXPECT_FALSE(one_second < one_nano);
EXPECT_FALSE(-one_nano < -one_second);
EXPECT_FALSE(-one_second < -one_second);
EXPECT_TRUE(-one_second < -one_nano);
EXPECT_TRUE(-one_nano < one_nano);
EXPECT_FALSE(one_nano < -one_nano);
EXPECT_FALSE(one_nano > one_second);
EXPECT_FALSE(one_nano > one_nano);
EXPECT_TRUE(one_second > one_nano);
EXPECT_FALSE(one_nano >= one_second);
EXPECT_TRUE(one_nano >= one_nano);
EXPECT_TRUE(one_second >= one_nano);
EXPECT_TRUE(one_nano <= one_second);
EXPECT_TRUE(one_nano <= one_nano);
EXPECT_FALSE(one_second <= one_nano);
EXPECT_TRUE(one_nano == one_nano);
EXPECT_FALSE(one_nano == one_second);
EXPECT_FALSE(one_nano != one_nano);
EXPECT_TRUE(one_nano != one_second);
}
TEST(TimeUtilTest, TimestampOperators) {
Timestamp begin, end;
EXPECT_TRUE(TimeUtil::FromString("0001-01-01T00:00:00Z", &begin));
EXPECT_TRUE(TimeUtil::FromString("9999-12-31T23:59:59.999999999Z", &end));
Duration d = end - begin;
EXPECT_TRUE(end == begin + d);
EXPECT_TRUE(end == d + begin);
EXPECT_TRUE(begin == end - d);
// Test relational operators
Timestamp t1 = begin + d / 4;
Timestamp t2 = end - d / 4;
EXPECT_TRUE(t1 < t2);
EXPECT_FALSE(t1 < t1);
EXPECT_FALSE(t2 < t1);
EXPECT_FALSE(t1 > t2);
EXPECT_FALSE(t1 > t1);
EXPECT_TRUE(t2 > t1);
EXPECT_FALSE(t1 >= t2);
EXPECT_TRUE(t1 >= t1);
EXPECT_TRUE(t2 >= t1);
EXPECT_TRUE(t1 <= t2);
EXPECT_TRUE(t1 <= t1);
EXPECT_FALSE(t2 <= t1);
EXPECT_FALSE(t1 == t2);
EXPECT_TRUE(t1 == t1);
EXPECT_FALSE(t2 == t1);
EXPECT_TRUE(t1 != t2);
EXPECT_FALSE(t1 != t1);
EXPECT_TRUE(t2 != t1);
}
} // namespace
} // namespace util
} // namespace protobuf
} // namespace google