DateMatchers (Hamcrest Date 1.0.0 API)

java.lang.Object
- org.exparity.hamcrest.date.DateMatchers

```
public abstract class DateMatchers
extends Object
```
Static factory for creating Matcher instances for comparing dates

Author:

Stewart Bissett

Constructor Summary

Constructors
Constructor and Description

DateMatchers()

Constructors
Constructor and Description
`DateMatchers()`

Method Summary

Methods
Modifier and Type	Method and Description
`static org.hamcrest.Matcher<Date>`	`after(Date date)` Creates a matcher that matches when the examined date is after the reference date For example:
`static org.hamcrest.Matcher<Date>`	`after(DayMonthYear date)` Creates a matcher that matches when the examined date is after the reference date For example:
`static org.hamcrest.Matcher<Date>`	`after(int year, Months month, int day)` Creates a matcher that matches when the examined date is after the end of the reference year For example:
`static org.hamcrest.Matcher<Date>`	`after(int year, Months month, int date, int hour, int minute, int second)` Creates a matcher that matches when the examined date is after the end of the reference year For example:
`static org.hamcrest.Matcher<Date>`	`before(Date date)` Creates a matcher that matches when the examined date is before the reference date For example:
`static org.hamcrest.Matcher<Date>`	`before(DayMonthYear date)` Creates a matcher that matches when the examined date is before the reference date For example:
`static org.hamcrest.Matcher<Date>`	`before(int year, Months month, int day)` Creates a matcher that matches when the examined date is before the start of reference day For example:
`static org.hamcrest.Matcher<Date>`	`before(int year, Months month, int date, int hour, int minute, int second)` Creates a matcher that matches when the examined date is before the start of the reference date and time For example:
`static org.hamcrest.Matcher<Date>`	`isApril()` Creates a matcher that matches when the examined date is in April For example:
`static org.hamcrest.Matcher<Date>`	`isAugust()` Creates a matcher that matches when the examined date is in August For example:
`static org.hamcrest.Matcher<Date>`	`isDecember()` Creates a matcher that matches when the examined date is in December For example:
`static org.hamcrest.Matcher<Date>`	`isFebruary()` Creates a matcher that matches when the examined date is in February For example:
`static org.hamcrest.Matcher<Date>`	`isFirstDayOfMonth()` Creates a matcher that matches when the examined date is on the first day of the month For example:
`static org.hamcrest.Matcher<Date>`	`isFriday()` Creates a matcher that matches when the examined date is on a friday For example:
`static org.hamcrest.Matcher<Date>`	`isJanuary()` Creates a matcher that matches when the examined date is in January For example:
`static org.hamcrest.Matcher<Date>`	`isJuly()` Creates a matcher that matches when the examined date is in July For example:
`static org.hamcrest.Matcher<Date>`	`isJune()` Creates a matcher that matches when the examined date is in June For example:
`static org.hamcrest.Matcher<Date>`	`isLastDayOfMonth()` Creates a matcher that matches when the examined date is on the first day of the month For example:
`static org.hamcrest.Matcher<Date>`	`isLeapYear()` Creates a matcher that matches when the examined date is a leap year For example:
`static org.hamcrest.Matcher<Date>`	`isMarch()` Creates a matcher that matches when the examined date is in March For example:
`static org.hamcrest.Matcher<Date>`	`isMay()` Creates a matcher that matches when the examined date is in May For example:
`static org.hamcrest.Matcher<Date>`	`isMonday()` Creates a matcher that matches when the examined date is on a monday For example:
`static org.hamcrest.Matcher<Date>`	`isNovember()` Creates a matcher that matches when the examined date is in November For example:
`static org.hamcrest.Matcher<Date>`	`isOctober()` Creates a matcher that matches when the examined date is in October For example:
`static org.hamcrest.Matcher<Date>`	`isSaturday()` Creates a matcher that matches when the examined date is on a saturday For example:
`static org.hamcrest.Matcher<Date>`	`isSeptember()` Creates a matcher that matches when the examined date is in September For example:
`static org.hamcrest.Matcher<Date>`	`isSunday()` Creates a matcher that matches when the examined date is on a sunday For example:
`static org.hamcrest.Matcher<Date>`	`isThursday()` Creates a matcher that matches when the examined date is on a thursday For example:
`static org.hamcrest.Matcher<Date>`	`isToday()` Creates a matcher that matches when the examined date is today For example:
`static org.hamcrest.Matcher<Date>`	`isTomorrow()` Creates a matcher that matches when the examined date is tomorrow For example:
`static org.hamcrest.Matcher<Date>`	`isTuesday()` Creates a matcher that matches when the examined date is on a tuesday For example:
`static org.hamcrest.Matcher<Date>`	`isWednesday()` Creates a matcher that matches when the examined date is on a wednesday For example:
`static org.hamcrest.Matcher<Date>`	`isWeekday()` Creates a matcher that matches when the examined date is on a weekday For example:
`static org.hamcrest.Matcher<Date>`	`isWeekend()` Creates a matcher that matches when the examined date is on a weekend For example:
`static org.hamcrest.Matcher<Date>`	`isYesterday()` Creates a matcher that matches when the examined date is yesterday For example:
`static org.hamcrest.Matcher<Date>`	`sameDay(Date date)` Creates a matcher that matches when the examined date is on the same day of the year as the reference date For example:
`static org.hamcrest.Matcher<Date>`	`sameDay(DayMonthYear date)` Creates a matcher that matches when the examined date is on the same day of the year as the reference date For example:
`static org.hamcrest.Matcher<Date>`	`sameDay(int year, Months month, int day)` Creates a matcher that matches when the examined date is on the same day of the year as the reference date For example:
`static org.hamcrest.Matcher<Date>`	`sameDayOfWeek(Date date)` Creates a matcher that matches when the examined date is on the same day of the week as the reference date For example:
`static org.hamcrest.Matcher<Date>`	`sameDayOfWeek(Weekdays weekday)` Creates a matcher that matches when the examined date is on the same day of the week as the supplied day For example:
`static org.hamcrest.Matcher<Date>`	`sameHour(Date date)` Creates a matcher that matches when the examined date is on the same hour as the reference date For example:
`static org.hamcrest.Matcher<Date>`	`sameHour(int hour)` Creates a matcher that matches when the examined date is on the same hour as the reference date For example:
`static org.hamcrest.Matcher<Date>`	`sameInstant(Date date)` Creates a matcher that matches when the examined date is on the same instant as the reference date For example:
`static org.hamcrest.Matcher<Date>`	`sameInstant(int year, Months month, int date, int hour, int minute, int second, int milliseconds)` Creates a matcher that matches when the examined date is on the same instance as the reference date For example:
`static org.hamcrest.Matcher<Date>`	`sameInstant(long timestamp)` Creates a matcher that matches when the examined date is on the same UTC instant as the reference UTC epoch time supplied For example:
`static org.hamcrest.Matcher<Date>`	`sameMillisecond(Date date)` Creates a matcher that matches when the examined date is on the same millisecond as the reference date For example:
`static org.hamcrest.Matcher<Date>`	`sameMillisecond(int millisecond)` Creates a matcher that matches when the examined date is on the reference second For example:
`static org.hamcrest.Matcher<Date>`	`sameMinute(Date date)` Creates a matcher that matches when the examined date is on the same minute as the reference date For example:
`static org.hamcrest.Matcher<Date>`	`sameMinute(int minute)` Creates a matcher that matches when the examined date is on the reference minute For example:
`static org.hamcrest.Matcher<Date>`	`sameMonth(Date date)` Creates a matcher that matches when the examined date is on the same month as the reference date For example:
`static org.hamcrest.Matcher<Date>`	`sameMonth(Months month)` Creates a matcher that matches when the examined date is on the same month as the reference month For example:
`static org.hamcrest.Matcher<Date>`	`sameOrAfter(Date date)` Creates a matcher that matches when the examined date is at the same instant or after the reference date For example:
`static org.hamcrest.Matcher<Date>`	`sameOrAfter(DayMonthYear date)` Creates a matcher that matches when the examined date is at the same instant or after the reference date For example:
`static org.hamcrest.Matcher<Date>`	`sameOrAfter(int year, Months month, int day)` Creates a matcher that matches when the examined date is on the same day or after the start of the reference date For example:
`static org.hamcrest.Matcher<Date>`	`sameOrAfter(int year, Months month, int date, int hour, int minute, int second)` Creates a matcher that matches when the examined date is on the same second or after the start of the reference date and time For example:
`static org.hamcrest.Matcher<Date>`	`sameOrBefore(Date date)` Creates a matcher that matches when the examined date is at the same instant or before the reference date For example:
`static org.hamcrest.Matcher<Date>`	`sameOrBefore(DayMonthYear date)` Creates a matcher that matches when the examined date is at the same date or before the reference date For example:
`static org.hamcrest.Matcher<Date>`	`sameOrBefore(int year, Months month, int day)` Creates a matcher that matches when the examined date is on the same day or before the start of the reference date For example:
`static org.hamcrest.Matcher<Date>`	`sameOrBefore(int year, Months month, int date, int hour, int minute, int second)` Creates a matcher that matches when the examined date is on the same second or before the start of the reference date and time For example:
`static org.hamcrest.Matcher<Date>`	`sameSecond(Date date)` Creates a matcher that matches when the examined date is on the same second as the reference date For example:
`static org.hamcrest.Matcher<Date>`	`sameSecond(int second)` Creates a matcher that matches when the examined date is on the reference second For example:
`static org.hamcrest.Matcher<Date>`	`sameWeekday(Date date)` Deprecated. See `sameDayOfWeek(Date)`
`static org.hamcrest.Matcher<Date>`	`sameWeekday(Weekdays weekday)` Deprecated. See `sameDayOfWeek(Weekdays)`
`static org.hamcrest.Matcher<Date>`	`sameYear(Date date)` Creates a matcher that matches when the examined date is on the same year as the reference date For example:
`static org.hamcrest.Matcher<Date>`	`sameYear(int year)` Creates a matcher that matches when the examined date is on the same year as the reference year For example:
`static org.hamcrest.Matcher<Date>`	`within(long period, TimeUnit unit, Date date)` Creates a matcher that matches when the examined date is within a defined period the reference date For example:
`static org.hamcrest.Matcher<Date>`	`within(long period, TimeUnit unit, DayMonthYear date)` Creates a matcher that matches when the examined date is within a defined period the reference date For example:
`static org.hamcrest.Matcher<Date>`	`within(long period, TimeUnit unit, int year, Months month, int day)` Creates a matcher that matches when the examined date is within a given period of the reference date For example:
`static org.hamcrest.Matcher<Date>`	`within(long period, TimeUnit unit, int year, Months month, int date, int hour, int minute, int second, int milliseconds)` Creates a matcher that matches when the examined date is within a given period of the reference date For example:

