org.assertj.jodatime.api.LocalDateTimeAssert.java Source code

Java tutorial

Introduction

Here is the source code for org.assertj.jodatime.api.LocalDateTimeAssert.java

Source

/**
 * Licensed under the Apache License, Version 2.0 (the "License"); you may not use this file except in compliance with
 * the License. You may obtain a copy of the License at
 * 
 * http://www.apache.org/licenses/LICENSE-2.0
 * 
 * Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on
 * an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the
 * specific language governing permissions and limitations under the License.
 * 
 * Copyright 2012-2013 the original author or authors.
 */
package org.assertj.jodatime.api;

import static org.assertj.jodatime.error.ShouldBeAfter.shouldBeAfter;
import static org.assertj.jodatime.error.ShouldBeAfterOrEqualsTo.shouldBeAfterOrEqualsTo;
import static org.assertj.jodatime.error.ShouldBeBefore.shouldBeBefore;
import static org.assertj.jodatime.error.ShouldBeBeforeOrEqualsTo.shouldBeBeforeOrEqualsTo;
import static org.assertj.jodatime.error.ShouldBeEqualIgnoringHours.shouldBeEqualIgnoringHours;
import static org.assertj.jodatime.error.ShouldBeEqualIgnoringMillis.shouldBeEqualIgnoringMillis;
import static org.assertj.jodatime.error.ShouldBeEqualIgnoringMinutes.shouldBeEqualIgnoringMinutes;
import static org.assertj.jodatime.error.ShouldBeEqualIgnoringSeconds.shouldBeEqualIgnoringSeconds;

import org.joda.time.LocalDateTime;

import org.assertj.core.api.AbstractAssert;
import org.assertj.core.internal.Failures;
import org.assertj.core.internal.Objects;

/**
 * Assertions fot Joda {@link LocalDateTime} type.
 * 
 * @author Pawe Stawicki
 * @author Joel Costigliola
 */
public class LocalDateTimeAssert extends AbstractAssert<LocalDateTimeAssert, LocalDateTime> {

    public static final String NULL_LOCAL_DATE_TIME_PARAMETER_MESSAGE = "The LocalDateTime to compare actual with should not be null";

    /**
     * Creates a new <code>{@link org.assertj.jodatime.api.LocalDateTimeAssert}</code>.
     * 
     * @param selfType the "self type"
     * @param actual the actual value to verify
     */
    protected LocalDateTimeAssert(Class<LocalDateTimeAssert> selfType, LocalDateTime actual) {
        super(actual, selfType);
    }

    // visible for test
    protected LocalDateTime getActual() {
        return actual;
    }

    /**
     * Verifies that the actual {@code LocalDateTime} is <b>strictly</b> before the given one.
     * <p>
     * Example :
     * <pre><code class='java'> assertThat(new LocalDateTime(&quot;2000-01-01&quot;)).isBefore(new LocalDateTime(&quot;2000-01-02&quot;));</code></pre>
     * 
     * @param other the given {@link LocalDateTime}.
     * @return this assertion object.
     * @throws AssertionError if the actual {@code LocalDateTime} is {@code null}.
     * @throws IllegalArgumentException if other {@code LocalDateTime} is {@code null}.
     * @throws AssertionError if the actual {@code LocalDateTime} is not strictly before the given one.
     */
    public LocalDateTimeAssert isBefore(LocalDateTime other) {
        Objects.instance().assertNotNull(info, actual);
        assertLocalDateTimeParameterIsNotNull(other);
        if (!actual.isBefore(other)) {
            throw Failures.instance().failure(info, shouldBeBefore(actual, other));
        }
        return this;
    }

