DateTimeComparator 行为与其 javadoc 不一致

Question

我只想比较两个 org.joda.time.DateTime 值的日期，所以我使用了 DateTimeComparator.getDateOnlyInstance() - 但我看到了一些与其 javadoc 不匹配的行为。我想知道这里是否有人可以解释一下。 javadoc of DateTimeComparator 对其参数和 return 值的说明如下：

Parameters:
    lhsObj - the first object, logically on the left of a < comparison, null means now
    rhsObj - the second object, logically on the right of a < comparison, null means now
Returns:
    zero if order does not matter, negative value if lhsObj < rhsObj, positive value otherwise.

问题 1： 为什么会 return zero if order does not matter。 Comparator interface's javadoc 中定义的此方法的约定表明 return 值应为 a negative integer, zero, or a positive integer as the first argument is less than, equal to, or greater than the second。（我刚刚想到 order does not matter 可能是作者说对象相等的方式，但这是一种令人困惑的方式。）

问题 2：考虑以下代码及其输出：

public static void main(String[] args) {
    DateTime nowUTC = DateTime.now(DateTimeZone.UTC);
    int comparisonResult = DateTimeComparator.getDateOnlyInstance().compare(null, nowUTC);
    System.out.println("comparisonResult = " + comparisonResult);
}

输出（请记住，null 表示现在，并且只应比较日期：

comparisonResult = -1

=== 阅读第一个答案和更多实验后的附加信息：

同意 null 表示 "now in default system timezone"，但如果您比较 DateTime.now(DateTimeZone.UTC) 和 null 的整个日期时间值，它们是相同的（请参阅下面的附加代码）。这对我来说似乎是正确的，因为 now 在任何时区都是同一时刻。但是，各个字段可能不同。因此，昨天，我仅在 UTC 和 PST（我的默认系统时区）中的日期不同时才比较日期，我得到了预期结果 = 1，因为 UTC 中的日期更大。此时，虽然两个区域的日期相同，但比较器似乎说 UTC 中的日期比 PST 中的日期少，这是不可能的。

测试代码：

public static void main(String[] args) {

System.out.println("Printing DateTime.now(DateTimeZone.UTC), and (DateTime)null using formatter.withZoneUTC()");
System.out.println("\tDateTime.now(DateTimeZone.UTC)\t= " +
        DateTimeFormat.forPattern("yyyy-MM-dd'T'HH:mm:ss-z").withZoneUTC().print(DateTime.now(DateTimeZone.UTC)));
System.out.println("\t(DateTime)null\t\t\t= " +
        DateTimeFormat.forPattern("yyyy-MM-dd'T'HH:mm:ss-z").withZoneUTC().print((DateTime)null));
System.out.println();

System.out.println("Printing (DateTime)null using formatter with default timezone");
System.out.println("\t(DateTime)null\t\t\t= " + DateTimeFormat.forPattern("yyyy-MM-dd'T'HH:mm:ss-z").print((DateTime)null));
System.out.println();

System.out.println("Comparing date only of DateTime.now(DateTimeZone.UTC) (LHS) and null (RHS)");
int dateOnlyComparisonResult = DateTimeComparator.getDateOnlyInstance().compare(DateTime.now(DateTimeZone.UTC), null);
System.out.println("\tdateOnlyComparisonResult\t= " + dateOnlyComparisonResult);
System.out.println();

System.out.println("Comparing entire date time value of DateTime.now(DateTimeZone.UTC) and null");
int instantComparisonResult = DateTimeComparator.getInstance().compare(DateTime.now(DateTimeZone.UTC), null);
System.out.println("\tinstantComparisonResult\t\t=  " + instantComparisonResult);

}

输出：

Printing DateTime.now(DateTimeZone.UTC), and (DateTime)null using formatter.withZoneUTC()
    DateTime.now(DateTimeZone.UTC)  = 2016-02-11T19:26:07-UTC
    (DateTime)null          = 2016-02-11T19:26:08-UTC

Printing (DateTime)null using formatter with default timezone
    (DateTime)null          = 2016-02-11T11:26:08-PST

Comparing date only of DateTime.now(DateTimeZone.UTC) (LHS) and null (RHS)
    dateOnlyComparisonResult    = -1

Comparing entire date time value of DateTime.now(DateTimeZone.UTC) and null
    instantComparisonResult     =  0

Answer 1

问题 1 的答案：

我同意 "zero if order does not matter" 这个短语令人困惑。它可能更好地替换为 "zero if temporal objects are equal" 或类似的。您可以 post 在 Joda-Time 的 github 位置提出问题甚至拉取请求，以建议您的首选描述。

问题 2 的答案：

Null 值不仅仅表示现在，而是默认系统时区中的现在。所以只有以下代码有效：

DateTime nowDefaultZone = DateTime.now(DateTimeZone.getDefault());
int comparisonResult = 
  DateTimeComparator.getDateOnlyInstance().compare(null, nowDefaultZone);
System.out.println("comparisonResult = " + comparisonResult); // 0

无论如何，我强烈建议不要使用此 null-"feature"，而是指定明确的时区引用，因为将 null 解释为与 "now" 相关的任何内容本身并不直观。

DateTimeComparator 行为与其 javadoc 不一致

DateTimeComparator behavior inconsistent with its javadoc

jodatime

datetime-comparison