Methods inherited from class java.lang.Object
clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

- Constructor Detail
  - DateMatchers
```
public DateMatchers()
```
- Method Detail
  - after
```
public static org.hamcrest.Matcher<Date> after(Date date)
```
    Creates a matcher that matches when the examined date is after the reference date
    For example:
```
 assertThat(myDate, after(new Date()))
 
```
    Parameters:
    date - the reference date against which the examined date is checked
  - after
```
public static org.hamcrest.Matcher<Date> after(DayMonthYear date)
```
    Creates a matcher that matches when the examined date is after the reference date
    For example:
```
 assertThat(myDate, after(Moments.today()))
 
```
    Parameters:
    date - the reference date against which the examined date is checked
  - after
```
public static org.hamcrest.Matcher<Date> after(int year,
                               Months month,
                               int day)
```
    Creates a matcher that matches when the examined date is after the end of the reference year
    For example:
```
 assertThat(myDate, after(2012, Months.MAY, 12));
 
```
    Parameters:
    year - the year against which the examined date is checked
    month - the month against which the examined date is checked
    day - the day of the month against which the examined date is checked
  - after
```
public static org.hamcrest.Matcher<Date> after(int year,
                               Months month,
                               int date,
                               int hour,
                               int minute,
                               int second)
```
    Creates a matcher that matches when the examined date is after the end of the reference year
    For example:
