temporal_util.h

/*
 * 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.
 */
 
#pragma once
 
#include <chrono>
#include <cstdint>
#include <string_view>
 
#include "iceberg/iceberg_export.h"
#include "iceberg/result.h"
#include "iceberg/type_fwd.h"
 
namespace iceberg::internal {
 
inline constexpr int64_t kNanosPerMicro = 1000;
inline constexpr int64_t kMicrosPerMilli = 1000;
inline constexpr int64_t kMicrosPerSecond = 1000 * kMicrosPerMilli;
inline constexpr int64_t kSecondsPerMinute = 60;
inline constexpr int64_t kMinutesPerHour = 60;
inline constexpr int64_t kHoursPerDay = 24;
inline constexpr int64_t kSecondsPerHour = kMinutesPerHour * kSecondsPerMinute;
inline constexpr int64_t kSecondsPerDay = kHoursPerDay * kSecondsPerHour;
inline constexpr int64_t kMicrosPerDay = kSecondsPerDay * kMicrosPerSecond;
inline constexpr int64_t kNanosPerMilli = kMicrosPerMilli * kNanosPerMicro;
inline constexpr int64_t kNanosPerSecond = kMicrosPerSecond * kNanosPerMicro;
inline constexpr int64_t kNanosPerDay = kMicrosPerDay * kNanosPerMicro;
 
inline constexpr auto kEpochYmd = std::chrono::year{1970} / std::chrono::January / 1;
inline constexpr auto kEpochDays = std::chrono::sys_days{kEpochYmd};
 
}  // namespace iceberg::internal
 
namespace iceberg {
 
class ICEBERG_EXPORT TemporalUtils {
 public:
  static int64_t NanosToMicros(int64_t nanos);
 
  static Result<int64_t> MicrosToNanos(int64_t micros);
 
  static Result<int32_t> ParseDay(std::string_view str);
 
  static Result<int64_t> ParseTime(std::string_view str);
 
  static Result<int64_t> ParseTimeNs(std::string_view str);
 
  static Result<int64_t> ParseTimestamp(std::string_view str);
 
  static Result<int64_t> ParseTimestampNs(std::string_view str);
 
  static Result<int64_t> ParseTimestampWithZone(std::string_view str);
 
  static Result<int64_t> ParseTimestampNsWithZone(std::string_view str);
 
  static Result<bool> IsUtcOffset(std::string_view str);
 
  static Result<Literal> ExtractYear(const Literal& literal);
 
  static Result<Literal> ExtractMonth(const Literal& literal);
 
  static Result<Literal> ExtractDay(const Literal& literal);
 
  static Result<Literal> ExtractHour(const Literal& literal);
};
 
}  // namespace iceberg