1 files changed, 85 insertions, 0 deletions
diff --git a/kamon-core/src/main/scala/kamon/util/Timestamp.scala b/kamon-core/src/main/scala/kamon/util/Timestamp.scala
new file mode 100644
index 00000000..4ff031a6
--- /dev/null
+++ b/kamon-core/src/main/scala/kamon/util/Timestamp.scala
@@ -0,0 +1,85 @@
+package kamon.util
+
+/**
+ *  Epoch time stamp.
+ */
+class Timestamp(val seconds: Long) extends AnyVal {
+  def <(that: Timestamp): Boolean = this.seconds < that.seconds
+  def >(that: Timestamp): Boolean = this.seconds > that.seconds
+  def ==(that: Timestamp): Boolean = this.seconds == that.seconds
+  def >=(that: Timestamp): Boolean = this.seconds >= that.seconds
+  def <=(that: Timestamp): Boolean = this.seconds <= that.seconds
+
+  override def toString: String = String.valueOf(seconds) + ".seconds"
+}
+
+object Timestamp {
+  def now: Timestamp = new Timestamp(System.currentTimeMillis() / 1000)
+  def earlier(l: Timestamp, r: Timestamp): Timestamp = if (l <= r) l else r
+  def later(l: Timestamp, r: Timestamp): Timestamp = if (l >= r) l else r
+}
+
+/**
+ *  Epoch time stamp in milliseconds.
+ */
+class MilliTimestamp(val millis: Long) extends AnyVal {
+  override def toString: String = String.valueOf(millis) + ".millis"
+
+  def toTimestamp: Timestamp = new Timestamp(millis / 1000)
+  def toRelativeNanoTimestamp: RelativeNanoTimestamp = {
+    val diff = (System.currentTimeMillis() - millis) * 1000000
+    new RelativeNanoTimestamp(System.nanoTime() - diff)
+  }
+}
+
+object MilliTimestamp {
+  def now: MilliTimestamp = new MilliTimestamp(System.currentTimeMillis())
+}
+
+/**
+ *  Epoch time stamp in nanoseconds.
+ *
+ *  NOTE: This doesn't have any better precision than MilliTimestamp, it is just a convenient way to get a epoch
+ *  timestamp in nanoseconds.
+ */
+class NanoTimestamp(val nanos: Long) extends AnyVal {
+  override def toString: String = String.valueOf(nanos) + ".nanos"
+}
+
+object NanoTimestamp {
+  def now: NanoTimestamp = new NanoTimestamp(System.currentTimeMillis() * 1000000)
+}
+
+/**
+ *  Number of nanoseconds between a arbitrary origin timestamp provided by the JVM via System.nanoTime()
+ */
+class RelativeNanoTimestamp(val nanos: Long) extends AnyVal {
+  override def toString: String = String.valueOf(nanos) + ".nanos"
+
+  def toMilliTimestamp: MilliTimestamp =
+    new MilliTimestamp(System.currentTimeMillis - ((System.nanoTime - nanos) / 1000000))
+}
+
+object RelativeNanoTimestamp {
+  def now: RelativeNanoTimestamp = new RelativeNanoTimestamp(System.nanoTime())
+  def relativeTo(milliTimestamp: MilliTimestamp): RelativeNanoTimestamp =
+    new RelativeNanoTimestamp(now.nanos - (MilliTimestamp.now.millis - milliTimestamp.millis) * 1000000)
+}
+
+/**
+ *  Number of nanoseconds that passed between two points in time.
+ */
+class NanoInterval(val nanos: Long) extends AnyVal {
+  def <(that: NanoInterval): Boolean = this.nanos < that.nanos
+  def >(that: NanoInterval): Boolean = this.nanos > that.nanos
+  def ==(that: NanoInterval): Boolean = this.nanos == that.nanos
+  def >=(that: NanoInterval): Boolean = this.nanos >= that.nanos
+  def <=(that: NanoInterval): Boolean = this.nanos <= that.nanos
+
+  override def toString: String = String.valueOf(nanos) + ".nanos"
+}
+
+object NanoInterval {
+  def default: NanoInterval = new NanoInterval(0L)
+  def since(relative: RelativeNanoTimestamp): NanoInterval = new NanoInterval(System.nanoTime() - relative.nanos)
+}