Merge pull request #27 from sadespresso:master

Release 3.0.0

Author: sadespresso

.markdownlint.json

@@ -1,5 +1,4 @@
 {
-  "MD013": {
-    "line_length": 80
-  }
+  "MD013": false,
+  "MD041": false
 }

CHANGELOG.md

@@ -1,3 +1,12 @@
+## 3.0.0
+
+> This release has breaking changes!
+
+- Changed `TimeRange.toString()` delimiter to `@`
+- Fixed CustomTimeRange not being able to be parsed
+- Added `.encode()` and `.encodeShort()` methods on `TimeRange`
+- Added `TimeRange.fromStartAndDuration` constructor
+
 ## 2.2.1
 
 - Added `TimeRange` readable format.
@@ -67,7 +76,7 @@
 
 ## 1.1.0
 
-- `.startOf(DurationUnit.week)` and `endOf` now works, fixes [#13](https://github.com/sadespresso/moment_dart/issues/13) 
+- `.startOf(DurationUnit.week)` and `endOf` now works, fixes [#13](https://github.com/sadespresso/moment_dart/issues/13)
 
 ## 1.0.1
 
@@ -76,6 +85,7 @@
 ## 1.0.0
 
 > Features **breaking changes**
+
 - Now requires Dart v2.19.4
 - Added {reference} argument to `ComplexCalendar` methods
   - This fixes incorrect results of localizations that use `ComplexCalender` (i.e., zh_CN, it_IT)
@@ -96,6 +106,7 @@
 ## 1.0.0-rc.1
 
 > Features **breaking changes**
+
 - Added {reference} argument to `ComplexCalendar` methods
   - This fixes incorrect results of localizations that use `ComplexCalender` (i.e., zh_CN, it_IT)
 - Renamed `LocalizationKo` to `LocalizationKoKr` for consistency
@@ -157,6 +168,7 @@
 ## 0.16.0
 
 > This release has breaking changes!
+
 - `Duration().toDurationString()` first argument is now **named**, and ***optional***. When null, uses global localization set using `Moment.setGlobalLocalization(MomentLocalization)`
 - Now `weekStart` of `DateTime().startOfLocalWeek([int weekStart])` is nullable, and defaults to `Moment.defaultLocalization.weekStart`
 - Now `weekStart` of `DateTime().endOfLocalWeek([int weekStart])` is nullable, and defaults to `Moment.defaultLocalization.weekStart`
@@ -169,19 +181,22 @@
 ## 0.14.0
 
 > This release has breaking changes!
+
 - [BREAKING] moment.format("YY") now **no longer throws exception** when year doesn't fall in range (1970, 2030). Instead, it returns full year. e.g., `DateTime(1969).format("YY"); // 1969`
 - [BREAKING] moment.format("gg") now **no longer throws exception** when ISO week year doesn't fall in range (1970, 2030). Instead, it returns full year. e.g., `DateTime(1969).format("gg"); // 1969`
 - [BREAKING] `DateTime.format(...)` now expect named arguments instead of optional positional arguments
 
 ## 0.13.0
 
 > This release has breaking changes!
-- [BREAKING] `endOf_()` and `startOf_()` now _preserves_ the timezone instead of always returning local `DateTime` object
+
+- [BREAKING] `endOf_()` and `startOf_()` now *preserves* the timezone instead of always returning local `DateTime` object
 - `endOf(DurationUnit.microsecond)` and `startOf(DurationUnit.microsecond)` now returns `this.clone()` instead of throwing error
 
 ## 0.12.0
 
 > This release has breaking changes!
+
 - [BREAKING] `isAtSameUnit___As(other)` now doesn't take timezones into account. If you want the old behaviour, use `isAtSameUnit___As(other, enforceUTC: true)`
 - [BREAKING] Renamed `MomentLocalizations.deDE()` to `.de()`
 - [BREAKING] Removed `Moment().elapsed()` for sake of `Moment().fromPrecise()`
@@ -259,7 +274,7 @@
   - Restructured formatters. No need to override formatter for every `FormatterToken`
 - Removed following deprecated methods: `Moment.lastMondayAsDateTime()`, `Moment.lastSundayAsDateTime()`
 - Implemented `.endOf(DurationUnit unit)`, and it's children `.endOf~~~()`. Works on both `Moment` and `DateTime`
-- Added new locales: 
+- Added new locales:
   - Spanish (es) (Spain)
   - French (fr) (France)
 - Minor changes:

lib/src/localizations/de_DE.dart

@@ -243,8 +243,8 @@ class LocalizationDeDe extends MomentLocalization
         thisYear: "Dieses Jahr",
         year: (range) => "Jahr ${range.year}",
         month: (range) => monthNames[range.month]!,
-        customRangeAfter: (formattedDate) => "Nach $formattedDate",
-        customRangeBefore: (formattedDate) => "Vor $formattedDate",
+        allAfter: (formattedDate) => "Nach $formattedDate",
+        allBefore: (formattedDate) => "Vor $formattedDate",
         customRangeAllTime: "Allzeit",
       );
 }

