近期在研究 Dart 源码， 把关于 Date 这一块写个文章进行整理分享。
在 Dart 中操作日期通过 DateTime 类来实现。
由于 DateTime 是 Dart 内置的，所以不需要导入。
解析
- DateTime
- DateTime.parse
- DateTime.tryParse
- DateTime.utc
解析一个日期可以通过 DateTime.parse 静态方法
一个典型的例子：
代码语言：javascript复制String str = '2020-02-20 22:48:18';
DateTime date = DateTime.parse(str);
print(date); // 2020-02-20 22:48:18.000parse 参数接收一个字符串, 能够被解析的有以下格式：
/**
* "2012-02-27 13:27:00"
* "2012-02-27 13:27:00.123456789z"
* "2012-02-27 13:27:00,123456789z"
* "20120227 13:27:00"
* "20120227T132700"
* "20120227"
* " 20120227"
* "2012-02-27T14Z"
* "2012-02-27T14 00:00"
* "-123450101 00:00:00 Z"
* "2002-02-27T14:00:00-0500"
*/parse 方法还有一个对应的 tryParse 的静态方法, 实际上就是 parse 的语法糖
tryParse 如果接收的参数无法被解析那么不会抛出异常，而是返回 null
tryParse 的内部实现原理：
try {
return parse(formattedString);
} on FormatException {
return null;
}还可以通过 DateTime 实例进行解析, 可以接收8个参数，第一个是年份必填，剩余的是选填，如下：
/**
* DateTime(int year,
* [int month = 1,
* int day = 1,
* int hour = 0,
* int minute = 0,
* int second = 0,
* int millisecond = 0,
* int microsecond = 0])
*/
DateTime date = DateTime(2020);
// 2020年2月22日 22小时22分22秒
DateTime date2 = DateTime(2020, 2, 22, 22, 22, 22);如果想解析成 utc , 可以调用它的静态方法，参数和 DateTime 一致
DateTime date1 = DateTime.utc(2020, 2, 22, 22, 22, 22);取值
取得当前时间
代码语言：javascript复制DateTime n = DateTime.now();
print(n); // 2020-02-20 23:05:04.332418取得一个以毫秒时间戳
代码语言：javascript复制int t = DateTime.now().millisecondsSinceEpoch;
print(t); // 1582211214849取得一个以微秒时间戳
代码语言：javascript复制int t = DateTime.now().microsecondsSinceEpoch;
print(t); // 1582211566844552取得当前时区
代码语言：javascript复制String timeZone = DateTime.now().timeZoneName;
print(timeZone);取得一周的星期几
代码语言：javascript复制int w = DateTime.now().weekday;
print(w); // 4取得当前时区的偏移时差 （北京时区是东八区，领先UTC八个小时）
代码语言：javascript复制Duration offset = DateTime.now().timeZoneOffset;
print(offset); // 8:00:00.000000取得当前年份
代码语言：javascript复制int year = DateTime.now().year;
print(year); // 2020取得当前月份 （1-12）, 这跟JS里有点不同
代码语言：javascript复制int month = DateTime.now().month;
print(month); // 2取得当前月份的第几天 （1-31）
代码语言：javascript复制int day = DateTime.now().day;
print(day); // 21取得当前小时 （0-23）
代码语言：javascript复制int hour = DateTime.now().hour;
print(hour); // 8取得当前分钟 （0-59）
代码语言：javascript复制int minute = DateTime.now().minute;
print(minute); // 18取得当前秒 （0-59）
代码语言：javascript复制int second = DateTime.now().second;
print(second); // 18取得当前毫秒 （0-999）
代码语言：javascript复制int millisecond = DateTime.now().millisecond;
print(millisecond); // 249取得当前微秒 （0-999）
代码语言：javascript复制int microsecond = DateTime.now().microsecond;
print(microsecond); // 249显示
- toString
- toIso8601String
- toLocal
- toUtc
toString 要把一个 DateTime 转换成时间可以使用 toString 方法
String str = DateTime.now().toString();
print(str); // 2020-02-22 01:01:01.182096toIso8601String 转换成 ISO 8601
String str = DateTime.now().toIso8601String();
print(str); // 2020-02-22T22:12:30.159729toLocal 在本地时区返回此DateTime值
DateTime date = DateTime.now().toLocal();
print(date); // 2020-02-22 22:27:57.641258toUtc 在UTC时区中返回此DateTime值
DateTime date = DateTime.now().toUtc();
print(date); // 2020-02-22 03:27:09.564188Z操作
- add() 通过增加时间来改变原始的 DateTime
- subtract() 通过减去时间来改变原始的 DateTime
add() 参数接收的是 Duration 类型, 下面例子由原来的 0小时 新增了 1小时
Duration oneHours = Duration(hours: 1);
String date = DateTime(2020).add(oneHours).toString();
print(date); // 2020-01-01 01:00:00.000subtract() 是 add() 反向操作, 用法跟 add 一致，不再阐述。
查询
- isBefore
- isAfter
- isAtSameMomentAs
- compareTo
isBefore 检查一个 DateTime 是否在另一个 DateTime 之前
DateTime date1 = DateTime(2020);
DateTime date2 = DateTime(2019);
print(date1.isBefore(date2)); // falseisAfter 检查一个 DateTime 是否在另一个 DateTime 之后
DateTime date1 = DateTime(2020);
DateTime date2 = DateTime(2019);
print(date1.isAfter(date2)); // trueisAtSameMomentAs 如果此事件与other同时发生，则返回true.
代码语言：javascript复制DateTime date1 = DateTime(2020);
DateTime date2 = DateTime(2019);
print(date1.isAtSameMomentAs(date2)); // falsecompareTo 判断2个 DateTime 是否相等，如果相等则返回 0 否则 -1
DateTime date1 = DateTime(2020);
DateTime date2 = DateTime(2020);
print(date1.compareTo(date2)); // 0
