time.hpp

Go to the documentation of this file.

// SPDX-License-Identifier: AGPL-3.0-only
// Copyright (c) 2026 ForestHub. All rights reserved.
// For commercial licensing, visit https://github.com/ForestHubAI/fh-sdk
 
#ifndef FORESTHUB_PLATFORM_TIME_HPP
#define FORESTHUB_PLATFORM_TIME_HPP

 
#include <ctime>
#include <string>
 
namespace foresthub {
namespace platform {

struct TimeConfig {
    const char* time_server = "pool.ntp.org";  
    long std_offset_sec = 0;                   
    int dst_offset_sec = 0;           
    unsigned long timeout_ms = 5000;  
};

class TimeInterface {
public:
    virtual ~TimeInterface() = default;

    virtual std::string SyncTime(const TimeConfig& config = {}) = 0;

    virtual unsigned long GetEpochTime() const = 0;

    virtual unsigned long GetMillis() const = 0;

    virtual void Delay(unsigned long ms) const = 0;

    virtual bool IsSynced(unsigned long min_epoch = 1767225600) const = 0;

    virtual void SetOffset(long std_offset_sec, int dst_offset_sec) = 0;

    virtual long utc_offset_sec() const = 0;

    unsigned long GetLocalEpoch() const {
        return static_cast<unsigned long>(static_cast<long>(GetEpochTime()) + utc_offset_sec());
    }

    virtual void GetLocalTime(struct tm& result) const = 0;
};
 
}  // namespace platform
}  // namespace foresthub
 
#endif  // FORESTHUB_PLATFORM_TIME_HPP