Skip to main content

Version: 5.8

Kotlinx Datetime Matchers

Matchers for the Kotlinx Datetime library are provided by the kotest-assertions-kotlinx-time module.

LocalDate
`date.shouldHaveSameYearAs(otherDate)`	Asserts that the date has the same year as the given date.
`date.shouldHaveSameMonthAs(otherDate)`	Asserts that the date has the same month as the given date.
`date.shouldHaveSameDayAs(otherDate)`	Asserts that the date has the same day of the month as the given date.
`date.shouldBeBefore(otherDate)`	Asserts that the date is before the given date.
`date.shouldBeAfter(otherDate)`	Asserts that the date is after the given date.
`date.shouldBeWithin(period, otherDate)`	Asserts that the date is within the period of the given date.
`date.shouldBeWithin(duration, otherDate)`	Asserts that the date is within the duration of the given date.
`date.shouldBeBetween(firstDate, secondDate)`	Asserts that the date is between firstdate and seconddate.
`date.shouldHaveYear(year)`	Asserts that the date have correct year.
`date.shouldHaveMonth(month)`	Asserts that the date have correct month.
`date.shouldHaveDayOfYear(day)`	Asserts that the date have correct day of year.
`date.shouldHaveDayOfMonth(day)`	Asserts that the date have correct day of month.
`date.shouldHaveDayOfWeek(day)`	Asserts that the date have correct day of week.
`date.shouldHaveHour(hour)`	Asserts that the date have correct hour.
`date.shouldHaveMinute(Minute)`	Asserts that the date have correct minute.
`date.shouldHaveSecond(second)`	Asserts that the date have correct second.
`date.shouldHaveNano(nano)`	Asserts that the date have correct nano second.

LocalDateTime
`time.shouldHaveSameHoursAs(otherTime)`	Asserts that the time has the same hours as the given time.
`time.shouldHaveSameMinutesAs(otherTime)`	Asserts that the time has the same minutes as the given time.
`time.shouldHaveSameSecondsAs(otherTime)`	Asserts that the time has the same seconds as the given time.
`time.shouldHaveSameNanosAs(otherTime)`	Asserts that the time has the same nanos as the given time.
`time.shouldBeBefore(otherTime)`	Asserts that the time is before the given time.
`time.shouldBeAfter(otherTime)`	Asserts that the time is after the given time.
`time.shouldBeBetween(firstTime, secondTime)`	Asserts that the time is between firstTime and secondTime.

Instant
`instant.shouldBeAfter(anotherInstant)`	Asserts that the instant is after anotherInstant
`instant.shouldBeBefore(anotherInstant)`	Asserts that the instant is before anotherInstant
`instant.shouldBeBetween(fromInstant, toInstant)`	Asserts that the instant is between fromInstant and toInstant