```
 assertThat(myDate, after(2012, Months.MAY, 12, 23, 00, 01));
 
```
    Parameters:
    year - the year against which the examined date is checked
    month - the month against which the examined date is checked
    day - the day of the month against which the examined date is checked
    hour - the hour of the day against which the examined date is checked
    minute - the minute of the hour against which the examined date is checked
    second - the second of the minute against which the examined date is checked
  - before
```
public static org.hamcrest.Matcher<Date> before(Date date)
```
    Creates a matcher that matches when the examined date is before the reference date
    For example:
```
 assertThat(myDate, before(new Date()))
 
```
    Parameters:
    date - the reference date against which the examined date is checked
  - before
```
public static org.hamcrest.Matcher<Date> before(DayMonthYear date)
```
    Creates a matcher that matches when the examined date is before the reference date
    For example:
```
 assertThat(myDate, before(Moments.today()));
 
```
    Parameters:
    date - the reference date against which the examined date is checked
  - before
```
public static org.hamcrest.Matcher<Date> before(int year,
                                Months month,
                                int day)
```
    Creates a matcher that matches when the examined date is before the start of reference day
    For example:
```
 assertThat(myDate, before(2012, Months.MAY, 12));
 
```
    Parameters:
    year - the year against which the examined date is checked
    month - the month against which the examined date is checked
    day - the day of the month against which the examined date is checked
  - before
