src/iceberg/test/transform_util_test.cc

/*
 * Licensed to the Apache Software Foundation (ASF) under one
 * or more contributor license agreements.  See the NOTICE file
 * distributed with this work for additional information
 * regarding copyright ownership.  The ASF licenses this file
 * to you under the Apache License, Version 2.0 (the
 * "License"); you may not use this file except in compliance
 * with the License.  You may obtain a copy of the License at
 *
 *   http://www.apache.org/licenses/LICENSE-2.0
 *
 * Unless required by applicable law or agreed to in writing,
 * software distributed under the License is distributed on an
 * "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
 * KIND, either express or implied.  See the License for the
 * specific language governing permissions and limitations
 * under the License.
 */

#include "iceberg/util/transform_util.h"

#include <gtest/gtest.h>

namespace iceberg {

TEST(TransformUtilTest, HumanYear) {
  EXPECT_EQ("1970", TransformUtil::HumanYear(0));
  EXPECT_EQ("1971", TransformUtil::HumanYear(1));
  EXPECT_EQ("1969", TransformUtil::HumanYear(-1));
  EXPECT_EQ("0999", TransformUtil::HumanYear(999 - 1970));
  EXPECT_EQ("2026", TransformUtil::HumanYear(56));
}

TEST(TransformUtilTest, HumanMonth) {
  // 0 is January 1970
  EXPECT_EQ("1970-01", TransformUtil::HumanMonth(0));
  // 1 is Febrary 1970
  EXPECT_EQ("1970-02", TransformUtil::HumanMonth(1));
  // -1 is December 1969
  EXPECT_EQ("1969-12", TransformUtil::HumanMonth(-1));
  // 0999-12
  EXPECT_EQ("0999-12", TransformUtil::HumanMonth(-11641));
  // 12 is January 1971
  EXPECT_EQ("1971-01", TransformUtil::HumanMonth(12));
  // 672 is December 2026-01
  EXPECT_EQ("2026-01", TransformUtil::HumanMonth(672));
}

TEST(TransformUtilTest, HumanDay) {
  // 0 is Unix epoch (1970-01-01)
  EXPECT_EQ("1970-01-01", TransformUtil::HumanDay(0));
  // 1 is 1970-01-02
  EXPECT_EQ("1970-01-02", TransformUtil::HumanDay(1));
  // -1 is 1969-12-31
  EXPECT_EQ("1969-12-31", TransformUtil::HumanDay(-1));
  // 0999-12-31
  EXPECT_EQ("0999-12-31", TransformUtil::HumanDay(-354286));
  // 365 is 1971-01-01 (non-leap year)
  EXPECT_EQ("1971-01-01", TransformUtil::HumanDay(365));
  // 20454 is 2026-01-01
  EXPECT_EQ("2026-01-01", TransformUtil::HumanDay(20454));
}

TEST(TransformUtilTest, HumanHour) {
  // 0 is Unix epoch at 00:00
  EXPECT_EQ("1970-01-01-00", TransformUtil::HumanHour(0));
  // 1 is first hour of epoch
  EXPECT_EQ("1970-01-01-01", TransformUtil::HumanHour(1));
  // -1 is previous day's last hour
  EXPECT_EQ("1969-12-31-23", TransformUtil::HumanHour(-1));
  // 999-12-31 at 23:00
  EXPECT_EQ("0999-12-31-23", TransformUtil::HumanHour(-8502841));
  // 24 is next day at 00:00
  EXPECT_EQ("1970-01-02-00", TransformUtil::HumanHour(24));
  // 490896 is 2026-01-01 at 00:00
  EXPECT_EQ("2026-01-01-00", TransformUtil::HumanHour(490896));
}

TEST(TransformUtilTest, HumanTime) {
  // Midnight
  EXPECT_EQ("00:00", TransformUtil::HumanTime(0));
  // 1 second after midnight
  EXPECT_EQ("00:00:01", TransformUtil::HumanTime(1000000));
  // 1.5 seconds after midnight
  EXPECT_EQ("00:00:01.500", TransformUtil::HumanTime(1500000));
  // 1.001 seconds after midnight
  EXPECT_EQ("00:00:01.001", TransformUtil::HumanTime(1001000));
  // 1.000001 seconds after midnight
  EXPECT_EQ("00:00:01.000001", TransformUtil::HumanTime(1000001));
  // 1 hour, 2 minutes, 3 seconds
  EXPECT_EQ("01:02:03", TransformUtil::HumanTime(3723000000));
  // 23:59:59
  EXPECT_EQ("23:59:59", TransformUtil::HumanTime(86399000000));
}

TEST(TransformUtilTest, HumanTimestamp) {
  // Unix epoch
  EXPECT_EQ("1970-01-01T00:00:00", TransformUtil::HumanTimestamp(0));
  // 1 second after epoch
  EXPECT_EQ("1970-01-01T00:00:01", TransformUtil::HumanTimestamp(1000000));
  // 1 second before epoch
  EXPECT_EQ("1969-12-31T23:59:59", TransformUtil::HumanTimestamp(-1000000));
  // 0999-12-31T23:59:59
  EXPECT_EQ("0999-12-31T23:59:59", TransformUtil::HumanTimestamp(-30610224001000000L));
  // precistion with 500 milliseconds
  EXPECT_EQ("2026-01-01T00:00:01.500", TransformUtil::HumanTimestamp(1767225601500000L));
  // precision with 1 millisecond
  EXPECT_EQ("2026-01-01T00:00:01.001", TransformUtil::HumanTimestamp(1767225601001000L));
  // precision with 1 microsecond
  EXPECT_EQ("2026-01-01T00:00:01.000001",
            TransformUtil::HumanTimestamp(1767225601000001L));
  // pre-epoch timestamp with fractional microseconds
  EXPECT_EQ("1969-12-31T23:59:59.123456", TransformUtil::HumanTimestamp(-876544));
}

TEST(TransformUtilTest, HumanTimestampWithZone) {
  // Unix epoch
  EXPECT_EQ("1970-01-01T00:00:00+00:00", TransformUtil::HumanTimestampWithZone(0));
  // 1 second after epoch
  EXPECT_EQ("1970-01-01T00:00:01+00:00", TransformUtil::HumanTimestampWithZone(1000000));
  // 1 second before epoch
  EXPECT_EQ("1969-12-31T23:59:59+00:00", TransformUtil::HumanTimestampWithZone(-1000000));
  // 0999-12-31T23:59:59
  EXPECT_EQ("0999-12-31T23:59:59+00:00",
            TransformUtil::HumanTimestampWithZone(-30610224001000000L));
  // precistion with 500 milliseconds
  EXPECT_EQ("2026-01-01T00:00:01.500+00:00",
            TransformUtil::HumanTimestampWithZone(1767225601500000L));
  // precision with 1 millisecond
  EXPECT_EQ("2026-01-01T00:00:01.001+00:00",
            TransformUtil::HumanTimestampWithZone(1767225601001000L));
  // precision with 1 microsecond
  EXPECT_EQ("2026-01-01T00:00:01.000001+00:00",
            TransformUtil::HumanTimestampWithZone(1767225601000001L));
  // pre-epoch timestamp with fractional microseconds
  EXPECT_EQ("1969-12-31T23:59:59.123456+00:00",
            TransformUtil::HumanTimestampWithZone(-876544));
}

TEST(TransformUtilTest, HumanTimestampNs) {
  EXPECT_EQ("1970-01-01T00:00:00.000000001", TransformUtil::HumanTimestampNs(1));
  EXPECT_EQ("2026-01-01T00:00:01.000001001",
            TransformUtil::HumanTimestampNs(1767225601000001001L));
  EXPECT_EQ("1969-12-31T23:59:59.123456789", TransformUtil::HumanTimestampNs(-876543211));
}

TEST(TransformUtilTest, HumanTimestampNsWithZone) {
  EXPECT_EQ("1970-01-01T00:00:00.000000001+00:00",
            TransformUtil::HumanTimestampNsWithZone(1));
  EXPECT_EQ("2026-01-01T00:00:01.000001001+00:00",
            TransformUtil::HumanTimestampNsWithZone(1767225601000001001L));
  EXPECT_EQ("1969-12-31T23:59:59.123456789+00:00",
            TransformUtil::HumanTimestampNsWithZone(-876543211));
}
}  // namespace iceberg