Class TimeSpec

java.lang.Object
org.rrd4j.core.timespec.TimeSpec

public class TimeSpec
extends Object
Simple class to represent time obtained by parsing at-style date specification (described in detail on the rrdfetch man page. See javadoc for TimeParser for more information.
  • Field Details

  • Constructor Details

  • Method Details

    • localtime

      void localtime​(long timestamp)
    • getTime

    • getTimestamp

      public long getTimestamp()

      Returns the corresponding timestamp (seconds since Epoch). Example:

       TimeParser p = new TimeParser("now-1day");
       TimeSpec ts = p.parse();
       System.out.println("Timestamp was: " + ts.getTimestamp();
       
      Returns:
      Timestamp (in seconds, no milliseconds)
    • dump

      String dump()
    • getTimes

      public static Calendar[] getTimes​(TimeSpec spec1, TimeSpec spec2)

      Use this static method to resolve relative time references and obtain the corresponding Calendar objects. Example:

       TimeParser pStart = new TimeParser("now-1month"); // starting time
       TimeParser pEnd = new TimeParser("start+1week");  // ending time
       TimeSpec specStart = pStart.parse();
       TimeSpec specEnd = pEnd.parse();
       GregorianCalendar[] gc = TimeSpec.getTimes(specStart, specEnd);
       
      Parameters:
      spec1 - Starting time specification
      spec2 - Ending time specification
      Returns:
      Two element array containing Calendar objects
    • getTimestamps

      public static long[] getTimestamps​(TimeSpec spec1, TimeSpec spec2)

      Use this static method to resolve relative time references and obtain the corresponding timestamps (seconds since epoch). Example:

       TimeParser pStart = new TimeParser("now-1month"); // starting time
       TimeParser pEnd = new TimeParser("start+1week");  // ending time
       TimeSpec specStart = pStart.parse();
       TimeSpec specEnd = pEnd.parse();
       long[] ts = TimeSpec.getTimestamps(specStart, specEnd);
       
      Parameters:
      spec1 - Starting time specification
      spec2 - Ending time specification
      Returns:
      array containing two timestamps (in seconds since epoch)