moment_dart 0.5.0

moment_dart: ^0.5.0 copied to clipboard

An attempt to port moment.js to Dart.

Features #

Convert DateTime to human-readable text.

• Relative duration
• Calendar text
• Formatted dates
• Multiple localizations

Getings started #

Import the package

import 'package:moment_dart/moment_dart.dart';

Create Moment instance

final Moment now = Moment.now();

final Moment epoch = Moment(DateTime.fromMicrosecondsSinceEpoch(0, isUtc: true));

final Moment bday = DateTime(2003, 6, 1, 5, 1).toMoment();

Usage #

Relative durations #

final Moment yesterday = Moment.now() - Duration(days: 1);

yesterday.fromNow(); // a day ago

// You can omit prefix/suffix
yesterday.fromNow(true); // a day

yesterday.from(yesterday - Duration(days: 365)); // a year ago

Calendar dates #

now.subtract(Duration(days: 1)).calendar();  // Yesterday
now.calendar();                              // Today
now.subtract(Duration(days: 1)).calendar();  // Tomorrow

// [reference] - defaults to Moment.now(), acts as an anchor.
// [omitHours] - omits the hour part. Hour part is formatted by "LT" token.
now.calendar(
  reference: (now - Duration(days: 1)),
  omitHours: true,
); // Tomorrow

// [const] removed to save visual space. Please prefer to use `const Duration()`

Formatting #

now.format("YYYY MMMM Do - hh:mm:ssa"); //2003 June 1st - 05:01:00am
now.format("LTS");                      //5:01:00 AM
now.format("dddd");                     //Sunday
now.format("MMM Do YY");                //Jun 1st 03

Changing localization #

Localization defaults to MomentLocalizations.enUS()

final Moment hangulday2022 = Moment(DateTime(2022,10,9), localization: MomentLocalizations.ko());

hangulday2022.format("ll"); // 2022년 10월 9일
hangulday2022.format("LL"); // 2022년 10월 9일

Available Localization classes: #

Localizations are classes that extend MomentLocalization

• LocalizationEnUs (English - United States) [en_US]
• LocalizationKorean (Korean) [ko]
• LocalizationGermanStandard (German) [de_DE]
• LocalizationMongolianCyrillic (Mongolian) [mn]
  • LocalizationMongolianTraditional (Mongolian) [mn]
  • LocalizationMongolianTraditionalNumbers (Uses traditional Mongolian numbers)

Parsing #

COMING SOON 💫

Salt 🧂 and pepper #

Moment provides an extension with set of useful functions. Can be called on either Moment or DateTime instance

final DateTime date = DateTime(2022,03,29);

//Returns the ISO Week number of the year
//
// [1,2,3,...,52,53]
date.week == 13; // true

// Returns the year according to ISO Week
date.weekYear == 2022; // true

// Returns the quarter of the year. [][Jan,Feb,Mar][Apr,May,Jun][Jul,Aug,Sep][Oct,Nov,Dec]
//
// [1,2,3,4]
date.quarter == 1; // true

// Returns if the [year] is leap year
date.isLeapYear == false; // true

/// Returns ordinal day of the year
/// 
/// [1,2,3,...,365,366]
date.dayOfYear == 88; // true

Read more about ISO week on Wikipedia

Creating your own Localzation #

Extend MomentLocalization class to get started.

Almost everything is declared as function, so you can freely achieve the unique features of your language.

I highly recommend copying one of the existing implementations then work on top of it!

CatLanguage extends MomentLocalization {
  @override
  String relative(Duration duration, [bool dropPrefixOrSuffix = false]) => "a two meow ago";

  @override
  String weekdayName(int i) => "Meowday #$i";

  @override
  String calendar(Moment moment, {Moment? reference, bool weekStartOnSunday = false, bool omitHours = false}) => "Last Meowday";

  /// Please refer to the [FormatterToken] enum for details.
  /// 
  /// It contains almost all of the tokens mentioned in https://momentjs.com/docs/#/parsing/string-format/
  Map<FormatterToken, FormatterTokenFn?> formats() => {};

  @override
  String languageCodeISO() => "meow";

  @override
  String endonym() => "Meow-meow meow";

  @override
  String locale() => "meow";

  @override
  String languageNameInEnglish() => "Cat tongue";
}

Format Tokens #

Encapsulate string in square brackets ([]) to escape.

TODO #

• Add more localizations
• Implement parsing