Flutter 常用工具類庫common_utils

地址：https://pub.flutter-io.cn/packages/common_utils#-readme-tab-

Dart常用工具類庫 common_utils

1、TimelineUtil : 時間軸.(新)
2、TimerUtil : 倒計時，定時任務.(新)
3、MoneyUtil : 精確轉換，元轉分，分轉元，支持格式輸出.(新)
4、LogUtil : 簡單封裝打印日志.(新)
5、DateUtil : 日期轉換格式化輸出.
6、RegexUtil : 正則驗證手機號，身份證，郵箱等等.
7、NumUtil : 保留x位小數, 精確加、減、乘、除, 防止精度丟失.
8、ObjectUtil : 判斷對象是否為空(String List Map),判斷兩個List是否相等.

Flutter工具類庫 flustars

1、DioUtil : Dio 工具類.
2、SpUtil : 單例"同步" SharedPreferences 工具類.
3、ScreenUtil : 屏幕適配，獲取屏幕寬、高、密度，AppBar高，狀態欄高度，屏幕方向.
4、WidgetUtil : Widget渲染監聽，獲取Widget寬高，在屏幕上的坐標.

Add dependency #

dependencies:  common_utils: x.x.x #latest version 

APIs #

• TimelineUtil -> Example

///(xx)為可配置輸出 enum DayFormat { ///(小於10s->剛剛)、x分鍾、x小時、(昨天)、x天. Simple, ///(小於10s->剛剛)、x分鍾、x小時、[今年: (昨天/1天前)、(2天前)、MM-dd],[往年: yyyy-MM-dd]. Common, ///小於10s->剛剛)、x分鍾、x小時、[今年: (昨天 HH:mm/1天前)、(2天前)、MM-dd HH:mm],[往年: yyyy-MM-dd HH:mm]. Full, } ///Timeline信息配置. abstract class TimelineInfo { String suffixAgo(); //suffix ago(后綴 后). String suffixAfter(); //suffix after(后綴 前). String lessThanTenSecond() => ''; //just now(剛剛). String customYesterday() => ''; //Yesterday(昨天).優先級高於keepOneDay bool keepOneDay(); //保持1天,example: true -> 1天前, false -> MM-dd. bool keepTwoDays(); //保持2天,example: true -> 2天前, false -> MM-dd. String oneMinute(int minutes); //a minute(1分鍾). String minutes(int minutes); //x minutes(x分鍾). String anHour(int hours); //an hour(1小時). String hours(int hours); //x hours(x小時). String oneDay(int days); //a day(1天). String days(int days); //x days(x天). DayFormat dayFormat(); //format. } setLocaleInfo : 自定義設置配置信息. formatByDateTime : 格式輸出時間軸信息 by DateTime . format : 格式輸出時間軸信息. 

• TimerUtil -> Example

setInterval                 : 設置Timer間隔.
setTotalTime                : 設置倒計時總時間.
startTimer()                : 啟動定時Timer.
startCountDown              : 啟動倒計時Timer.
updateTotalTime             : 重設倒計時總時間.
cancel                      : 取消計時器.
setOnTimerTickCallback      : 計時器回調.
isActive                    : Timer是否啟動.

• MoneyUtil 精確轉換,防止精度丟失 -> Example

changeF2Y                   : 分 轉 元, format格式輸出.
changeFStr2YWithUnit        : 分字符串 轉 元, format 與 unit 格式 輸出.
changeF2YWithUnit           : 分 轉 元, format 與 unit 格式 輸出.
changeYWithUnit             : 元, format 與 unit 格式 輸出.
changeY2F                   : 元 轉 分.

• LogUtil #

init(isDebug, tag) : isDebug: 模式, tag 標簽. e(object, tag) : 日志e v(object, tag) : 日志v，只在debug模式輸出. 

• NumUtil -> Example

getIntByValueStr            : 數字字符串轉int. getDoubleByValueStr : 數字字符串轉double. getNumByValueStr : 保留x位小數 by 數字字符串. getNumByValueDouble : 保留x位小數 by double. add : 加(精確相加,防止精度丟失). subtract : 減(精確相減,防止精度丟失). multiply : 乘(精確相乘,防止精度丟失). divide : 除(精確相除,防止精度丟失). remainder : 余. lessThan : < . thanOrEqual : <= . greaterThan : > . greaterOrEqual : >= . 

• DateUtil -> Example

