Time value processing

Detailed Description

String time formats
This is used to process the respective time formats in text fields.

Function Documentation

TimeStringToSeconds()

static long TimeStringToSeconds ( const std::string & timeString )

inlinestatic

Converts a time string to the respective integer value.

Parameters

[in]

timeString

String with time. Following types are possible: "MM min" (integer number with "min" on end) "HH:MM:SS"

Returns

Time in seconds

---

Example:

#include <kodi/tools/StringUtils.h>
 
EXPECT_EQ(77455, kodi::tools::StringUtils::TimeStringToSeconds("21:30:55"));
EXPECT_EQ(7*60, kodi::tools::StringUtils::TimeStringToSeconds("7 min"));
EXPECT_EQ(7*60, kodi::tools::StringUtils::TimeStringToSeconds("7 min\t"));
EXPECT_EQ(154*60, kodi::tools::StringUtils::TimeStringToSeconds("   154 min"));
EXPECT_EQ(1*60+1, kodi::tools::StringUtils::TimeStringToSeconds("1:01"));
EXPECT_EQ(4*60+3, kodi::tools::StringUtils::TimeStringToSeconds("4:03"));
EXPECT_EQ(2*3600+4*60+3, kodi::tools::StringUtils::TimeStringToSeconds("2:04:03"));
EXPECT_EQ(2*3600+4*60+3, kodi::tools::StringUtils::TimeStringToSeconds("   2:4:3"));
EXPECT_EQ(2*3600+4*60+3, kodi::tools::StringUtils::TimeStringToSeconds("  \t\t 02:04:03 \n "));
EXPECT_EQ(1*3600+5*60+2, kodi::tools::StringUtils::TimeStringToSeconds("01:05:02:04:03 \n "));
EXPECT_EQ(0, kodi::tools::StringUtils::TimeStringToSeconds("blah"));
EXPECT_EQ(0, kodi::tools::StringUtils::TimeStringToSeconds("ля-ля"));

SecondsToTimeString()

static std::string SecondsToTimeString ( long seconds, TIME_FORMAT format = TIME_FORMAT_GUESS )

inlinestatic

Convert a time in seconds to a string based on the given time format.

Parameters

[in]	seconds	time in seconds
[in]	format	[opt] The format we want the time in

Returns

The formatted time

See also

TIME_FORMAT

---

Example:

#include <kodi/tools/StringUtils.h>
 
std::string ref, var;
 
ref = "21:30:55";
var = kodi::tools::StringUtils::SecondsToTimeString(77455);
EXPECT_STREQ(ref.c_str(), var.c_str());

DateStringToYYYYMMDD()

static int DateStringToYYYYMMDD ( const std::string & dateString )

inlinestatic

Converts a string in the format YYYYMMDD to the corresponding integer value.

Parameters

[in]

dateString

The date in the associated format, possible values are: DD (for days only) MM-DD (for days with month) YYYY-MM-DD (for years, then month and last days)

Returns

Corresponding integer, e.g. "2020-12-24" return as integer value 20201224

---

Example:

#include <kodi/tools/StringUtils.h>
 
int ref, var;
 
ref = 20120706;
var = kodi::tools::StringUtils::DateStringToYYYYMMDD("2012-07-06");
EXPECT_EQ(ref, var);