    /**
     * Same assertion as {@link #isBefore(LocalDateTime)} but the {@link LocalDateTime} is built from given String, which
     * must follow <a href=
     * "http://joda-time.sourceforge.net/api-release/org/joda/time/format/ISODateTimeFormat.html#localDateOptionalTimeParser()"
     * >ISO DateTime format</a> to allow calling {@link LocalDateTime#LocalDateTime(Object) LocalDateTime(Object)}
     * constructor.
     * <p>
     * Example :
     * <pre><code class='java'> // use directly String in comparison to avoid a conversion
     * assertThat(new LocalDateTime(&quot;2000-01-01&quot;)).isBefore(&quot;2000-01-02&quot;);</code></pre>
     * 
     * @param localDateTimeAsString String representing a {@link LocalDateTime}.
     * @return this assertion object.
     * @throws AssertionError if the actual {@code LocalDateTime} is {@code null}.
     * @throws IllegalArgumentException if given String is null or can't be converted to a {@link LocalDateTime}.
     * @throws AssertionError if the actual {@code LocalDateTime} is not strictly before the {@link LocalDateTime} built
     *           from given String.
     */
    public LocalDateTimeAssert isBefore(String localDateTimeAsString) {
        assertLocalDateTimeAsStringParameterIsNotNull(localDateTimeAsString);
        return isBefore(new LocalDateTime(localDateTimeAsString));
    }

    /**
     * Verifies that the actual {@code LocalDateTime} is before or equals to the given one.
     * <p>
     * Example :
     * <pre><code class='java'> assertThat(new LocalDateTime(&quot;2000-01-01&quot;)).isBeforeOrEqualTo(new LocalDateTime(&quot;2000-01-01&quot;))
     *                                            .isBeforeOrEqualTo(new LocalDateTime(&quot;2000-01-02&quot;));</code></pre>
     * 
     * @param other the given {@link LocalDateTime}.
     * @return this assertion object.
     * @throws AssertionError if the actual {@code LocalDateTime} is {@code null}.
     * @throws IllegalArgumentException if other {@code LocalDateTime} is {@code null}.
     * @throws AssertionError if the actual {@code LocalDateTime} is not before or equals to the given one.
     */
    public LocalDateTimeAssert isBeforeOrEqualTo(LocalDateTime other) {
        Objects.instance().assertNotNull(info, actual);
        assertLocalDateTimeParameterIsNotNull(other);
        if (actual.isAfter(other)) {
            throw Failures.instance().failure(info, shouldBeBeforeOrEqualsTo(actual, other));
        }
        return this;
    }

    /**
     * Same assertion as {@link #isBeforeOrEqualTo(LocalDateTime)} but the {@link LocalDateTime} is built from given
     * String, which must follow <a href=
     * "http://joda-time.sourceforge.net/api-release/org/joda/time/format/ISODateTimeFormat.html#localDateOptionalTimeParser()"
     * >ISO DateTime format</a> to allow calling {@link LocalDateTime#LocalDateTime(Object) LocalDateTime(Object)}
     * constructor.
     * <p>
     * Example :
     * <pre><code class='java'> // use String in comparison to avoid conversion
     * assertThat(new LocalDateTime(&quot;2000-01-01&quot;)).isBeforeOrEqualTo(&quot;2000-01-01&quot;)
     *                                            .isBeforeOrEqualTo(&quot;2000-01-02&quot;);</code></pre>
     * 
     * @param localDateTimeAsString String representing a {@link LocalDateTime}.
     * @return this assertion object.
     * @throws AssertionError if the actual {@code LocalDateTime} is {@code null}.
     * @throws IllegalArgumentException if given String is null or can't be converted to a {@link LocalDateTime}.
     * @throws AssertionError if the actual {@code LocalDateTime} is not before or equals to the {@link LocalDateTime}
     *           built from given String.
     */
    public LocalDateTimeAssert isBeforeOrEqualTo(String localDateTimeAsString) {
        assertLocalDateTimeAsStringParameterIsNotNull(localDateTimeAsString);
        return isBeforeOrEqualTo(new LocalDateTime(localDateTimeAsString));
    }

