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

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?

In #8 there was a breaking change. In 0300e03 it was documented as a breaking change with a feature version bump.

See https://dart.dev/tools/pub/versioning#semantic-versions and https://semver.org/ for info on semantic versioning. By incrementing the major version to 2.0.0, downstream consumers of your package can avoid getting broken by changes like this.

It can be smoother to also have a migration period where things are not broken, but you can update to the new name in advance. In this case the getter could have been forwarded with a new name and the old one marked @deprecated.

  /// Adds the Duration to the current DateTime and returns a DateTime in the future
  DateTime get fromNow => DateTime.now() + this;

  @Deprecated('Use fromNow instead. Will be removed in 2.0.0')
  DateTime get later => fromNow;

It would be a good idea to add back this definition of later and publish as version 1.1.1 - a bug fix release to undo the breaking change.

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

Do you think this library would be a good place for a copyWith method?

extension DateTimeExtension on DateTime {
  DateTime copyWith({
    int year,
    int month,
    int day,
    int hour,
    int minute,
    int second,
    int millisecond,
    int microsecond,
  }) {
    return DateTime(
      year ?? this.year,
      month ?? this.month,
      day ?? this.day,
      hour ?? this.hour,
      minute ?? this.minute,
      second ?? this.second,
      millisecond ?? this.millisecond,
      microsecond ?? this.microsecond,
    );
  }
}

Labeled this as "help wanted" even though there is a PR open for this, not so sure if the semantic naming really matters but maybe necessary for others. If it is to you drop a thumbs up 👍

cc @jporsay

build status is failured

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;
    }
  }
}

When using the datetime extensions, this appear as problem:

Don't import implementation files from another package.

Flutter doesn't like files linking into lib/src. Files outside of it would be fine though.
https://dart-lang.github.io/linter/lints/implementation_imports.html

Moving time/src/extensions.dart out should solve the problem.

please add months in NumTimeExtension

Hey @jogboms !

You work here is great! There is a library called dartx that has a proposal to add a lot of extensions to the dart's types. Since they were missing the time extensions I made a pull request to their repostory with your work.

I gave you credits on readme. Take a look and tell what you think: simc/dartx#11

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.

Do you think about age calculation feature for it?
Converting DateTime birthday to int age.
East Asian age reckoning option also.

Looking for lastDayOfMonth like feature, found this StackOverflow question and I really liked the way Yogesh Parwani mixed Chris Buckett and Kai Sellgren awnsers. As pointed by Juniper Belmont on Buckett's answer, I do think this could be a new feature as mnordine suggested here.

(Better code from here - lrhn)

Code bellow:

extension DateTimeFirstLast on DateTime {
  DateTime get firstDayOfWeek => DateTime.utc(year, month, day + 1 - weekday);
  DateTime get lastDayOfWeek => DateTime.utc(year, month, day + 7 - weekday);  
  DateTime get firstDayOfMonth => DateTime.utc(year, month, 1);
  DateTime get lastDayOfMonth => DateTime.utc(year, month + 1, 0);
  DateTime get firstDayOfYear => DateTime.utc(year, 1, 1);
  DateTime get lastDayOfYear => DateTime.utc(year, 12, 31);
}

Since package:clock was added, I believe it best to reuse some of its utilities.

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)

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)?