lib/src/localizations/en_US.dart

@@ -213,8 +213,8 @@ class LocalizationEnUs extends MomentLocalization
         thisYear: "This year",
         year: (range) => "Year ${range.year}",
         month: (range) => monthNames[range.month]!,
-        customRangeAfter: (formattedDate) => "After $formattedDate",
-        customRangeBefore: (formattedDate) => "Before $formattedDate",
+        allAfter: (formattedDate) => "After $formattedDate",
+        allBefore: (formattedDate) => "Before $formattedDate",
         customRangeAllTime: "All time",
       );
 }

lib/src/localizations/es_ES.dart

@@ -223,8 +223,8 @@ class LocalizationEsEs extends MomentLocalization
         thisYear: "Este año",
         year: (range) => "Año ${range.year}",
         month: (range) => monthNames[range.month]!,
-        customRangeAfter: (formattedDate) => "Después $formattedDate",
-        customRangeBefore: (formattedDate) => "Antes $formattedDate",
+        allAfter: (formattedDate) => "Después $formattedDate",
+        allBefore: (formattedDate) => "Antes $formattedDate",
         customRangeAllTime: "Todo el tiempo",
       );
 }

lib/src/localizations/fr_FR.dart

@@ -230,8 +230,8 @@ class LocalizationFrFr extends MomentLocalization
         thisYear: "Cette année",
         year: (range) => "Année ${range.year}",
         month: (range) => monthNames[range.month]!,
-        customRangeAfter: (formattedDate) => "Après $formattedDate",
-        customRangeBefore: (formattedDate) => "Avant $formattedDate",
+        allAfter: (formattedDate) => "Après $formattedDate",
+        allBefore: (formattedDate) => "Avant $formattedDate",
         customRangeAllTime: "Tout le temps",
       );
 }

lib/src/localizations/it_IT.dart

@@ -229,8 +229,8 @@ class LocalizationItIt extends MomentLocalization
         thisYear: "Quest'anno",
         year: (range) => "Anno ${range.year}",
         month: (range) => monthNames[range.month]!,
-        customRangeAfter: (formattedDate) => "Dopo $formattedDate",
-        customRangeBefore: (formattedDate) => "Prima di $formattedDate",
+        allAfter: (formattedDate) => "Dopo $formattedDate",
+        allBefore: (formattedDate) => "Prima di $formattedDate",
         customRangeAllTime: "Tutto il tempo",
       );
 }

lib/src/localizations/ja_JP.dart

@@ -182,8 +182,8 @@ class LocalizationJaJp extends MomentLocalization
         thisYear: "今年",
         year: (range) => "${range.year}年",
         month: (range) => monthName(range.month),
-        customRangeAfter: (formattedDate) => "$formattedDate以降",
-        customRangeBefore: (formattedDate) => "$formattedDate以前",
+        allAfter: (formattedDate) => "$formattedDate以降",
+        allBefore: (formattedDate) => "$formattedDate以前",
         customRangeAllTime: '全ての時間',
       );
 }

lib/src/localizations/ko_KR.dart

@@ -152,8 +152,8 @@ class LocalizationKoKr extends MomentLocalization
         thisYear: "올해",
         year: (range) => "${range.year}년",
         month: (range) => monthName(range.month),
-        customRangeAfter: (formattedDate) => "$formattedDate 이후",
-        customRangeBefore: (formattedDate) => "$formattedDate 이전",
+        allAfter: (formattedDate) => "$formattedDate 이후",
+        allBefore: (formattedDate) => "$formattedDate 이전",
         customRangeAllTime: "전체 시간",
       );
 }

lib/src/localizations/mixins/simple_range.dart