    /**
     * Verifies that the actual {@code LocalDateTime} is after or equals to the given one.
     * <p>
     * Example :
     * <pre><code class='java'> assertThat(new LocalDateTime(&quot;2000-01-01&quot;)).isAfterOrEqualTo(new LocalDateTime(&quot;2000-01-01&quot;))
     *                                            .isAfterOrEqualTo(new LocalDateTime(&quot;1999-12-31&quot;));</code></pre>
     * 
     * @param other the given {@link LocalDateTime}.
     * @return this assertion object.
     * @throws AssertionError if the actual {@code LocalDateTime} is {@code null}.
     * @throws IllegalArgumentException if other {@code LocalDateTime} is {@code null}.
     * @throws AssertionError if the actual {@code LocalDateTime} is not after or equals to the given one.
     */
    public LocalDateTimeAssert isAfterOrEqualTo(LocalDateTime other) {
        Objects.instance().assertNotNull(info, actual);
        assertLocalDateTimeParameterIsNotNull(other);
        if (actual.isBefore(other)) {
            throw Failures.instance().failure(info, shouldBeAfterOrEqualsTo(actual, other));
        }
        return this;
    }

    /**
     * Same assertion as {@link #isAfterOrEqualTo(LocalDateTime)} but the {@link LocalDateTime} is built from given
     * String, which must follow <a href=
     * "http://joda-time.sourceforge.net/api-release/org/joda/time/format/ISODateTimeFormat.html#localDateOptionalTimeParser()"
     * >ISO DateTime format</a> to allow calling {@link LocalDateTime#LocalDateTime(Object) LocalDateTime(Object)}
     * constructor.
     * <p>
     * Example :
     * <pre><code class='java'> // use String in comparison to avoid conversion
     * assertThat(new LocalDateTime(&quot;2000-01-01&quot;)).isAfterOrEqualTo(&quot;2000-01-01&quot;)
     *                                            .isAfterOrEqualTo(&quot;1999-12-31&quot;);</code></pre>
     * 
     * @param localDateTimeAsString String representing a {@link LocalDateTime}.
     * @return this assertion object.
     * @throws AssertionError if the actual {@code LocalDateTime} is {@code null}.
     * @throws IllegalArgumentException if given String is null or can't be converted to a {@link LocalDateTime}.
     * @throws AssertionError if the actual {@code LocalDateTime} is not after or equals to the {@link LocalDateTime}
     *           built from given String.
     */
    public LocalDateTimeAssert isAfterOrEqualTo(String localDateTimeAsString) {
        assertLocalDateTimeAsStringParameterIsNotNull(localDateTimeAsString);
        return isAfterOrEqualTo(new LocalDateTime(localDateTimeAsString));
    }

    /**
     * Verifies that the actual {@code LocalDateTime} is <b>strictly</b> after the given one.
     * <p>
     * Example :
     * <pre><code class='java'> assertThat(new LocalDateTime(&quot;2000-01-01&quot;)).isAfter(new LocalDateTime(&quot;1999-12-31&quot;));</code></pre>
     * 
     * @param other the given {@link LocalDateTime}.
     * @return this assertion object.
     * @throws AssertionError if the actual {@code LocalDateTime} is {@code null}.
     * @throws IllegalArgumentException if other {@code LocalDateTime} is {@code null}.
     * @throws AssertionError if the actual {@code LocalDateTime} is not strictly after the given one.
     */
    public LocalDateTimeAssert isAfter(LocalDateTime other) {
        Objects.instance().assertNotNull(info, actual);
        assertLocalDateTimeParameterIsNotNull(other);
        if (!actual.isAfter(other)) {
            throw Failures.instance().failure(info, shouldBeAfter(actual, other));
        }
        return this;
    }