```
public static org.hamcrest.Matcher<Date> before(int year,
                                Months month,
                                int date,
                                int hour,
                                int minute,
                                int second)
```
    Creates a matcher that matches when the examined date is before the start of the reference date and time
    For example:
```
 assertThat(myDate, before(2012, Months.MAY, 12, 23, 00, 01));
 
```
    Parameters:
    year - the year against which the examined date is checked
    month - the month against which the examined date is checked
    day - the day of the month against which the examined date is checked
    hour - the hour of the day against which the examined date is checked
    minute - the minute of the hour against which the examined date is checked
    second - the second of the minute against which the examined date is checked
  - sameWeekday
```
@Deprecated
public static org.hamcrest.Matcher<Date> sameWeekday(Date date)
```
    Deprecated. See sameDayOfWeek(Date)
    Creates a matcher that matches when the examined date is on the same day of the week as the reference date
    For example:
```
 assertThat(myDate, sameWeekday(new Date()))
 
```
    Parameters:
    date - the reference date against which the examined date is checked
  - sameWeekday
```
@Deprecated
public static org.hamcrest.Matcher<Date> sameWeekday(Weekdays weekday)
```
    Deprecated. See sameDayOfWeek(Weekdays)
    Creates a matcher that matches when the examined date is on the same day of the week as the supplied day
    For example:
```
 assertThat(myDate, sameDayOfTheWeek(Weekdays.MONDAY))
 
```
    Parameters:
    weekday - the reference weekday against which the examined date is checked
  - sameDayOfWeek
```
public static org.hamcrest.Matcher<Date> sameDayOfWeek(Date date)
```
    Creates a matcher that matches when the examined date is on the same day of the week as the reference date
    For example:
```
 assertThat(myDate, sameWeekday(new Date()))
 
```
    Parameters:
    date - the reference date against which the examined date is checked
  - sameDayOfWeek
```
public static org.hamcrest.Matcher<Date> sameDayOfWeek(Weekdays weekday)
```
    Creates a matcher that matches when the examined date is on the same day of the week as the supplied day
    For example:
```
 assertThat(myDate, sameDayOfTheWeek(new Date()))
 
```
    Parameters:
    weekday - the reference weekday against which the examined date is checked
  - sameDay
```
public static org.hamcrest.Matcher<Date> sameDay(Date date)
```
    Creates a matcher that matches when the examined date is on the same day of the year as the reference date
    For example:
```
 assertThat(myDate, sameDay(new Date()))
 
```
    Parameters:
    date - the reference date against which the examined date is checked
  - sameDay
```
public static org.hamcrest.Matcher<Date> sameDay(DayMonthYear date)
```
    Creates a matcher that matches when the examined date is on the same day of the year as the reference date
    For example:
```
 assertThat(myDate, sameDay(Moments.today()));
 
```
    Parameters:
    date - the reference date against which the examined date is checked
  - sameDay
```
public static org.hamcrest.Matcher<Date> sameDay(int year,
                                 Months month,
                                 int day)
```
    Creates a matcher that matches when the examined date is on the same day of the year as the reference date
    For example:
```
 assertThat(myDate, sameDayOfTheYear(2012, Month.JAN, 1))
 
```
    Parameters:
    day - the reference day of the month against which the examined date is checked
    month - the reference month against which the examined date is checked
    year - the reference year against which the examined date is checked
  - sameHour
```
public static org.hamcrest.Matcher<Date> sameHour(Date date)
```
    Creates a matcher that matches when the examined date is on the same hour as the reference date
    For example:
```
 assertThat(myDate, sameHour(new Date()))
 
```
    Parameters:
    date - the reference date against which the examined date is checked
  - sameHour
```
public static org.hamcrest.Matcher<Date> sameHour(int hour)
```
    Creates a matcher that matches when the examined date is on the same hour as the reference date
    For example:
