Add ISO string conversion for time series timestamps

Introduced getTimestampAsIsoString to TimeSeries, allowing retrieval of timestamps as ISO strings with optional time component.

Author: philippeVerney

example/example.cpp

@@ -2761,9 +2761,12 @@ void showAllProperties(RESQML2_NS::AbstractRepresentation const * rep, bool* ena
 		if (prop->getTimeSeries() != nullptr || singleTs != -1) {
 			std::cout << "\tThis property is a time related one" << std::endl;
 			if (singleTs != -1) {
-				std::cout << "\tThis property is a related to single timestamp " << std::endl;
+				std::cout << "\tThis property is related to single timestamp " << std::endl;
 				if (prop->getTimeSeries() != nullptr) {
-					std::cout << "which is part of a time series at index " << prop->getTimeSeries()->getTimestampIndex(singleTs) << std::endl;
+					auto timeSeriesIndex = prop->getTimeSeries()->getTimestampIndex(singleTs);
+					std::cout << "which is part of a time series at index " << timeSeriesIndex
+						<< " ISO String (without time)" << prop->getTimeSeries()->getTimestampAsIsoString(timeSeriesIndex, false)
+						<< " ISO String (with time)" << prop->getTimeSeries()->getTimestampAsIsoString(timeSeriesIndex, true) << std::endl;
 				}
 				else {
 					std::cout << "which is not part of a time series." << std::endl;

src/eml2/TimeSeries.cpp

@@ -27,16 +27,22 @@ using namespace EML2_NS;
 
 void TimeSeries::pushBackTimestamp(time_t timestamp)
 {
-	std::tm tmConversion = timeTools::to_calendar_time(timeTools::from_time_t(timestamp));
+	const std::tm tmConversion = timeTools::to_calendar_time(timeTools::from_time_t(timestamp));
 	pushBackTimestamp(tmConversion);
 }
 
 time_t TimeSeries::getTimestamp(uint64_t index) const
 {
-	tm temp = getTimestampAsTimeStructure(index);
+	const tm temp = getTimestampAsTimeStructure(index);
 	return timeTools::timegm(temp);
 }
 
+std::string TimeSeries::getTimestampAsIsoString(uint64_t index, bool withTime) const
+{
+	const time_t temp = getTimestamp(index);
+	return timeTools::convertUnixTimestampToIso(temp, withTime);
+}
+
 std::vector<RESQML2_NS::AbstractProperty *> TimeSeries::getPropertySet() const
 {
 	return getRepository()->getSourceObjects<RESQML2_NS::AbstractProperty>(this);

src/eml2/TimeSeries.h

@@ -104,6 +104,19 @@ namespace EML2_NS
 		 */
 		DLL_IMPORT_OR_EXPORT time_t getTimestamp(uint64_t index) const;
 
+		/**
+		 * Gets a timestamp as an ISO string at a particular index of this time series.
+		 *
+		 * @exception	std::logic_error 	If the underlying gSOAP instance is not a RESQML2.0 one.
+		 * @exception	std::out_of_range	If @p index is out of range.
+		 *
+		 * @param 	index		Zero-based index of the timestamp we look for.
+		 * @param 	withTime	Include or not the time in the output.
+		 *
+		 * @returns	The timestamp as an ISO string at position @p index.
+		 */
+		DLL_IMPORT_OR_EXPORT std::string getTimestampAsIsoString(uint64_t index, bool withTime = true) const;
+
 		/**
 		 * Gets a timestamp as a time structure at a particular index of this time series. It allows to
 		 * read dates from 1900-01-01T00:00:00.

src/tools/TimeTools.cpp

@@ -45,10 +45,10 @@ std::string timeTools::convertMicrosecondUnixTimestampToIso(long long ts)
 	return oss.str();
 }
 */
-std::string timeTools::convertUnixTimestampToIso(time_t ts)
+std::string timeTools::convertUnixTimestampToIso(time_t ts, bool withTime)
 {
 	auto tmp = timeTools::from_time_t(ts);
-	return date::format("%FT%TZ", date::floor<std::chrono::seconds>(tmp));
+	return date::format(withTime ? "%FT%TZ" : "%F", date::floor<std::chrono::seconds>(tmp));
 }
 
 time_t timeTools::convertIsoToUnixTimestamp(const std::string & s)

src/tools/TimeTools.h

@@ -32,11 +32,12 @@ namespace timeTools
 	/**
 	 * Convert an Unix timestamp which is given in seconds into a date in ISO format.
 	 *
-	 * @param 	ts	The ts.
+	 * @param 	ts			The UNIX timestamp.
+	 * @param 	withTime	Include or not the time in the output.
 	 *
 	 * @returns	The unix converted timestamp to ISO.
 	 */
-	std::string convertUnixTimestampToIso(time_t ts);
+	std::string convertUnixTimestampToIso(time_t ts, bool withTime = true);
 
 	/**
 	 * Converts a UTC time (given in seconds) represented by a string to a UTC time represented by a