    /**
     * Same assertion as {@link #isAfter(LocalDateTime)} but the {@link LocalDateTime} is built from given a String that
     * must follow <a href=
     * "http://joda-time.sourceforge.net/api-release/org/joda/time/format/ISODateTimeFormat.html#localDateOptionalTimeParser()"
     * >ISO DateTime format</a> to allow calling {@link LocalDateTime#LocalDateTime(Object) LocalDateTime(Object)}
     * constructor.
     * <p>
     * Example :
     * <pre><code class='java'> // use String in comparison to avoid conversion
     * assertThat(new LocalDateTime(&quot;2000-01-01&quot;)).isAfter(&quot;1999-12-31&quot;);</code></pre>
     * 
     * @param localDateTimeAsString String representing a {@link LocalDateTime}.
     * @return this assertion object.
     * @throws AssertionError if the actual {@code LocalDateTime} is {@code null}.
     * @throws IllegalArgumentException if given String is null or can't be converted to a {@link LocalDateTime}.
     * @throws AssertionError if the actual {@code LocalDateTime} is not strictly after the {@link LocalDateTime} built
     *           from given String.
     */
    public LocalDateTimeAssert isAfter(String localDateTimeAsString) {
        assertLocalDateTimeAsStringParameterIsNotNull(localDateTimeAsString);
        return isAfter(new LocalDateTime(localDateTimeAsString));
    }

    /**
     * Same assertion as {@link #isEqualTo(Object)} (where Object is expected to be {@link LocalDateTime}) but here you
     * pass {@link LocalDateTime} String representation that must follow <a href=
     * "http://joda-time.sourceforge.net/api-release/org/joda/time/format/ISODateTimeFormat.html#localDateOptionalTimeParser()"
     * >ISO DateTime format</a> to allow calling {@link LocalDateTime#LocalDateTime(Object) LocalDateTime(Object)}
     * constructor.
     * <p>
     * Example :
     * <pre><code class='java'> // use directly String in comparison to avoid a conversion
     * assertThat(new LocalDateTime(&quot;2000-01-01&quot;)).isEqualTo(&quot;2000-01-01&quot;);</code></pre>
     * 
     * @param dateTimeAsString String representing a {@link LocalDateTime}.
     * @return this assertion object.
     * @throws AssertionError if the actual {@code LocalDateTime} is {@code null}.
     * @throws IllegalArgumentException if given String is null or can't be converted to a {@link LocalDateTime}.
     * @throws AssertionError if the actual {@code LocalDateTime} is not equal to the {@link LocalDateTime} built from
     *           given String.
     */
    public LocalDateTimeAssert isEqualTo(String dateTimeAsString) {
        assertLocalDateTimeAsStringParameterIsNotNull(dateTimeAsString);
        return isEqualTo(new LocalDateTime(dateTimeAsString));
    }

    /**
     * Same assertion as {@link #isNotEqualTo(Object)} (where Object is expected to be {@link LocalDateTime}) but here you
     * pass {@link LocalDateTime} String representation that must follow <a href=
     * "http://joda-time.sourceforge.net/api-release/org/joda/time/format/ISODateTimeFormat.html#localDateOptionalTimeParser()"
     * >ISO DateTime format</a> to allow calling {@link LocalDateTime#LocalDateTime(Object) LocalDateTime(Object)}
     * constructor.
     * <p>
     * Example :
     * <pre><code class='java'> // use directly String in comparison to avoid a conversion
     * assertThat(new LocalDateTime(&quot;2000-01-01&quot;)).isNotEqualTo(&quot;2000-01-15&quot;);</code></pre>
     * 
     * @param dateTimeAsString String representing a {@link LocalDateTime}.
     * @return this assertion object.
     * @throws AssertionError if the actual {@code LocalDateTime} is {@code null}.
     * @throws IllegalArgumentException if given String is null or can't be converted to a {@link LocalDateTime}.
     * @throws AssertionError if the actual {@code LocalDateTime} is equal to the {@link LocalDateTime} built from given
     *           String.
     */
    public LocalDateTimeAssert isNotEqualTo(String dateTimeAsString) {
        assertLocalDateTimeAsStringParameterIsNotNull(dateTimeAsString);
        return isNotEqualTo(new LocalDateTime(dateTimeAsString));
    }