```
 assertThat(myDate, sameHour(12));
 
```
    Parameters:
    hour - the reference hour against which the examined date is checked
  - sameInstant
```
public static org.hamcrest.Matcher<Date> sameInstant(Date date)
```
    Creates a matcher that matches when the examined date is on the same instant as the reference date
    For example:
```
 assertThat(myDate, sameInstant(new Date()))
 
```
    Parameters:
    date - the reference date against which the examined date is checked
  - sameInstant
```
public static org.hamcrest.Matcher<Date> sameInstant(long timestamp)
```
    Creates a matcher that matches when the examined date is on the same UTC instant as the reference UTC epoch time supplied
    For example:
```
 assertThat(myDate, sameInstant(1325415600000L))
 
```
    Parameters:
    timestamp - the time as milliseconds since the Unix epoch time
  - sameInstant
```
public static org.hamcrest.Matcher<Date> sameInstant(int year,
                                     Months month,
                                     int date,
                                     int hour,
                                     int minute,
                                     int second,
                                     int milliseconds)
```
    Creates a matcher that matches when the examined date is on the same instance as the reference date
    For example:
```
 assertThat(myDate, sameInstant(2012, Months.MAY, 12, 23, 00, 01, 123));
 
```
    Parameters:
    year - the year against which the examined date is checked
    month - the month against which the examined date is checked
    day - the day of the month against which the examined date is checked
    hour - the hour of the day against which the examined date is checked
    minute - the minute of the hour against which the examined date is checked
    second - the second of the minute against which the examined date is checked
    milliseconds - the milliseconds of the second against which the examined date is checked
  - sameOrBefore
```
public static org.hamcrest.Matcher<Date> sameOrBefore(Date date)
```
    Creates a matcher that matches when the examined date is at the same instant or before the reference date
    For example:
```
 assertThat(myDate, isSameOrBefore(new Date()))
 
```
    Parameters:
    date - the reference date against which the examined date is checked
  - sameOrBefore
```
public static org.hamcrest.Matcher<Date> sameOrBefore(DayMonthYear date)
```
    Creates a matcher that matches when the examined date is at the same date or before the reference date
    For example:
```
 assertThat(myDate, isSameOrBefore(new Date()))
 
```
    Parameters:
    date - the reference date against which the examined date is checked
  - sameOrBefore
```
public static org.hamcrest.Matcher<Date> sameOrBefore(int year,
                                      Months month,
                                      int day)
```
    Creates a matcher that matches when the examined date is on the same day or before the start of the reference date
    For example:
```
 assertThat(myDate, isSameOrBefore(2012, Months.MAY, 12));
 
```
    Parameters:
    year - the year against which the examined date is checked
    month - the month against which the examined date is checked
    day - the day of the month against which the examined date is checked
  - sameOrBefore
```
public static org.hamcrest.Matcher<Date> sameOrBefore(int year,
                                      Months month,
                                      int date,
                                      int hour,
                                      int minute,
                                      int second)
```
    Creates a matcher that matches when the examined date is on the same second or before the start of the reference date and time
    For example:
```
 assertThat(myDate, isSameOrBefore(2012, Months.MAY, 12, 23, 00, 01));
 
```
    Parameters:
    year - the year against which the examined date is checked
    month - the month against which the examined date is checked
    day - the day of the month against which the examined date is checked
    hour - the hour of the day against which the examined date is checked
    minute - the minute of the hour against which the examined date is checked
    second - the second of the minute against which the examined date is checked
  - sameOrAfter
```
public static org.hamcrest.Matcher<Date> sameOrAfter(Date date)
```
    Creates a matcher that matches when the examined date is at the same instant or after the reference date
    For example:
```
 assertThat(myDate, isSameOrAfter(new Date()))
 
```
    Parameters:
    date - the reference date against which the examined date is checked
  - sameOrAfter
```
public static org.hamcrest.Matcher<Date> sameOrAfter(DayMonthYear date)
```
    Creates a matcher that matches when the examined date is at the same instant or after the reference date
    For example:
```
 assertThat(myDate, isSameOrAfter(Moments.today()))
 
```
    Parameters:
    date - the reference date against which the examined date is checked
  - sameOrAfter
```
public static org.hamcrest.Matcher<Date> sameOrAfter(int year,
                                     Months month,
                                     int day)
```
    Creates a matcher that matches when the examined date is on the same day or after the start of the reference date
    For example:
