Dart 非常详细日期的操作方法

发表于:2020-02-22

近期在研究 Dart 源码, 把关于 Date 这一块写个文章进行整理分享。

Dart 中操作日期通过 DateTime 类来实现。

由于 DateTimeDart 内置的,所以不需要导入。

解析

  • DateTime
  • DateTime.parse
  • DateTime.tryParse
  • DateTime.utc

解析一个日期可以通过 DateTime.parse 静态方法

一个典型的例子:

String str = '2020-02-20 22:48:18';
DateTime date = DateTime.parse(str);

print(date);  // 2020-02-20 22:48:18.000

parse 参数接收一个字符串, 能够被解析的有以下格式:

/**
  * "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);

取值

取得当前时间

DateTime n = DateTime.now();
print(n);   // 2020-02-20 23:05:04.332418

取得一个以毫秒时间戳

int t = DateTime.now().millisecondsSinceEpoch;
print(t);  // 1582211214849

取得一个以微秒时间戳

int t = DateTime.now().microsecondsSinceEpoch;
print(t);  // 1582211566844552

取得当前时区

String timeZone = DateTime.now().timeZoneName;
print(timeZone);

取得一周的星期几

int w = DateTime.now().weekday;
print(w);  // 4

取得当前时区的偏移时差 (北京时区是东八区,领先UTC八个小时)

Duration offset = DateTime.now().timeZoneOffset;
print(offset);    // 8:00:00.000000

取得当前年份

int year = DateTime.now().year;
print(year);      // 2020

取得当前月份 (1-12), 这跟JS里有点不同

int month = DateTime.now().month;
print(month);      // 2

取得当前月份的第几天 (1-31)

int day = DateTime.now().day;
print(day);      // 21

取得当前小时 (0-23)

int hour = DateTime.now().hour;
print(hour);      // 8

取得当前分钟 (0-59)

int minute = DateTime.now().minute;
print(minute);      // 18

取得当前秒 (0-59)

int second = DateTime.now().second;
print(second);      // 18

取得当前毫秒 (0-999)

int millisecond = DateTime.now().millisecond;
print(millisecond);      // 249

取得当前微秒 (0-999)

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.182096

toIso8601String 转换成 ISO 8601

String str = DateTime.now().toIso8601String();
print(str);   // 2020-02-22T22:12:30.159729

toLocal 在本地时区返回此DateTime值

DateTime date = DateTime.now().toLocal();
print(date);   // 2020-02-22 22:27:57.641258

toUtc 在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.000

subtract()add() 反向操作, 用法跟 add 一致,不再阐述。

查询

  • isBefore
  • isAfter
  • isAtSameMomentAs
  • compareTo

isBefore 检查一个 DateTime 是否在另一个 DateTime 之前

DateTime date1 = DateTime(2020);
DateTime date2 = DateTime(2019);

print(date1.isBefore(date2));   // false

isAfter 检查一个 DateTime 是否在另一个 DateTime 之后

DateTime date1 = DateTime(2020);
DateTime date2 = DateTime(2019);

print(date1.isAfter(date2));   // true

isAtSameMomentAs 如果此事件与other同时发生,则返回true.

DateTime date1 = DateTime(2020);
DateTime date2 = DateTime(2019);

print(date1.isAtSameMomentAs(date2));   // false

compareTo 判断2个 DateTime 是否相等,如果相等则返回 0 否则 -1

DateTime date1 = DateTime(2020);
DateTime date2 = DateTime(2020);

print(date1.compareTo(date2));   // 0

Flutter