    /**
     * Same assertion as {@link #isIn(Object...)} (where Objects are expected to be {@link LocalDateTime}) but here you
     * pass {@link LocalDateTime} String representations that must follow <a href=
     * "http://joda-time.sourceforge.net/api-release/org/joda/time/format/ISODateTimeFormat.html#localDateOptionalTimeParser()"
     * >ISO DateTime format</a> to allow calling {@link LocalDateTime#LocalDateTime(Object) LocalDateTime(Object)}
     * constructor.
     * <p>
     * Example :
     * <pre><code class='java'> // use String based representation of LocalDateTime
     * assertThat(new LocalDateTime(&quot;2000-01-01&quot;)).isIn(&quot;1999-12-31&quot;, &quot;2000-01-01&quot;);</code></pre>
     * 
     * @param dateTimesAsString String array representing {@link LocalDateTime}s.
     * @return this assertion object.
     * @throws AssertionError if the actual {@code LocalDateTime} is {@code null}.
     * @throws IllegalArgumentException if given String is null or can't be converted to a {@link LocalDateTime}.
     * @throws AssertionError if the actual {@code LocalDateTime} is not in the {@link LocalDateTime}s built from given
     *           Strings.
     */
    public LocalDateTimeAssert isIn(String... dateTimesAsString) {
        checkIsNotNullAndNotEmpty(dateTimesAsString);
        return isIn(convertToLocalDateTimeArray(dateTimesAsString));
    }

    /**
     * Same assertion as {@link #isNotIn(Object...)} (where Objects are expected to be {@link LocalDateTime}) but here you
     * pass {@link LocalDateTime} String representations that must follow <a href=
     * "http://joda-time.sourceforge.net/api-release/org/joda/time/format/ISODateTimeFormat.html#localDateOptionalTimeParser()"
     * >ISO DateTime format</a> to allow calling {@link LocalDateTime#LocalDateTime(Object) LocalDateTime(Object)}
     * constructor.
     * <p>
     * Example :
     * <pre><code class='java'> // use String based representation of LocalDateTime
     * assertThat(new LocalDateTime(&quot;2000-01-01&quot;)).isNotIn(&quot;1999-12-31&quot;, &quot;2000-01-02&quot;);</code></pre>
     * 
     * @param dateTimesAsString Array of String representing a {@link LocalDateTime}.
     * @return this assertion object.
     * @throws AssertionError if the actual {@code LocalDateTime} is {@code null}.
     * @throws IllegalArgumentException if given String is null or can't be converted to a {@link LocalDateTime}.
     * @throws AssertionError if the actual {@code LocalDateTime} is in the {@link LocalDateTime}s built from given
     *           Strings.
     */
    public LocalDateTimeAssert isNotIn(String... dateTimesAsString) {
        checkIsNotNullAndNotEmpty(dateTimesAsString);
        return isNotIn(convertToLocalDateTimeArray(dateTimesAsString));
    }

    private static Object[] convertToLocalDateTimeArray(String... dateTimesAsString) {
        LocalDateTime[] dates = new LocalDateTime[dateTimesAsString.length];
        for (int i = 0; i < dateTimesAsString.length; i++) {
            dates[i] = new LocalDateTime(dateTimesAsString[i]);
        }
        return dates;
    }

    private void checkIsNotNullAndNotEmpty(Object[] values) {
        if (values == null) {
            throw new IllegalArgumentException("The given LocalDateTime array should not be null");
        }
        if (values.length == 0) {
            throw new IllegalArgumentException("The given LocalDateTime array should not be empty");
        }
    }

    /**
     * Check that the {@link LocalDateTime} string representation to compare actual {@link LocalDateTime} to is not null,
     * otherwise throws a {@link IllegalArgumentException} with an explicit message
     * 
     * @param localDateTimeAsString String representing the {@link LocalDateTime} to compare actual with
     * @throws a {@link IllegalArgumentException} with an explicit message if the given {@link String} is null
     */
    private static void assertLocalDateTimeAsStringParameterIsNotNull(String localDateTimeAsString) {
        if (localDateTimeAsString == null) {
            throw new IllegalArgumentException(
                    "The String representing the LocalDateTime to compare actual with should not be null");
        }
    }

