
The %f specified extends the string(TIMESTAMP) and file(TIMESTAMP) commands to output the timestamp with a microsecond resolution. This convention is offered by python's datetime module. Before, the precision was limited to seconds. The implementation is done by extending existing cmTimestamp methods with a `microseconds` parameter. This parameter is optional in order to be backwards compatible. The timestamps are now received in a cross-platform manner using libuv, since the standard C functions like time() don't allow for sub-second precision. This requires libuv 1.28 or higher. We already require higher than that on Windows, so update the required version for other platforms. Implements: #19335
38 lines
1.2 KiB
C++
38 lines
1.2 KiB
C++
/* Distributed under the OSI-approved BSD 3-Clause License. See accompanying
|
|
file Copyright.txt or https://cmake.org/licensing for details. */
|
|
#pragma once
|
|
|
|
#include "cmConfigure.h" // IWYU pragma: keep
|
|
|
|
#include <cstdint>
|
|
#include <ctime>
|
|
#include <string>
|
|
|
|
/** \class cmTimestamp
|
|
* \brief Utility class to generate string representation of a timestamp
|
|
*
|
|
*/
|
|
class cmTimestamp
|
|
{
|
|
public:
|
|
std::string CurrentTime(const std::string& formatString, bool utcFlag) const;
|
|
|
|
std::string FileModificationTime(const char* path,
|
|
const std::string& formatString,
|
|
bool utcFlag) const;
|
|
|
|
std::string CreateTimestampFromTimeT(time_t timeT, std::string formatString,
|
|
bool utcFlag) const;
|
|
|
|
std::string CreateTimestampFromTimeT(time_t timeT, uint32_t microseconds,
|
|
std::string formatString,
|
|
bool utcFlag) const;
|
|
|
|
private:
|
|
time_t CreateUtcTimeTFromTm(struct tm& timeStruct) const;
|
|
|
|
std::string AddTimestampComponent(char flag, struct tm& timeStruct,
|
|
time_t timeT,
|
|
uint32_t microseconds = 0) const;
|
|
};
|