```
 assertThat(myDate, isSameOrAfter(2012, Months.MAY, 12));
 
```
    Parameters:
    year - the year against which the examined date is checked
    month - the month against which the examined date is checked
    day - the day of the month against which the examined date is checked
  - sameOrAfter
```
public static org.hamcrest.Matcher<Date> sameOrAfter(int year,
                                     Months month,
                                     int date,
                                     int hour,
                                     int minute,
                                     int second)
```
    Creates a matcher that matches when the examined date is on the same second or after the start of the reference date and time
    For example:
```
 assertThat(myDate, isSameOrAfter(2012, Months.MAY, 12, 23, 00, 01));
 
```
    Parameters:
    year - the year against which the examined date is checked
    month - the month against which the examined date is checked
    day - the day of the month against which the examined date is checked
    hour - the hour of the day against which the examined date is checked
    minute - the minute of the hour against which the examined date is checked
    second - the second of the minute against which the examined date is checked
  - sameMinute
```
public static org.hamcrest.Matcher<Date> sameMinute(Date date)
```
    Creates a matcher that matches when the examined date is on the same minute as the reference date
    For example:
```
 assertThat(myDate, sameMinute(new Date()))
 
```
    Parameters:
    date - the reference date against which the examined date is checked
  - sameMinute
```
public static org.hamcrest.Matcher<Date> sameMinute(int minute)
```
    Creates a matcher that matches when the examined date is on the reference minute
    For example:
```
 assertThat(myDate, sameMinute(55))
 
```
    Parameters:
    minute - the reference minute against which the examined date is checked
  - sameMonth
```
public static org.hamcrest.Matcher<Date> sameMonth(Date date)
```
    Creates a matcher that matches when the examined date is on the same month as the reference date
    For example:
```
 assertThat(myDate, sameMonth(new Date()))
 
```
    Parameters:
    date - the reference date against which the examined date is checked
  - sameMonth
```
public static org.hamcrest.Matcher<Date> sameMonth(Months month)
```
    Creates a matcher that matches when the examined date is on the same month as the reference month
    For example:
```
 assertThat(myDate, sameMonth(Months.DECEMBER))
 
```
    Parameters:
    month - the reference month against which the examined date is checked
  - sameSecond
```
public static org.hamcrest.Matcher<Date> sameSecond(Date date)
```
    Creates a matcher that matches when the examined date is on the same second as the reference date
    For example:
```
 assertThat(myDate, sameSecond(new Date()))
 
```
    Parameters:
    date - the reference date against which the examined date is checked
  - sameSecond
```
public static org.hamcrest.Matcher<Date> sameSecond(int second)
```
    Creates a matcher that matches when the examined date is on the reference second
    For example:
```
 assertThat(myDate, sameSecond(33))
 
```
    Parameters:
    second - the reference date against which the examined date is checked
  - sameMillisecond
```
public static org.hamcrest.Matcher<Date> sameMillisecond(Date date)
```
    Creates a matcher that matches when the examined date is on the same millisecond as the reference date
    For example:
```
 assertThat(myDate, sameMillisecond(new Date()))
 
```
    Parameters:
    date - the reference date against which the examined date is checked
  - sameMillisecond
```
public static org.hamcrest.Matcher<Date> sameMillisecond(int millisecond)
```
    Creates a matcher that matches when the examined date is on the reference second
    For example:
```
 assertThat(myDate, sameMillisecond(123))
 
```
    Parameters:
    millisecond - the millisecond against which the examined date is checked
  - sameYear
```
public static org.hamcrest.Matcher<Date> sameYear(Date date)
```
    Creates a matcher that matches when the examined date is on the same year as the reference date
    For example:
```
 assertThat(myDate, sameYear(new Date()))
 
```
    Parameters:
    date - the reference date against which the examined date is checked
  - sameYear
```
public static org.hamcrest.Matcher<Date> sameYear(int year)
```
    Creates a matcher that matches when the examined date is on the same year as the reference year
    For example:
```
 assertThat(myDate, sameYear(2013))
 
```
    Parameters:
    year - the reference year against which the examined date is checked
  - within
```
public static org.hamcrest.Matcher<Date> within(long period,
                                TimeUnit unit,
                                Date date)
```
    Creates a matcher that matches when the examined date is within a defined period the reference date
    For example:
```
 assertThat(myDate, within(10, TimeUnit.MINUTES, new Date()))
 
```
    Parameters:
    date - the reference date against which the examined date is checked
  - within
