DayDart：具备 Moment.js 一样 API 的 Flutter 时间处理库

DayDart

A new Flutter package project.

Getting Started

This project is a starting point for a Dart package , a library module containing code that can be shared easily across multiple Flutter or Dart projects.

For help getting started with Flutter, view our online documentation , which offers tutorials, samples, guidance on mobile development, and a full API reference.

API

DayDart 对象是不可变的，所有的调用都将返回一个新的 DayDart 对象。

解析

在 DayDart 中传入支持的格式。

当前时间

直接运行 DayDart 获取当前时间和日期的 DayDart 对象。

DayDart()

原生创建

可以像 DateTime 一样的创建 DayDart 对象

DayDart(2019,12,12);

时间字符串

传入的一个标准的ISO 8601时间字符串。

DayDart.fromString('2019-02-21');

DateTime 对象

传入的一个 DateTime 对象。

DayDart.fromDateTime(new DateTime.now());

复制

DayDart 对象是不可变的，因此可以执行 .clone() 来获取一个 DayDart 对象的拷贝。

DayDart().clone();

验证

• return bool

检测当前的 DayDart 对象是否是一个有效的时间。

DayDart().isValid();

获取

获取日期

年

• return int

获取年份。

DayDart().year();

月

• return int

获取月份

DayDart().month();

日

• return int

获取日期。

DayDart().date();

星期

• return int

获取星期。

DayDart().day();

时

• return int

获取小时。

DayDart().hour();

分

• return int

获取分钟。

DayDart().minute();

秒

• return int

获取秒。

DayDart().second();

毫秒

• return int

获取毫秒。

DayDart().millisecond();

操作

我们可以对 DayDart 对象增加如下的操作：

DayDart().add(2, Units.H).subtract(13, Units.M);

增加

为时间日期进行增加并返回一个新的 DayDart 对象。

DayDart().add(2, Units.H);

减少

为时间日期进行减少并返回一个新的 DayDart 对象。

DayDart().subtract(13, Units.M)

查询

Value 系列比对详情如下：

enum	Output
Units.Y	bool
Units.M	bool
Units.D	bool
Units.H	bool
Units.MIN	bool

是否相等

• return bool

检查另外一个 DayDart 对象是否与当前 DayDart 对象的时间相等。

DayDart().isSame(daydart);

• return bool

DayDart().isSameValue(2019, Units.Y);

是否之前

• return bool

检查另外一个 DayDart 对象是否在当前 DayDart 对象时间之前。

DayDart().isBefore(daydart);

• return bool

DayDart().isBeforeValue(2019, Units.Y);

是否之后

• return bool

检查另外一个 DayDart 对象是否在当前 DayDart 对象时间之后。

DayDart().isAfter(daydart);

• return bool

DayDart().isAfterValue(2019, Units.Y);

判断是否为 DayDart

DayDart.isDayDart(daydart)

显示

格式化 DayDart 对象并展示。

格式化

• return String

DayDart().format(fm: 'YYYY-MM-DD HH:mm:ss');

详情如下：

Format	Output	Description
YY	19	两位数的年份
YYYY	2019	四位数的年份
M	1-12	月份，从 1 开始
MM	01-12	月份，两位数
D	1-31	月份里的一天
DD	01-31	月份里的一天，两位数
H	0-23	小时
HH	00-23	小时，两位数
m	0-59	分钟
mm	00-59	分钟，两位数
s	0-59	秒
ss	00-59	秒，两位数
a	am pm
A	AM PM

DateTime 对象

• return DateTime

返回原生 DateTime 对象

DayDart().toDateTime();

ISO 8601 字符串

• return String

返回 ISO8601 格式的字符串。

DayDart().toISOString();

List

• return List

返回包含时间数值的 List。

DayDart().toList();

Map

• return Map<String, int>

返回包含时间数值的 Map。

DayDart().toMap();

字符串

• return String

DayDart().toString();