Flutter尼泊尔语工具插件nepali_utils的使用

简介

nepali_utils 是一个用于Dart语言的纯Dart包，它提供了一系列与尼泊尔语相关的实用工具。这些工具包括日期转换、日期格式化、数字格式化、Unicode转换等。该库可以帮助开发者轻松处理尼泊尔语相关的内容，尤其是在开发涉及尼泊尔语的应用时非常有用。

版本信息和许可

主要功能类

1. NepaliDateTime：类似 dart:core 的 DateTime 类，但使用的是尼泊尔历（Bikram Sambat）。
2. DateConversion：用于AD和BS之间的日期转换。
3. NepaliDateFormat：格式化 NepaliDateTime。
4. NepaliNumberFormat：将英文数字转换为尼泊尔文数字。
5. NepaliUnicode：将罗马字母转换为尼泊尔文Unicode。
6. NepaliMoment：生成模糊的时间戳。

使用示例

以下是一个完整的Flutter应用示例，展示了如何使用 nepali_utils 包中的各个功能：

import 'package:flutter/material.dart';
import 'package:nepali_utils/nepali_utils.dart';

void main() {
  runApp(MyApp());
}

class MyApp extends StatelessWidget {
  @override
  Widget build(BuildContext context) {
    return MaterialApp(
      home: Scaffold(
        appBar: AppBar(title: Text('nepali_utils 示例')),
        body: NepaliUtilsExample(),
      ),
    );
  }
}

class NepaliUtilsExample extends StatelessWidget {
  final gorkhaEarthQuake = NepaliDateTime.parse('2072-01-12T11:56:25');
  final nt = DateTime(2019, 5, 14).toNepaliDateTime();
  final dt = nt.toDateTime();

  @override
  Widget build(BuildContext context) {
    return Padding(
      padding: const EdgeInsets.all(16.0),
      child: ListView(
        children: <Widget>[
          heading('Nepali Date Time'),
          text('Gorkha Earthquake Details\nYear = ${gorkhaEarthQuake.year}\nMonth = ${gorkhaEarthQuake.month}\nDay = ${gorkhaEarthQuake.day}\nHour = ${gorkhaEarthQuake.hour}\nMinute = ${gorkhaEarthQuake.minute}'),
          text('\nCurrent NepaliDateTime = ${NepaliDateTime.now()}'),

          heading('Date Converter'),
          text('In BS = $nt'),
          text('In AD = $dt'),

          heading('Nepali Date Formatter'),
          text(NepaliDateFormat("yyyy.MM.dd G 'at' HH:mm:ss").format(gorkhaEarthQuake)),
          text(NepaliDateFormat("EEE, MMM d, ''yy").format(gorkhaEarthQuake)),
          text(NepaliDateFormat('h:mm a').format(gorkhaEarthQuake)),
          text(NepaliDateFormat("hh 'o''clock' aa").format(gorkhaEarthQuake)),
          text(NepaliDateFormat('yyyy.MMMM.dd GGG hh:mm a').format(gorkhaEarthQuake)),

          heading('Nepali Number Format'),
          text('123456 -> ${NepaliNumberFormat(symbol: 'Rs.').format(123456)}'),
          text('123456789.6548 -> ${NepaliNumberFormat(decimalDigits: 2).format(123456789.6548)}'),
          text('123456 -> ${NepaliNumberFormat(inWords: true, language: Language.nepali).format(123456)}'),
          text('123456789.6548 -> ${NepaliNumberFormat(inWords: true, language: Language.nepali, isMonetory: true).format(123456789.6548)}'),

          heading('Nepali Unicode'),
          text(NepaliUnicode.convert("sayau' thu''gaa fUlakaa haamii, euTai maalaa nepaalii")),
          text(NepaliUnicode.convert('saarwabhauma bhai failiekaa, mecii-mahaakaalii\n')),

          heading('Nepali Moment'),
          text(NepaliMoment.fromBS(NepaliDateTime.parse('2076-03-22T08:41:14')).toString()),
          text(NepaliMoment.fromAD(DateTime.parse('2019-06-02T18:22:14'), referenceDate: DateTime.parse('2019-06-15T18:34:14')).toString()),
        ],
      ),
    );
  }

  Widget heading(String text) {
    return Padding(
      padding: const EdgeInsets.symmetric(vertical: 8.0),
      child: Text(text, style: TextStyle(fontSize: 18, fontWeight: FontWeight.bold)),
    );
  }

  Widget text(String content) {
    return Padding(
      padding: const EdgeInsets.symmetric(vertical: 4.0),
      child: Text(content),
    );
  }
}

说明

1. Nepali Date Time：

   • 使用 NepaliDateTime 类来表示尼泊尔历日期，并可以解析和格式化日期。

2. Date Converter：

   • 将公历（AD）日期转换为尼泊尔历（BS）日期，反之亦然。

3. Nepali Date Formatter：

   • 使用 NepaliDateFormat 类来格式化 NepaliDateTime 对象，支持多种格式化模式。

4. Nepali Number Format：

   • 使用 NepaliNumberFormat 类将数字转换为尼泊尔文表示形式，支持货币符号、千位分隔符以及金额转大写等功能。

5. Nepali Unicode：

   • 使用 NepaliUnicode 类将罗马字母转换为尼泊尔文Unicode字符。

6. Nepali Moment：

   • 使用 NepaliMoment 类生成模糊时间戳，例如“几分钟前”或“几天后”。

安装

在 pubspec.yaml 文件中添加依赖项：

dependencies:
  nepali_utils: ^latest_version

然后运行 flutter pub get 来安装包。

总结

nepali_utils 提供了丰富的功能来处理尼泊尔语内容，适用于需要支持尼泊尔语的应用程序。通过上述示例代码，您可以快速上手并集成到您的Flutter项目中。