dart:core

compareTo method

int compareTo(

1. DateTime other

)

override

Compares this DateTime object to other, returning zero if the values are equal.

A compareTo function returns:

• a negative value if this DateTime isBefore other.
• 0 if this DateTime isAtSameMomentAs other, and
• a positive value otherwise (when this DateTime isAfter other).

final now = DateTime.now();
final future = now.add(const Duration(days: 2));
final past = now.subtract(const Duration(days: 2));
final newDate = now.toUtc();

print(now.compareTo(future)); // -1
print(now.compareTo(past)); // 1
print(now.compareTo(newDate)); // 0

Implementation

external int compareTo(DateTime other);