Do you want these?

If so, I will pull-request.

someDateTimeValue.isToday();

=> true or false

someDateTimeValue.isTomorrow();

=> true or false

someDateTimeValue.isYesterday();

=> true or false

In C#, we have those two usefull properties of a DateTime:

var now = DateTime.Now; // 2020-04-10T15:27:00
var datePartOnly = now.Date; // 2020-03-10T00:00:00 (returns a DateTime, with 00:00:00 time)
var timePartOnly = now.TimeOfDay; // 15:17:00 (returns a TimeSpan - Duration in Dart)

Found a bug. When both min and max were equal, the assertion was throwing. Added a test to maintain that as well. The documentation above was correct, must have missed it when publishing the first time.

I dislike writing .difference(DateTime.now()). On the homepage of the package I didn't find a shorthand for that expression in this package? Does one exist (and maybe might be made easier to find)?

Using .later doesn't leave clear what the origin time is. Renamed it to .fromNow to clarify that the time is a delta time starting from DateTime.now().

3rd party examples: moment.js uses a similar nomenclature. As does Ruby on Rails.

Fixes #9

This PR allows the Time package to use the official clock package published by the Dart tools team. By using clock.now() instead of DateTime.now(), code which is time-dependent can be easily tested using the clock package's withClock test utility function.

Here's a lovely article about using the clock package to test time-dependent code.

This also makes the unit tests here a little bit cleaner. If you have any feedback, let me know! Thank you for making this package.

Adds two new getters to DateTime instances.

DateTime(2001,6, 26).seasonNorth  //  Season.summer
DateTime(2001,6, 26).seasonSouth  // Season.winter

I couldn't decide if I should create this in a separate package or include this here. So I need your verdict, If you find reasonable adding a season extension to the package, this is ok. If not, just tell me and I publish it separately.

Since my last contribution, I figured I could suggest these files so that people using VSCode or Android Studio/IntelliJ that work on this project will always get the right line length for dart formatting.

Proposal

DateTime (maybe Duration as well?) clamp. Any suggestions are welcome. I just encountered a need for a DateTime clamp, perhaps this nullable option is not the best fit, but for my case it was.

Inspiration

num clamp(num lowerLimit, num upperLimit);

Actual implementation

extension ClampDateTime on DateTime {
  DateTime clamp({DateTime? min, DateTime? max}) {
    assert(
      ((min != null) && (max != null)) ? min.compareTo(max).isNegative : true,
      'DateTime min has to be before max\n(min: $min - max: $max)',
    );
    if ((min != null) && compareTo(min).isNegative) {
      return min;
    } else if ((max != null) && max.compareTo(this).isNegative) {
      return max;
    } else {
      return this;
    }
  }
}

extension DurationClamp on Duration{
  Duration clamp({Duration? min, Duration? max}) {
    assert(
      ((min != null) && (max != null)) ? min.compareTo(max).isNegative : true,
      'Duration min has to be shorter than max\n(min: $min - max: $max)',
    );
    if ((min != null) && compareTo(min).isNegative) {
      return min;
    } else if ((max != null) && max.compareTo(this).isNegative) {
      return max;
    } else {
      return this;
    }
  }
}

This package is currently blocking dartx from migrating to null-safety. Null-safety is now in beta, and the dart team is encouraging package authors to migrate now. I'll submit a pull request if you'd like to review it. I see there is one already open, but it doesn't bump the dart sdk min version to 2.12 like we are supposed to, and instead enables it in the analysis_options.yaml which is not required if you set the min sdk version properly.

Hi!

I see there are a number of handy things on master that were not cut into a new release - especially DateTime().now.date / wasYesterday and other.

Anything against releasing a new version?

DateTIme class has isAfter isBefore
but There is no API to determine whether a given date is after or before the day after or before the day before. also month

final DateTime specificDate = DateTime(2021, 01, 01);
final DateTime sameDate = DateTime(2021, 01, 01).add(const Duration(seconds: 5));
final DateTime otherDate = DateTime(2021, 01, 02);

print(specificDate.isAfterDay(sameDate)); // false
print(specificDate.isAfterDay(otherDate)); // true