com.github.javafaker

Class DateAndTime

java.lang.Object

com.github.javafaker.DateAndTime

public class DateAndTime
extends Object

A generator of random dates.

Author:

pmiklos

Method Summary

Methods

Modifier and Type	Method and Description
Date	between(Date from, Date to) Generates a random date between two dates.
Date	future(int atMost, TimeUnit unit) Generates a future date from now.
Date	future(int atMost, TimeUnit unit, Date referenceDate) Generates a future date relative to the referenceDate.
Date	past(int atMost, TimeUnit unit) Generates a past date from now.
Date	past(int atMost, TimeUnit unit, Date referenceDate) Generates a past date relative to the referenceDate.

Methods inherited from class java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Method Detail

future

public Date future(int atMost,
          TimeUnit unit)

Generates a future date from now. Note that there is a 1 second slack to avoid generating a past date.

Parameters:

atMost - at most this amount of time ahead from now exclusive.

unit - the time unit.

Returns:

a future date from now.

future

public Date future(int atMost,
          TimeUnit unit,
          Date referenceDate)

Generates a future date relative to the referenceDate.

Parameters:

atMost - at most this amount of time ahead to the referenceDate exclusive.

unit - the time unit.

referenceDate - the future date relative to this date.

Returns:

a future date relative to referenceDate.

past

public Date past(int atMost,
        TimeUnit unit)

Generates a past date from now. Note that there is a 1 second slack added.

Parameters:

atMost - at most this amount of time earlier from now exclusive.

unit - the time unit.

Returns:

a past date from now.

past

public Date past(int atMost,
        TimeUnit unit,
        Date referenceDate)

Generates a past date relative to the referenceDate.

Parameters:

atMost - at most this amount of time past to the referenceDate exclusive.

unit - the time unit.

referenceDate - the past date relative to this date.

Returns:

a past date relative to referenceDate.

between

public Date between(Date from,
           Date to)
             throws IllegalArgumentException

Generates a random date between two dates.

Parameters:

from - the lower bound inclusive

to - the upper bound exclusive

Returns:

a random date between from and to.

Throws:

IllegalArgumentException - if the to date represents an earlier date than from date.