Add extensions on DateTime and List

pkgs/intl4x/CHANGELOG.md

@@ -1,3 +1,7 @@
+## 0.10.2-wip
+
+- Add examples of extensions to `List` and `DateTime` formatting.
+
 ## 0.10.1
 
 - Upgrade to new artifacts.

pkgs/intl4x/lib/datetime_format.dart

@@ -2,6 +2,16 @@
 // for details. All rights reserved. Use of this source code is governed by a
 // BSD-style license that can be found in the LICENSE file.
 
+import 'intl4x.dart';
+
 export 'src/datetime_format/datetime_format.dart';
 export 'src/datetime_format/datetime_format_options.dart';
 export 'src/options.dart';
+
+extension DateTimeFormatIntl4x on DateTime {
+  /// Format a date in a locale-dependent manner.
+  ///
+  /// For more options, use [Intl.datetimeFormat] directly.
+  String toLocaleDateString([Locale? locale]) =>
+      Intl(locale: locale).datetimeFormat().format(this);
+}

pkgs/intl4x/lib/list_format.dart

@@ -2,6 +2,38 @@
 // for details. All rights reserved. Use of this source code is governed by a
 // BSD-style license that can be found in the LICENSE file.
 
+import 'intl4x.dart';
+import 'src/list_format/list_format_options.dart';
+
 export 'src/list_format/list_format.dart';
 export 'src/list_format/list_format_options.dart';
 export 'src/options.dart';
+
+extension ListFormatIntl4x on List<String> {
+  /// Join a list in a locale-dependent manner using `and`-based grouping.
+  ///
+  /// Example: "A, B, and C". See also [Type.and].
+  ///
+  /// For more options, use [Intl.listFormat] directly.
+  String joinAnd([Locale? locale]) => Intl(locale: locale)
+      .listFormat(const ListFormatOptions(type: Type.and))
+      .format(this);
+
+  /// Join a list in a locale-dependent manner using `or`-based grouping.
+  ///
+  /// Example: "A, B, or C". See also [Type.or].
+  ///
+  /// For more options, use [Intl.listFormat] directly.
+  String joinOr([Locale? locale]) => Intl(locale: locale)
+      .listFormat(const ListFormatOptions(type: Type.or))
+      .format(this);
+
+  /// Join a list in a locale-dependent manner using unit-based grouping.
+  ///
+  /// Example: "A, B, C". See also [Type.unit].
+  ///
+  /// For more options, use [Intl.listFormat] directly.
+  String joinUnit([Locale? locale]) => Intl(locale: locale)
+      .listFormat(const ListFormatOptions(type: Type.or))
+      .format(this);
+}

pkgs/intl4x/pubspec.yaml

@@ -1,7 +1,7 @@
 name: intl4x
 description: >-
   A lightweight modular library for internationalization (i18n) functionality.
-version: 0.10.1
+version: 0.10.2-wip
 repository: https://github.com/dart-lang/i18n/tree/main/pkgs/intl4x
 platforms:
   web:

pkgs/intl4x/test/datetime_format_test.dart

@@ -166,4 +166,14 @@ void main() {
     },
     tags: ['icu4xUnimplemented'],
   );
+  testWithFormatting(
+    'Extension',
+    () {
+      expect(
+          DateTime.utc(2012, 12, 20, 3, 0, 0)
+              .toLocaleDateString(const Locale(language: 'en', region: 'US')),
+          '12/20/2012');
+    },
+    tags: ['icu4xUnimplemented'],
+  );
 }

pkgs/intl4x/test/list_format_test.dart

@@ -3,15 +3,16 @@
 // BSD-style license that can be found in the LICENSE file.
 
 import 'package:intl4x/intl4x.dart';
-import 'package:intl4x/src/list_format/list_format_options.dart';
+import 'package:intl4x/list_format.dart';
 import 'package:test/test.dart';
 
 import 'utils.dart';
 
 void main() {
+  final list = ['A', 'B', 'C'];
+  const enUS = Locale(language: 'en', region: 'US');
+  final intl = Intl(locale: enUS);
   group('List style options', () {
-    final list = ['A', 'B', 'C'];
-    final intl = Intl(locale: const Locale(language: 'en', region: 'US'));
     testWithFormatting('long', () {
       final listFormat =
           intl.listFormat(const ListFormatOptions(style: ListStyle.long));
@@ -30,8 +31,6 @@ void main() {
   });
 
   group('List type options', () {
-    final list = ['A', 'B', 'C'];
-    final intl = Intl(locale: const Locale(language: 'en', region: 'US'));
     testWithFormatting('long', () {
       final listFormat =
           intl.listFormat(const ListFormatOptions(type: Type.and));
@@ -50,8 +49,6 @@ void main() {
   });
 
   group('List style and type combinations', () {
-    final list = ['A', 'B', 'C'];
-    final intl = Intl(locale: const Locale(language: 'en', region: 'US'));
     testWithFormatting('long', () {
       final formatter = intl.listFormat(
           const ListFormatOptions(style: ListStyle.narrow, type: Type.and));
@@ -63,4 +60,10 @@ void main() {
       expect(formatter.format(list), 'A, B, C');
     });
   });
+
+  testWithFormatting('extension', () {
+    expect(list.joinAnd(enUS), 'A, B, and C');
+    expect(list.joinOr(enUS), 'A, B, or C');
+    expect(list.joinUnit(enUS), 'A, B, C');
+  });
 }