    /**
     * Check that the {@link LocalDateTime} to compare actual {@link LocalDateTime} to is not null, in that case throws a
     * {@link IllegalArgumentException} with an explicit message
     * 
     * @param other the {@link LocalDateTime} to check
     * @throws a {@link IllegalArgumentException} with an explicit message if the given {@link LocalDateTime} is null
     */
    private static void assertLocalDateTimeParameterIsNotNull(LocalDateTime other) {
        if (other == null) {
            throw new IllegalArgumentException("The LocalDateTime to compare actual with should not be null");
        }
    }

    /**
     * Verifies that actual and given {@code LocalDateTime} have same year, month, day, hour, minute and second fields,
     * (millisecond fields are ignored in comparison).
     * <p>
     * Assertion can fail with localDateTimes in same chronological millisecond time window, e.g :
     * <p>
     * 2000-01-01T00:00:<b>01.000</b> and 2000-01-01T00:00:<b>00.999</b>.
     * <p>
     * Assertion fails as second fields differ even if time difference is only 1ms.
     * <p>
     * Code example :
     * <pre><code class='java'> // successfull assertions
     * LocalDateTime localDateTime1 = new LocalDateTime(2000, 1, 1, 0, 0, 1, 0);
     * LocalDateTime localDateTime2 = new LocalDateTime(2000, 1, 1, 0, 0, 1, 456);
     * assertThat(localDateTime1).isEqualToIgnoringMillis(localDateTime2);
     * 
     * // failing assertions (even if time difference is only 1ms)
     * LocalDateTime localDateTimeA = new LocalDateTime(2000, 1, 1, 0, 0, 1, 0);
     * LocalDateTime localDateTimeB = new LocalDateTime(2000, 1, 1, 0, 0, 0, 999);
     * assertThat(localDateTimeA).isEqualToIgnoringMillis(localDateTimeB);</code></pre>
     * 
     * @param other the given {@link LocalDateTime}.
     * @return this assertion object.
     * @throws AssertionError if the actual {@code LocalDateTime} is {@code null}.
     * @throws IllegalArgumentException if other {@code LocalDateTime} is {@code null}.
     * @throws AssertionError if the actual {@code LocalDateTime} is are not equal with milliseconds ignored.
     */
    public LocalDateTimeAssert isEqualToIgnoringMillis(LocalDateTime other) {
        Objects.instance().assertNotNull(info, actual);
        assertLocalDateTimeParameterIsNotNull(other);
        if (!areEqualIgnoringMillis(actual, other)) {
            throw Failures.instance().failure(info, shouldBeEqualIgnoringMillis(actual, other));
        }
        return this;
    }

    /**
     * Verifies that actual and given {@link LocalDateTime} have same year, month, day, hour and minute fields (second and
     * millisecond fields are ignored in comparison).
     * <p>
     * Assertion can fail with LocalDateTimes in same chronological second time window, e.g :
     * <p>
     * 2000-01-01T00:<b>01:00</b>.000 and 2000-01-01T00:<b>00:59</b>.000.
     * <p>
     * Assertion fails as minute fields differ even if time difference is only 1s.
     * <p>
     * Code example :
     * <pre><code class='java'> // successfull assertions
     * LocalDateTime localDateTime1 = new LocalDateTime(2000, 1, 1, 23, 50, 0, 0);
     * LocalDateTime localDateTime2 = new LocalDateTime(2000, 1, 1, 23, 50, 10, 456);
     * assertThat(localDateTime1).isEqualToIgnoringSeconds(localDateTime2);
     * 
     * // failing assertions (even if time difference is only 1ms)
     * LocalDateTime localDateTimeA = new LocalDateTime(2000, 1, 1, 23, 50, 00, 000);
     * LocalDateTime localDateTimeB = new LocalDateTime(2000, 1, 1, 23, 49, 59, 999);
     * assertThat(localDateTimeA).isEqualToIgnoringSeconds(localDateTimeB);</code></pre>
     * 
     * @param other the given {@link LocalDateTime}.
     * @return this assertion object.
     * @throws AssertionError if the actual {@code LocalDateTime} is {@code null}.
     * @throws IllegalArgumentException if other {@code LocalDateTime} is {@code null}.
     * @throws AssertionError if the actual {@code LocalDateTime} is are not equal with second and millisecond fields
     *           ignored.
     */
    public LocalDateTimeAssert isEqualToIgnoringSeconds(LocalDateTime other) {
        Objects.instance().assertNotNull(info, actual);
        assertLocalDateTimeParameterIsNotNull(other);
        if (!areEqualIgnoringSeconds(actual, other)) {
            throw Failures.instance().failure(info, shouldBeEqualIgnoringSeconds(actual, other));
        }
        return this;
    }