@@ -16,13 +16,13 @@ class SimpleRangeData {
   ///
   /// For example, in en_US,
   /// (formattedDate) => "After $formattedDate"
-  final String Function(String formattedDate) customRangeAfter;
+  final String Function(String formattedDate) allAfter;
 
   /// When start date equals [Moment.minValue]
   ///
   /// For example, in en_US,
   /// (formattedDate) => "Before $formattedDate"
-  final String Function(String formattedDate) customRangeBefore;
+  final String Function(String formattedDate) allBefore;
 
   /// When range [from] is equal to [Moment.minValue] and
   /// [to] is equal to [Moment.maxValue]
@@ -50,8 +50,8 @@ class SimpleRangeData {
     required this.thisYear,
     required this.year,
     required this.month,
-    required this.customRangeAfter,
-    required this.customRangeBefore,
+    required this.allAfter,
+    required this.allBefore,
     required this.customRangeAllTime,
     this.customRangeDelimiter = " - ",
     this.reverseRangeDates = false,
@@ -102,14 +102,14 @@ mixin SimpleRange on MomentLocalization {
           .toMoment(localization: localization)
           .calendar(omitHours: custom.from.isMidnight, reference: anchor);
 
-      return localization.simpleRangeData.customRangeAfter(formattedDate);
+      return localization.simpleRangeData.allAfter(formattedDate);
     }
     if (custom.from == Moment.minValue) {
       final String formattedDate = custom.to
           .toMoment(localization: localization)
           .calendar(omitHours: custom.to.isMidnight, reference: anchor);
 
-      return localization.simpleRangeData.customRangeBefore(formattedDate);
+      return localization.simpleRangeData.allBefore(formattedDate);
     }
 
     final bool omitHours = custom.from.isMidnight && custom.to.isMidnight;

lib/src/localizations/mn_MN.dart

@@ -150,8 +150,8 @@ class LocalizationMnMn extends MomentLocalization
         thisYear: "Энэ жил",
         year: (range) => "${range.year} он",
         month: (range) => monthName(range.month),
-        customRangeAfter: (formattedDate) => "$formattedDate-с хойш",
-        customRangeBefore: (formattedDate) => "$formattedDate-с өмнө",
+        allAfter: (formattedDate) => "$formattedDate-с хойш",
+        allBefore: (formattedDate) => "$formattedDate-с өмнө",
         customRangeAllTime: "Бүх цаг үе",
       );
 }

lib/src/localizations/mn_Mong_MN.dart

@@ -184,8 +184,8 @@ class LocalizationMnMongMn extends MomentLocalization
         thisYear: "ᠡᠨᠡ ᠵᠢᠯ",
         year: (range) => "${range.year} ᠣᠨ",
         month: (range) => monthName(range.month),
-        customRangeAfter: (formattedDate) => "$formattedDate ᠡᠴᠡ ᠬᠣᠢᠢᠰᠢ",
-        customRangeBefore: (formattedDate) => "$formattedDate ᠡᠴᠡ ᠡᠮᠥᠨ᠎ᠡ",
+        allAfter: (formattedDate) => "$formattedDate ᠡᠴᠡ ᠬᠣᠢᠢᠰᠢ",
+        allBefore: (formattedDate) => "$formattedDate ᠡᠴᠡ ᠡᠮᠥᠨ᠎ᠡ",
         customRangeAllTime: "ᠪᠦᠬᠦ ᠴᠠᠭ ᠦᠢ᠎ᠡ",
       );
 }
@@ -290,8 +290,8 @@ class LocalizationMnQaaqMn extends LocalizationMnMongMn with Ordinal {
         thisYear: "ᠡᠨᠡ ᠵᠢᠯ",
         year: (range) => "${toTraditionalNumber(range.year.toString())} ᠣᠨ",
         month: (range) => monthName(range.month),
-        customRangeAfter: (formattedDate) => "$formattedDate ᠡᠴᠡ ᠬᠣᠢᠢᠰᠢ",
-        customRangeBefore: (formattedDate) => "$formattedDate ᠡᠴᠡ ᠡᠮᠥᠨ᠎ᠡ",
+        allAfter: (formattedDate) => "$formattedDate ᠡᠴᠡ ᠬᠣᠢᠢᠰᠢ",
+        allBefore: (formattedDate) => "$formattedDate ᠡᠴᠡ ᠡᠮᠥᠨ᠎ᠡ",
         customRangeAllTime: "ᠪᠦᠬᠦ ᠴᠠᠭ ᠦᠢ᠎ᠡ",
       );
 }

lib/src/localizations/pt_PT.dart

@@ -239,8 +239,8 @@ class LocalizationPtPt extends MomentLocalization
         thisYear: "Este ano",
         year: (range) => "Ano ${range.year}",
         month: (range) => monthNames[range.month]!,
-        customRangeAfter: (formattedDate) => "Após $formattedDate",
-        customRangeBefore: (formattedDate) => "Antes de $formattedDate",
+        allAfter: (formattedDate) => "Após $formattedDate",
+        allBefore: (formattedDate) => "Antes de $formattedDate",
         customRangeAllTime: "Todo o tempo",
       );
 }

lib/src/localizations/zh_CN.dart

@@ -211,8 +211,8 @@ class LocalizationZhCn extends MomentLocalization
         thisYear: "今年",
         year: (range) => "${range.year}年",
         month: (range) => monthNames[range.month]!,
-        customRangeAfter: (formattedDate) => "$formattedDate之后",
-        customRangeBefore: (formattedDate) => "$formattedDate之前",
+        allAfter: (formattedDate) => "$formattedDate之后",
+        allBefore: (formattedDate) => "$formattedDate之前",
         customRangeAllTime: "全部时间", // All time
       );
 }