How to use org.dashbuilder.dataset.date

public TimeInstant cloneInstance() {
  TimeInstant clone = new TimeInstant();
  clone.timeMode = timeMode;
  clone.intervalType = intervalType;
  clone.firstMonthOfYear = firstMonthOfYear;
  if (timeAmount != null) clone.timeAmount = timeAmount.cloneInstance();
  return clone;
}

public Date getTimeInstant() {
  Date _start = calculateStartTime();
  if (timeAmount != null) timeAmount.adjustDate(_start);
  return _start;
}

  public TimeFrameLimits(TimeFrame timeFrame) {
    from = timeFrame.getFrom().getTimeInstant();
    to = timeFrame.getTo().getTimeInstant();
  }
}

@Test
public void testPastSecondsLastMinute() throws Exception {
  TimeFrame timeFrame = TimeFrame.parse("begin[minute] -10second");
  Date start = timeFrame.getFrom().getTimeInstant();
  Date end = timeFrame.getTo().getTimeInstant();
  assertEquals(formatDate(start), "2015-11-10 12:49:50");
  assertEquals(formatDate(end), "2015-11-10 12:50:30");
}

/**
 * @return index of month from 1 (JANUARY) to 12 (DECEMBER)
 */
public int getIndex() {
  return ordinal() + 1;
}

/**
 * @return index from 1 (SUNDAY) to 7 (SATURDAY)
 */
public int getIndex() {
  return ordinal() + 1;
}

@Test
public void testTillEndOfYear() throws Exception {
  TimeFrame timeFrame = TimeFrame.parse("now till end[year january]");
  Date start = timeFrame.getFrom().getTimeInstant();
  Date end = timeFrame.getTo().getTimeInstant();
  assertEquals(formatDate(start), "2015-11-10 12:50:30");
  assertEquals(formatDate(end), "2016-01-01 00:00:00");
}

public TimeInstant cloneInstance() {
  TimeInstant clone = new TimeInstant();
  clone.timeMode = timeMode;
  clone.intervalType = intervalType;
  clone.firstMonthOfYear = firstMonthOfYear;
  if (timeAmount != null) clone.timeAmount = timeAmount.cloneInstance();
  return clone;
}

public Date getTimeInstant() {
  Date _start = calculateStartTime();
  if (timeAmount != null) timeAmount.adjustDate(_start);
  return _start;
}

/**
 * @return index of month from 1 (JANUARY) to 12 (DECEMBER)
 */
public int getIndex() {
  return ordinal() + 1;
}

@Test
public void testNextYear() throws Exception {
  TimeFrame timeFrame = TimeFrame.parse("end[year March] till 1year");
  Date start = timeFrame.getFrom().getTimeInstant();
  Date end = timeFrame.getTo().getTimeInstant();
  assertEquals(formatDate(start), "2016-03-01 00:00:00");
  assertEquals(formatDate(end), "2017-03-01 00:00:00");
}

 public enum Month {
  None, 
  January, February, March, April, May, June, 
  July, August, September, October, November, December
}

Month month = Month.January;
int num = month.ordinal(); // == 1
Month month2 = Month.values()[num]; // == January.

@Test
public void testPastYears() throws Exception {
  TimeFrame timeFrame = TimeFrame.parse("-2year");
  Date start = timeFrame.getFrom().getTimeInstant();
  Date end = timeFrame.getTo().getTimeInstant();
  assertEquals(formatDate(start), "2013-11-10 12:50:30");
  assertEquals(formatDate(end), "2015-11-10 12:50:30");
}

@Test
public void testTillEndOfYear() throws Exception {
  TimeFrame timeFrame = TimeFrame.parse("now till end[year january]");
  Date start = timeFrame.getFrom().getTimeInstant();
  Date end = timeFrame.getTo().getTimeInstant();
  assertEquals(formatDate(start), "2015-11-10 12:50:30");
  assertEquals(formatDate(end), "2016-01-01 00:00:00");
}

@Test
public void testThisYearPlusNext() throws Exception {
  TimeFrame timeFrame = TimeFrame.parse("now till end[year March] 1year");
  Date start = timeFrame.getFrom().getTimeInstant();
  Date end = timeFrame.getTo().getTimeInstant();
  assertEquals(formatDate(start), "2015-11-10 12:50:30");
  assertEquals(formatDate(end), "2017-03-01 00:00:00");
}

@Test
public void testCurrentQuarter2() throws Exception {
  TimeFrame timeFrame = TimeFrame.parse("begin[quarter march] till end[quarter march]");
  Date start = timeFrame.getFrom().getTimeInstant();
  Date end = timeFrame.getTo().getTimeInstant();
  assertEquals(formatDate(start), "2015-09-01 00:00:00");
  assertEquals(formatDate(end), "2015-12-01 00:00:00");
}

@Test
public void testFirst10Seconds() throws Exception {
  TimeFrame timeFrame = TimeFrame.parse("begin[minute] till 10second");
  Date start = timeFrame.getFrom().getTimeInstant();
  Date end = timeFrame.getTo().getTimeInstant();
  assertEquals(formatDate(start), "2015-11-10 12:50:00");
  assertEquals(formatDate(end), "2015-11-10 12:50:10");
}

@Test
public void testFutureMonths() throws Exception {
  TimeFrame timeFrame = TimeFrame.parse("60month");
  Date start = timeFrame.getFrom().getTimeInstant();
  Date end = timeFrame.getTo().getTimeInstant();
  assertEquals(formatDate(start), "2015-11-10 12:50:30");
  assertEquals(formatDate(end), "2020-11-10 12:50:30");
}

  @Test
  public void testThirdQuarterOfNextYear() throws Exception {
    TimeFrame timeFrame = TimeFrame.parse("end[year March] +2quarter till 1quarter");
    Date start = timeFrame.getFrom().getTimeInstant();
    Date end = timeFrame.getTo().getTimeInstant();
    assertEquals(formatDate(start), "2016-09-01 00:00:00");
    assertEquals(formatDate(end), "2016-12-01 00:00:00");
  }
}

@Test
public void testLastWeekOfLastYear() throws Exception {
  TimeFrame timeFrame = TimeFrame.parse("begin[year March] -7day till begin[year March]");
  Date start = timeFrame.getFrom().getTimeInstant();
  Date end = timeFrame.getTo().getTimeInstant();
  assertEquals(formatDate(start), "2015-02-22 00:00:00");
  assertEquals(formatDate(end), "2015-03-01 00:00:00");
}