    /**
     * Verifies that actual and given {@code LocalDateTime} have same year, month, day and hour fields (minute, second and
     * millisecond fields are ignored in comparison).
     * <p>
     * Assertion can fail with localDateTimes in same chronological second time window, e.g :
     * <p>
     * 2000-01-01T<b>01:00</b>:00.000 and 2000-01-01T<b>00:59:59</b>.000.
     * <p>
     * Time difference is only 1s but hour fields differ.
     * <p>
     * Code example :
     * <pre><code class='java'> // successfull assertions
     * LocalDateTime localDateTime1 = new LocalDateTime(2000, 1, 1, 23, 50, 0, 0);
     * LocalDateTime localDateTime2 = new LocalDateTime(2000, 1, 1, 23, 00, 2, 7);
     * assertThat(localDateTime1).isEqualToIgnoringMinutes(localDateTime2);
     * 
     * // failing assertions (even if time difference is only 1ms)
     * LocalDateTime localDateTimeA = new LocalDateTime(2000, 1, 1, 01, 00, 00, 000);
     * LocalDateTime localDateTimeB = new LocalDateTime(2000, 1, 1, 00, 59, 59, 999);
     * assertThat(localDateTimeA).isEqualToIgnoringMinutes(localDateTimeB);</code></pre>
     * 
     * @param other the given {@link LocalDateTime}.
     * @return this assertion object.
     * @throws AssertionError if the actual {@code LocalDateTime} is {@code null}.
     * @throws IllegalArgumentException if other {@code LocalDateTime} is {@code null}.
     * @throws AssertionError if the actual {@code LocalDateTime} is are not equal ignoring minute, second and millisecond
     *           fields.
     */
    public LocalDateTimeAssert isEqualToIgnoringMinutes(LocalDateTime other) {
        Objects.instance().assertNotNull(info, actual);
        assertLocalDateTimeParameterIsNotNull(other);
        if (!areEqualIgnoringMinutes(actual, other)) {
            throw Failures.instance().failure(info, shouldBeEqualIgnoringMinutes(actual, other));
        }
        return this;
    }

