Release v5.0.0 to master

README.md

@@ -3,12 +3,14 @@
 [![.github/workflows/release.yml](https://github.com/jama5262/jiffy/actions/workflows/release.yml/badge.svg)](https://github.com/jama5262/jiffy/actions/workflows/release.yml)
 [![codecov](https://codecov.io/gh/jama5262/jiffy/branch/master/graph/badge.svg?token=Z2EGVUGWTE)](https://codecov.io/gh/jama5262/jiffy)
 [![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](https://opensource.org/licenses/MIT)
-[![Pub Version](https://img.shields.io/badge/pub-v4.1.0-blue)](https://pub.dev/packages/jiffy)
-[![Platform](https://img.shields.io/badge/platform-flutter%7Cweb%7Cdart%20vm-orange)](https://github.com/jama5262/jiffy)
+[![Pub Version](https://img.shields.io/badge/pub-v5.0.0-blue)](https://pub.dev/packages/jiffy)
+![Platform](https://img.shields.io/badge/platform-flutter%7Cweb%7Cdart%20vm-orange)
 
 Jiffy is a Flutter (Android, IOS and Web) date time package inspired by [momentjs](https://momentjs.com/) for parsing, manipulating, querying and formatting dates
 
-### [Full Documentation](https://github.com/jama5262/jiffy/tree/v4.1.0/doc) | [Installation](https://pub.dev/packages/jiffy#-installing-tab-) | [ChangeLog](https://pub.dev/packages/jiffy#-changelog-tab-) | [Examples](https://pub.dev/packages/jiffy#-example-tab-)
+### [Full Documentation](doc) | [Installation](https://pub.dev/packages/jiffy#-installing-tab-) | [ChangeLog](https://pub.dev/packages/jiffy#-changelog-tab-) | [Examples](https://pub.dev/packages/jiffy#-example-tab-)
+
+#### [Follow the project board](https://github.com/jama5262/jiffy/projects/1)
 
 # Usage
 

doc/README.md

@@ -3,7 +3,7 @@
 [![.github/workflows/release.yml](https://github.com/jama5262/jiffy/actions/workflows/release.yml/badge.svg)](https://github.com/jama5262/jiffy/actions/workflows/release.yml)
 [![codecov](https://codecov.io/gh/jama5262/jiffy/branch/master/graph/badge.svg?token=Z2EGVUGWTE)](https://codecov.io/gh/jama5262/jiffy)
 [![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](https://opensource.org/licenses/MIT)
-[![Pub Version](https://img.shields.io/badge/pub-v4.1.0-blue)](https://pub.dev/packages/jiffy)
+[![Pub Version](https://img.shields.io/badge/pub-v5.0.0-blue)](https://pub.dev/packages/jiffy)
 [![Platform](https://img.shields.io/badge/platform-flutter%7Cweb%7Cdart%20vm-orange)](https://github.com/jama5262/jiffy)
 
 
@@ -75,8 +75,8 @@ Jiffy("2021-5-25"); // A calendar date part
 Jiffy("2021/5/25"); // A calendar date part separated by slash "/"
 Jiffy("2021525"); // Basic (short) full date
 Jiffy("2021-5-25 12:00:00.000"); // An hour, minute, second, and millisecond time part
-Jiffy("2021-5-25T12:00:00.000"); // ISO dart format
-Jiffy("2021-5-25T12:00:00.000Z"); // ISO dart format (UTC)
+Jiffy("2021-5-25T12:00:00.000"); // ISO date format
+Jiffy("2021-5-25T12:00:00.000Z"); // ISO date format (UTC)
 ```
 
 ### String Formatting
@@ -103,7 +103,7 @@ Jiffy("2021-5-25", "yyyy-MM-dd").yMMMMd; // May 25, 2021
 
 ### Maps
 You can also create a Jiffy from a Map, Supported key pairs are,
- 
+
 `[ year, month, day, hour, minute, second and millisecond ]`. See below
 ```dart
 Jiffy({
@@ -123,15 +123,15 @@ Jiffy({
 Jiffy can also parse timestamp milliseconds and seconds. Just call `Jiffy.unix()` which return a dart Datetime. See below
 ```dart
 // Parsing a timestamp in milliseconds
-Jiffy.unix(1318781876406);
+Jiffy.unixFromMillisecondsSinceEpoch(1318781876406);
 
 // Parsing a timestamp in seconds
-Jiffy.unix(1318781876).format(); // 2011-10-16T19:17:56.000
+Jiffy.unixFromSecondsSinceEpoch(1318781876).format(); // 2011-10-16T19:17:56.000
 ```
 
-**_Note: `Jiffy.unix()` returns a timestamp base on local time. You can also get it in UTC which returns a UTC in dart Datetime. See below_**
+**_Note: `Jiffy.unixFromMillisecondsSinceEpoch() or Jiffy.unixFromSecondsSinceEpoch` returns a timestamp base on local time. You can also get it in UTC which returns a UTC in dart Datetime. See below_**
 ```dart
-Jiffy.unix(1318781876406).utc();
+Jiffy.unixFromMillisecondsSinceEpoch(1318781876406).utc();
 ```
 
 ### Jiffy Cloning
@@ -542,6 +542,7 @@ Below are the locales that are supported in Jiffy. More will be added
 | Italian  | it / it_ch |
 | Korean  | ko |
 | Russian  | ru |
+| Ukrainian  | uk |
 | Hindi  | hi |
 | Arabic  | ar / ar_ly / ar_dz / ar_kw / ar_sa / ar_ma / ar_tn |
 | Portuguese  | pt / pt_br |
@@ -551,6 +552,8 @@ Below are the locales that are supported in Jiffy. More will be added
 | Norwegian | nb |
 | Persian | fa |
 | Azerbaijani | az |
+| Dutch | nl |
+| Thailand | th |
 
 Getting and setting locales in Jiffy **_always returns a future_**
 

example/jiffy_example.dart

@@ -1,5 +1,4 @@
 import 'package:jiffy/jiffy.dart';
-import 'package:jiffy/src/enums/units.dart';
 
 Future<int> main() async {
 //  DISPLAY

lib/src/jiffy.dart

@@ -22,14 +22,15 @@ class Jiffy {
     _initializeLocale();
   }
 
-  Jiffy.unix(int timestamp) {
-    var timestampLength = timestamp.toString().length;
-    if (timestampLength != 10 && timestampLength != 13) {
-      throw JiffyException(
-              'The timestamp passed must be in seconds or millisecods e.g. 1570963450 or 1570963450123')
-          .cause;
-    }
-    if (timestampLength == 10) timestamp *= 1000;
+  Jiffy.unixFromSecondsSinceEpoch(int timestamp) {
+    _unix(timestamp * 1000);
+  }
+
+  Jiffy.unixFromMillisecondsSinceEpoch(int timestamp) {
+    _unix(timestamp);
+  }
+
+  void _unix(int timestamp) {
     _dateTime = DateTime.fromMillisecondsSinceEpoch(timestamp);
   }
 

lib/src/locale/availableLocales.dart

@@ -12,14 +12,18 @@ import 'package:jiffy/src/locale/jaLocale.dart';
 import 'package:jiffy/src/locale/koLocale.dart';
 import 'package:jiffy/src/locale/locale.dart';
 import 'package:jiffy/src/locale/nbLocale.dart';
+import 'package:jiffy/src/locale/nlLocale.dart';
 import 'package:jiffy/src/locale/plLocale.dart';
 import 'package:jiffy/src/locale/ptLocale.dart';
 import 'package:jiffy/src/locale/ruLocale.dart';
+import 'package:jiffy/src/locale/thLocale.dart';
+import 'package:jiffy/src/locale/ukLocale.dart';
 import 'package:jiffy/src/locale/azLocale.dart';
 import 'package:jiffy/src/locale/svLocale.dart';
 import 'package:jiffy/src/locale/trLocale.dart';
 import 'package:jiffy/src/locale/zhCnLocale.dart';
 import 'package:jiffy/src/locale/zhLocale.dart';
+import 'package:jiffy/src/locale/bnLocale.dart';
 
 Map<String, Locale> _availableLocales = {
   'en': EnLocale(StartOfWeek.SUNDAY),
@@ -59,14 +63,18 @@ Map<String, Locale> _availableLocales = {
   'ja': JaLocale(StartOfWeek.SUNDAY),
   'ko': KoLocale(StartOfWeek.SUNDAY),
   'ru': RuLocale(StartOfWeek.MONDAY),
+  'uk': UkLocale(StartOfWeek.MONDAY),
   'hi': HiLocale(StartOfWeek.SUNDAY),
   'pt': PtLocale(StartOfWeek.MONDAY),
   'pt_br': PtLocale(StartOfWeek.SUNDAY),
   'pl': PlLocale(StartOfWeek.MONDAY),
   'tr': TrLocale(StartOfWeek.MONDAY),
-  'sv': SvLocale(StartOfWeek.SUNDAY),
-  'nb': NbLocale(StartOfWeek.SUNDAY),
+  'sv': SvLocale(StartOfWeek.MONDAY),
+  'nb': NbLocale(StartOfWeek.MONDAY),
   'fa': FaLocale(true, StartOfWeek.SATURDAY),
+  'bn': BnLocale(StartOfWeek.SUNDAY),
+  'nl': NlLocale(StartOfWeek.MONDAY),
+  'th': ThLocale(StartOfWeek.SUNDAY)
 };
 
 Locale getLocale(String locale) {

lib/src/locale/bnLocale.dart

@@ -0,0 +1,53 @@
+import 'package:jiffy/src/locale/locale.dart';
+import 'package:jiffy/src/locale/relativeTime.dart';
+import 'package:jiffy/src/enums/startOfWeek.dart';
+import 'package:jiffy/src/utils/replace.dart';
+
+class BnLocale extends Locale {
+  StartOfWeek strtOfWeek;
+  BnLocale(this.strtOfWeek);
+
+  @override
+  RelativeTime relativeTime() => BnRelativeTime();
+
+  @override
+  List<String>? ordinals() => null;
+
+  @override
+  StartOfWeek startOfWeek() => strtOfWeek;
+}
+
+class BnRelativeTime extends RelativeTime {
+  @override
+  String prefixAgo() => '';
+  @override
+  String prefixFromNow() => '';
+  @override
+  String suffixAgo() => 'আগে';
+  @override
+  String suffixFromNow() => 'পরে';
+  @override
+  String lessThanOneMinute(int seconds) => 'কিছু মুহূর্ত';
+  @override
+  String aboutAMinute(int minutes) => 'এক মিনিট';
+  @override
+  String minutes(int minutes) => replaceToLocaleNum('$minutes মিনিট', 'bn');
+  @override
+  String aboutAnHour(int minutes) => 'এক ঘন্টা';
+  @override
+  String hours(int hours) => replaceToLocaleNum('$hours ঘন্টা', 'bn');
+  @override
+  String aDay(int hours) => 'এক দিন';
+  @override
+  String days(int days) => replaceToLocaleNum('$days দিন', 'bn');
+  @override
+  String aboutAMonth(int days) => 'এক মাস';
+  @override
+  String months(int months) => replaceToLocaleNum('$months মাস', 'bn');
+  @override
+  String aboutAYear(int year) => 'এক বছর';
+  @override
+  String years(int years) => replaceToLocaleNum('$years বছর', 'bn');
+  @override
+  String wordSeparator() => ' ';
+}

lib/src/locale/nlLocale.dart

@@ -0,0 +1,53 @@
+import 'package:jiffy/src/locale/locale.dart';
+import 'package:jiffy/src/locale/relativeTime.dart';
+import 'package:jiffy/src/enums/startOfWeek.dart';
+
+class NlLocale extends Locale {
+  StartOfWeek strtOfWeek;
+  NlLocale(this.strtOfWeek);
+
+  @override
+  RelativeTime relativeTime() => NlRelativeTime();
+
+  @override
+  List<String>? ordinals() => ['.', '.', '.', '.'];
+
+  @override
+  StartOfWeek startOfWeek() => strtOfWeek;
+}
+
+class NlRelativeTime extends RelativeTime {
+  @override
+  String prefixAgo() => '';
+  @override
+  String prefixFromNow() => '';
+  @override
+  String suffixAgo() => 'geleden';
+  @override
+  String suffixFromNow() => '';
+  @override
+  String lessThanOneMinute(int seconds) =>
+      seconds > 0 ? 'op dit moment' : 'een ogenblik';
+  @override
+  String aboutAMinute(int minutes) => 'een minuut';
+  @override
+  String minutes(int minutes) => '$minutes minuten';
+  @override
+  String aboutAnHour(int minutes) => 'een uur';
+  @override
+  String hours(int hours) => '$hours uur';
+  @override
+  String aDay(int hours) => 'een dag';
+  @override
+  String days(int days) => '$days dagen';
+  @override
+  String aboutAMonth(int days) => 'een maand';
+  @override
+  String months(int months) => '$months maanden';
+  @override
+  String aboutAYear(int year) => 'een jaar';
+  @override
+  String years(int years) => '$years jaar';
+  @override
+  String wordSeparator() => ' ';
+}

lib/src/locale/thLocale.dart

@@ -0,0 +1,52 @@
+import 'package:jiffy/src/locale/locale.dart';
+import 'package:jiffy/src/locale/relativeTime.dart';
+import 'package:jiffy/src/enums/startOfWeek.dart';
+
+class ThLocale extends Locale {
+  StartOfWeek strtOfWeek;
+  ThLocale(this.strtOfWeek);
+
+  @override
+  RelativeTime relativeTime() => ThRelativeTime();
+
+  @override
+  List<String>? ordinals() => null;
+
+  @override
+  StartOfWeek startOfWeek() => strtOfWeek;
+}
+
+class ThRelativeTime extends RelativeTime {
+  @override
+  String prefixAgo() => '';
+  @override
+  String prefixFromNow() => 'อีก';
+  @override
+  String suffixAgo() => 'ที่แล้ว';
+  @override
+  String suffixFromNow() => '';
+  @override
+  String lessThanOneMinute(int seconds) => 'ไม่กี่วินาที';
+  @override
+  String aboutAMinute(int minutes) => '1 นาที';
+  @override
+  String minutes(int minutes) => '$minutes นาที';
+  @override
+  String aboutAnHour(int minutes) => '1 ชั่วโมง';
+  @override
+  String hours(int hours) => '$hours ชั่วโมง';
+  @override
+  String aDay(int hours) => '1 วัน';
+  @override
+  String days(int days) => '$days วัน';
+  @override
+  String aboutAMonth(int days) => '1 เดือน';
+  @override
+  String months(int months) => '$months เดือน';
+  @override
+  String aboutAYear(int year) => '1 ปี';
+  @override
+  String years(int years) => '$years ปี';
+  @override
+  String wordSeparator() => '';
+}