Add new str_util::HumanReadableElapsedTime that formats a 'double seconds' value

using appropriate units based on the magnitude of the time interval, and add
tests for this.
Change: 132365945

1 files changed, 9 insertions, 0 deletions

diff --git a/tensorflow/core/lib/strings/str_util.h b/tensorflow/core/lib/strings/str_util.h
index 4a519425d4..8198b7c541 100644
--- a/tensorflow/core/lib/strings/str_util.h
+++ b/tensorflow/core/lib/strings/str_util.h
@@ -80,6 +80,15 @@ string Uppercase(StringPiece s);
 // set of characters that can be used as word boundaries.
 void TitlecaseString(string* s, StringPiece delimiters);
 
+// Converts a time interval as double to a human readable
+// string. For example:
+//   0.001       -> "1 ms"
+//   10.0        -> "10 s"
+//   933120.0    -> "10.8 days"
+//   39420000.0  -> "1.25 years"
+//   -10         -> "-10 s"
+string HumanReadableElapsedTime(double seconds);
+
 // Join functionality
 template <typename T>
 string Join(const T& s, const char* sep);