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 对象。

• 解析
  • 当前时间
  • 原生创建
  • 时间字符串
  • DateTime 对象
  • 复制
  • 验证
• 获取
  • 年
  • 月
  • 日
  • 星期
  • 时
  • 分
  • 秒
  • 毫秒
• 操作
  • 增加
  • 减少
• 查询
  • 是否相等
  • 是否之前
  • 是否之后
  • 判断是否为 DayDart
• 显示
  • 格式化
  • DateTime 对象
  • ISO 8601 字符串
  • List
  • Map
  • 字符串

---

解析

在 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();