```
public static org.hamcrest.Matcher<Date> within(long period,
                                TimeUnit unit,
                                DayMonthYear date)
```
    Creates a matcher that matches when the examined date is within a defined period the reference date
    For example:
```
 assertThat(myDate, within(10, TimeUnit.DAYS, Moments.today()))
 
```
    Parameters:
    date - the reference date against which the examined date is checked
  - within
```
public static org.hamcrest.Matcher<Date> within(long period,
                                TimeUnit unit,
                                int year,
                                Months month,
                                int day)
```
    Creates a matcher that matches when the examined date is within a given period of the reference date
    For example:
```
 assertThat(myDate, within(5, TimeUnit.DAYS, 2012, Months.MAY, 12));
 
```
    Parameters:
    period - the timeunit interval the examined date should be with
    unit - the timeunit to define the length of the period
    year - the year against which the examined date is checked
    month - the month against which the examined date is checked
    day - the day of the month against which the examined date is checked
  - within
```
public static org.hamcrest.Matcher<Date> within(long period,
                                TimeUnit unit,
                                int year,
                                Months month,
                                int date,
                                int hour,
                                int minute,
                                int second,
                                int milliseconds)
```
    Creates a matcher that matches when the examined date is within a given period of the reference date
    For example:
```
 assertThat(myDate, within(1, TimeUnit.MINUTES, 2012, Months.MAY, 12, 23, 00, 01));
 
```
    Parameters:
    period - the timeunit interval the examined date should be with
    unit - the timeunit to define the length of the period
    year - the year against which the examined date is checked
    month - the month against which the examined date is checked
    day - the day of the month against which the examined date is checked
    hour - the hour of the day against which the examined date is checked
    minute - the minute of the hour against which the examined date is checked
    second - the second of the minute against which the examined date is checked
    second - the millisecond of the second against which the examined date is checked
  - isYesterday
```
public static org.hamcrest.Matcher<Date> isYesterday()
```
    Creates a matcher that matches when the examined date is yesterday
    For example:
```
 assertThat(myDate, isToday());
 
```
  - isToday
```
public static org.hamcrest.Matcher<Date> isToday()
```
    Creates a matcher that matches when the examined date is today
    For example:
```
 assertThat(myDate, isToday());
 
```
  - isTomorrow
```
public static org.hamcrest.Matcher<Date> isTomorrow()
```
    Creates a matcher that matches when the examined date is tomorrow
    For example:
```
 assertThat(myDate, isTomorrow());
 
```
  - isMonday
```
public static org.hamcrest.Matcher<Date> isMonday()
```
    Creates a matcher that matches when the examined date is on a monday
    For example:
```
 assertThat(myDate, isMonday());
 
```
  - isTuesday
```
public static org.hamcrest.Matcher<Date> isTuesday()
```
    Creates a matcher that matches when the examined date is on a tuesday
    For example:
```
 assertThat(myDate, isTuesday());
 
```
  - isWednesday
```
public static org.hamcrest.Matcher<Date> isWednesday()
```
    Creates a matcher that matches when the examined date is on a wednesday
    For example:
```
 assertThat(myDate, isWednesday());
 
```
  - isThursday
```
public static org.hamcrest.Matcher<Date> isThursday()
```
    Creates a matcher that matches when the examined date is on a thursday
    For example:
```
 assertThat(myDate, isThursday());
 
```
  - isFriday
```
public static org.hamcrest.Matcher<Date> isFriday()
```
    Creates a matcher that matches when the examined date is on a friday
    For example:
```
 assertThat(myDate, isFriday());
 
```
  - isSaturday
```
public static org.hamcrest.Matcher<Date> isSaturday()
```
    Creates a matcher that matches when the examined date is on a saturday
    For example:
```
 assertThat(myDate, isSaturday());
 
```
  - isSunday
```
public static org.hamcrest.Matcher<Date> isSunday()
```
    Creates a matcher that matches when the examined date is on a sunday
    For example:
```
 assertThat(myDate, isSunday());
 
```
  - isWeekday
```
public static org.hamcrest.Matcher<Date> isWeekday()
```
    Creates a matcher that matches when the examined date is on a weekday
    For example:
```
 assertThat(myDate, isWeekday());
 
```
  - isWeekend
```
public static org.hamcrest.Matcher<Date> isWeekend()
```
    Creates a matcher that matches when the examined date is on a weekend
    For example:
