Dart Duration

const Duration({
  int days = 0,
  int hours = 0,
  int minutes = 0,
  int seconds = 0,
  int milliseconds = 0,
  int microseconds = 0,
});

// Example instantiation
final exactTime = Duration(days: 2, hours: 14, minutes: 45);
final overflowTime = Duration(minutes: 90); // Normalized to 1 hour, 30 minutes
final negativeTime = Duration(hours: -2);   // Represents a negative span

final span = Duration(days: 1, hours: 2);

// Returns the entire span converted to the specified unit
print(span.inDays);          // 1
print(span.inHours);         // 26
print(span.inMinutes);       // 1560
print(span.inSeconds);       // 93600
print(span.inMilliseconds);  // 93600000
print(span.inMicroseconds);  // 93600000000

// Returns true if the total microsecond count is less than zero
print(span.isNegative);      // false

final d1 = Duration(hours: 2);
final d2 = Duration(minutes: 30);

// Binary operations with other Durations
final sum = d1 + d2;         // Duration(hours: 2, minutes: 30)
final difference = d1 - d2;  // Duration(hours: 1, minutes: 30)

// Unary negation
final negated = -d1;         // Duration(hours: -2)

// Scalar operations (multiplying/dividing the underlying microseconds)
final scaled = d1 * 2;       // Duration(hours: 4)
final divided = d1 ~/ 3;     // Duration(minutes: 40) - Note: requires integer division (~/)

final d1 = Duration(seconds: 60);
final d2 = Duration(minutes: 1);
final d3 = Duration(seconds: 90);

print(d1 == d2); // true
print(d1 < d3);  // true
print(d3 >= d2); // true

final negativeDuration = Duration(seconds: -15);

// Returns a new Duration with a positive microsecond value
final absolute = negativeDuration.abs(); // Duration(seconds: 15)

// Returns an integer indicating sort order (-1, 0, or 1)
final comparison = absolute.compareTo(negativeDuration); // 1