enum DateFormat { DEFAULT, //yyyy-MM-dd HH:mm:ss.SSS NORMAL, //yyyy-MM-dd HH:mm:ss YEAR_MONTH_DAY_HOUR_MINUTE, //yyyy-MM-dd HH:mm YEAR_MONTH_DAY, //yyyy-MM-dd YEAR_MONTH, //yyyy-MM MONTH_DAY, //MM-dd MONTH_DAY_HOUR_MINUTE, //MM-dd HH:mm HOUR_MINUTE_SECOND, //HH:mm:ss HOUR_MINUTE, //HH:mm ZH_DEFAULT, //yyyy年MM月dd日 HH時mm分ss秒SSS毫秒 ZH_NORMAL, //yyyy年MM月dd日 HH時mm分ss秒 / timeSeparate: ":" --> yyyy年MM月dd日 HH:mm:ss ZH_YEAR_MONTH_DAY_HOUR_MINUTE, //yyyy年MM月dd日 HH時mm分 / timeSeparate: ":" --> yyyy年MM月dd日 HH:mm ZH_YEAR_MONTH_DAY, //yyyy年MM月dd日 ZH_YEAR_MONTH, //yyyy年MM月 ZH_MONTH_DAY, //MM月dd日 ZH_MONTH_DAY_HOUR_MINUTE, //MM月 dd日 HH時mm分 / timeSeparate: ":" --> MM月dd日 HH:mm ZH_HOUR_MINUTE_SECOND, //HH時mm分ss秒 ZH_HOUR_MINUTE, //HH時mm分 } getNowDateMs : 獲取現在 毫秒. getNowDateStr : 獲取現在 日期字符串.(yyyy-MM-dd HH:mm:ss) getDateMsByTimeStr : 獲取毫秒 By 日期字符串(Format格式輸出). getDateStrByTimeStr : 獲取日期字符串 By 日期字符串(Format格式輸出). getDateStrByMs : 獲取日期字符串 By 毫秒(Format格式輸出). getDateStrByDateTime : 獲取日期字符串 By DateTime(Format格式輸出). getWeekDay : 獲取WeekDay By DateTime. getZHWeekDay : 獲取星期 By DateTime. getWeekDayByMs : 獲取WeekDay By 毫秒. getZHWeekDayByMs : 獲取星期 By 毫秒. isLeapYearByYear : 是否是閏年. yearIsEqual : 是否同年. getDayOfYear : 在今年的第幾天. isYesterday : 是否是昨天. isToday : 是否是今天. 

• RegexUtil -> Example

isMobileSimple            : 簡單驗證手機號
isMobileExact             : 精確驗證手機號
isTel                     : 驗證電話號碼
isIDCard                  : 驗證身份證號碼
isIDCard15                : 驗證身份證號碼 15 位
isIDCard18                : 簡單驗證身份證號碼 18 位
isIDCard18Exact           : 精確驗證身份證號碼 18 位
isEmail                   : 驗證郵箱
isURL                     : 驗證 URL
isZh                      : 驗證漢字
isDate                    : 驗證 yyyy-MM-dd 格式的日期校驗，已考慮平閏年
isIP                      : 驗證 IP 地址

• ObjectUtil -> Example

isEmptyString             : 判斷String是否為空. isEmptyList : 判斷List是否為空. isEmptyMap : 判斷Map是否為空. isEmpty : 判斷對象是否為空.(String List Map). isNotEmpty : 判斷對象是否非空.(String List Map). twoListIsEqual : 判斷兩個List是否相等. 

Example #

// Import package import 'package:common_utils/common_utils.dart'; //TimelineUtil DateTime xxxDateTime = DateTime(2018, 6, 16, 16, 16, 16); LogUtil.e("Timeline: " + TimelineUtil.formatByDateTime(xxxDateTime, locale: 'zh').toString()); //MoneyUtil example String moneyTxt = MoneyUtil.changeFStr2YWithUnit("1160", format: MoneyFormat.NORMAL, unit: MoneyUnit.YUAN_ZH); String moneyTxt = MoneyUtil.changeYWithUnit("1.66", unit: MoneyUnit.YUAN_ZH); //TimerUtil example TimerUtil timerUtil; //定時任務test timerUtil = new TimerUtil(mInterval: 1000); //timerUtil.setInterval(1000); timerUtil.setOnTimerTickCallback((int value) { LogUtil.e("TimerTick: " + value.toString()); }); timerUtil.startTimer(); //timerUtil.cancel(); TimerUtil timerCountDown; //倒計時test timerCountDown = new TimerUtil(mInterval: 1000, mTotalTime: 3 * 1000); // timerCountDown.setInterval(1000); // timerCountDown.setTotalTime(3 * 1000); timerCountDown.setOnTimerTickCallback((int value) { double tick = (value / 1000); LogUtil.e("CountDown: " + tick.toInt().toString()); }); timerCountDown.startCountDown(); //timerUtil.cancel(); //LogUtil example LogUtil.init(isDebug: true, tag: "test"); LogUtil.e("...log...", tag: "test"); LogUtil.v("...log...", tag: "test"); //DateUtil example String timeNow = DateUtil.getDateStrByDateTime(DateTime.now());//2018-09-16 23:14:56 String timeNow = DateUtil.getDateStrByDateTime(DateTime.now(),format: DateFormat.ZH_NORMAL);//2018年09月16日 23時16分15秒 String weekday = DateUtil.getWeekDay(DateTime.parse("2018-09-16"));//Sunday String weekdayZh = DateUtil.getZHWeekDay(DateTime.parse("2018-09-16"));//星期日 //First Page init. Notice!!! ScreenUtil.getInstance().init(context); ScreenUtil.screenWidth ScreenUtil.screenHeight ScreenUtil.statusBarHeight ScreenUtil.screenDensity List listA = ["A", "B", "C"]; List listB = ["A", "B", "C"]; print("Two List Is Equal: " + ObjectUtil.twoListIsEqual(listA, listB).toString()); // Global variable，Reference example WidgetUtil widgetUtil = new WidgetUtil(); @override Widget build(BuildContext context) { widgetUtil.asyncPrepare(context, false, (Rect rect) { double width = rect.width; double height = rect.height; }); return ; } //Widgets must be rendered completely. Otherwise return Rect.zero. Rect rect = WidgetUtil.getWidgetBounds(context); double width = rect.width; double height = rect.height; //Widgets must be rendered completely. Otherwise return Offset.zero. Offset offset = WidgetUtil.getWidgetLocalToGlobal(context); double dx = offset.dx double dx = offset.dy