```
 assertThat(myDate, isWeekend());
 
```
  - isFirstDayOfMonth
```
public static org.hamcrest.Matcher<Date> isFirstDayOfMonth()
```
    Creates a matcher that matches when the examined date is on the first day of the month
    For example:
```
 assertThat(myDate, isFirstDayOfMonth());
 
```
  - isLastDayOfMonth
```
public static org.hamcrest.Matcher<Date> isLastDayOfMonth()
```
    Creates a matcher that matches when the examined date is on the first day of the month
    For example:
```
 assertThat(myDate, isFirstDayOfMonth());
 
```
  - isJanuary
```
public static org.hamcrest.Matcher<Date> isJanuary()
```
    Creates a matcher that matches when the examined date is in January
    For example:
```
 assertThat(myDate, isJanuary());
 
```
  - isFebruary
```
public static org.hamcrest.Matcher<Date> isFebruary()
```
    Creates a matcher that matches when the examined date is in February
    For example:
```
 assertThat(myDate, isFebruary());
 
```
  - isMarch
```
public static org.hamcrest.Matcher<Date> isMarch()
```
    Creates a matcher that matches when the examined date is in March
    For example:
```
 assertThat(myDate, isMarch());
 
```
  - isApril
```
public static org.hamcrest.Matcher<Date> isApril()
```
    Creates a matcher that matches when the examined date is in April
    For example:
```
 assertThat(myDate, isApril());
 
```
  - isMay
```
public static org.hamcrest.Matcher<Date> isMay()
```
    Creates a matcher that matches when the examined date is in May
    For example:
```
 assertThat(myDate, isMay());
 
```
  - isJune
```
public static org.hamcrest.Matcher<Date> isJune()
```
    Creates a matcher that matches when the examined date is in June
    For example:
```
 assertThat(myDate, isJune());
 
```
  - isJuly
```
public static org.hamcrest.Matcher<Date> isJuly()
```
    Creates a matcher that matches when the examined date is in July
    For example:
```
 assertThat(myDate, isJuly());
 
```
  - isAugust
```
public static org.hamcrest.Matcher<Date> isAugust()
```
    Creates a matcher that matches when the examined date is in August
    For example:
```
 assertThat(myDate, isAugust());
 
```
  - isSeptember
```
public static org.hamcrest.Matcher<Date> isSeptember()
```
    Creates a matcher that matches when the examined date is in September
    For example:
```
 assertThat(myDate, isSeptember());
 
```
  - isOctober
```
public static org.hamcrest.Matcher<Date> isOctober()
```
    Creates a matcher that matches when the examined date is in October
    For example:
```
 assertThat(myDate, isOctober());
 
```
  - isNovember
```
public static org.hamcrest.Matcher<Date> isNovember()
```
    Creates a matcher that matches when the examined date is in November
    For example:
```
 assertThat(myDate, isNovember());
 
```
  - isDecember
```
public static org.hamcrest.Matcher<Date> isDecember()
```
    Creates a matcher that matches when the examined date is in December
    For example:
```
 assertThat(myDate, isDecember());
 
```
  - isLeapYear
```
public static org.hamcrest.Matcher<Date> isLeapYear()
```
    Creates a matcher that matches when the examined date is a leap year
    For example:
```
 assertThat(myDate, isLeapYear());
 
```

Class DateMatchers

Constructor Summary

Method Summary

Methods inherited from class java.lang.Object

Constructor Detail

DateMatchers

Method Detail

after

after

after

after

before

before

before

before

sameWeekday

sameWeekday

sameDayOfWeek

sameDayOfWeek

sameDay

sameDay

sameDay

sameHour

sameHour

sameInstant

sameInstant

sameInstant

sameOrBefore

sameOrBefore

sameOrBefore

sameOrBefore

sameOrAfter

sameOrAfter

sameOrAfter

sameOrAfter

sameMinute

sameMinute

sameMonth

sameMonth

sameSecond

sameSecond

sameMillisecond

sameMillisecond

sameYear

sameYear

within

within

within

within

isYesterday

isToday

isTomorrow

isMonday

isTuesday

isWednesday

isThursday

isFriday

isSaturday

isSunday

isWeekday

isWeekend

isFirstDayOfMonth

isLastDayOfMonth

isJanuary

isFebruary

isMarch

isApril

isMay

isJune

isJuly

isAugust

isSeptember

isOctober

isNovember

isDecember

isLeapYear