    /**
     * Verifies that actual and given {@code LocalDateTime} have same year, month and day fields (hour, minute, second and
     * millisecond fields are ignored in comparison).
     * <p>
     * Assertion can fail with localDateTimes in same chronological minute time window, e.g :
     * <p>
     * 2000-01-<b>01T23:59</b>:00.000 and 2000-01-02T<b>00:00</b>:00.000.
     * <p>
     * Time difference is only 1min but day fields differ.
     * <p>
     * Code example :
     * <pre><code class='java'> // successfull assertions
     * LocalDateTime localDateTime1 = new LocalDateTime(2000, 1, 1, 23, 59, 59, 999);
     * LocalDateTime localDateTime2 = new LocalDateTime(2000, 1, 1, 00, 00, 00, 000);
     * assertThat(localDateTime1).isEqualToIgnoringHours(localDateTime2);
     * 
     * // failing assertions (even if time difference is only 1ms)
     * LocalDateTime localDateTimeA = new LocalDateTime(2000, 1, 2, 00, 00, 00, 000);
     * LocalDateTime localDateTimeB = new LocalDateTime(2000, 1, 1, 23, 59, 59, 999);
     * assertThat(localDateTimeA).isEqualToIgnoringHours(localDateTimeB);</code></pre>
     * 
     * @param other the given {@link LocalDateTime}.
     * @return this assertion object.
     * @throws AssertionError if the actual {@code LocalDateTime} is {@code null}.
     * @throws IllegalArgumentException if other {@code LocalDateTime} is {@code null}.
     * @throws AssertionError if the actual {@code LocalDateTime} is are not equal with second and millisecond fields
     *           ignored.
     */
    public LocalDateTimeAssert isEqualToIgnoringHours(LocalDateTime other) {
        Objects.instance().assertNotNull(info, actual);
        assertLocalDateTimeParameterIsNotNull(other);
        if (!haveSameYearMonthAndDayOfMonth(actual, other)) {
            throw Failures.instance().failure(info, shouldBeEqualIgnoringHours(actual, other));
        }
        return this;
    }

    /**
     * Returns true if both datetime are in the same year, month and day of month, hour, minute and second, false
     * otherwise.
     * 
     * @param actual the actual datetime. expected not be null
     * @param other the other datetime. expected not be null
     * @return true if both datetime are in the same year, month and day of month, hour, minute and second, false
     *         otherwise.
     */
    private static boolean areEqualIgnoringMillis(LocalDateTime actual, LocalDateTime other) {
        return areEqualIgnoringSeconds(actual, other) && actual.getSecondOfMinute() == other.getSecondOfMinute();
    }

    /**
     * Returns true if both datetime are in the same year, month, day of month, hour and minute, false otherwise.
     * 
     * @param actual the actual datetime. expected not be null
     * @param other the other datetime. expected not be null
     * @return true if both datetime are in the same year, month, day of month, hour and minute, false otherwise.
     */
    private static boolean areEqualIgnoringSeconds(LocalDateTime actual, LocalDateTime other) {
        return areEqualIgnoringMinutes(actual, other) && actual.getMinuteOfHour() == other.getMinuteOfHour();
    }

    /**
     * Returns true if both datetime are in the same year, month, day of month and hour, false otherwise.
     * 
     * @param actual the actual datetime. expected not be null
     * @param other the other datetime. expected not be null
     * @return true if both datetime are in the same year, month, day of month and hour, false otherwise.
     */
    private static boolean areEqualIgnoringMinutes(LocalDateTime actual, LocalDateTime other) {
        return haveSameYearMonthAndDayOfMonth(actual, other) && actual.getHourOfDay() == other.getHourOfDay();
    }

    /**
     * Returns true if both datetime are in the same year, month and day of month, false otherwise.
     * 
     * @param actual the actual datetime. expected not be null
     * @param other the other datetime. expected not be null
     * @return true if both datetime are in the same year, month and day of month, false otherwise
     */
    private static boolean haveSameYearMonthAndDayOfMonth(LocalDateTime actual, LocalDateTime other) {
        return haveSameYearAndMonth(actual, other) && actual.getDayOfMonth() == other.getDayOfMonth();
    }

    /**
     * Returns true if both datetime are in the same year and month, false otherwise.
     * 
     * @param actual the actual datetime. expected not be null
     * @param other the other datetime. expected not be null
     * @return true if both datetime are in the same year and month, false otherwise
     */
    private static boolean haveSameYearAndMonth(LocalDateTime actual, LocalDateTime other) {
        return haveSameYear(actual, other) && actual.getMonthOfYear() == other.getMonthOfYear();
    }

    /**
     * Returns true if both datetime are in the same year, false otherwise.
     * 
     * @param actual the actual datetime. expected not be null
     * @param other the other datetime. expected not be null
     * @return true if both datetime are in the same year, false otherwise
     */
    private static boolean haveSameYear(LocalDateTime actual, LocalDateTime other) {
        return actual.getYear() == other.getYear();
    }
}