DateTime 类

时间的具体瞬间，例如1969年7月20日，晚上8:18 GMT。

DateTime可以表示距离纪元（1970-01-01 UTC）最多100,000,000天的时间值：-271821-04-20到275760-09-13。

可以通过使用构造函数之一或解析符合ISO 8601子集的正确格式字符串来创建一个DateTime对象。 注意：小时介于0到23之间，按照24小时制。

例如

final now = DateTime.now();
final berlinWallFell = DateTime.utc(1989, 11, 9);
final moonLanding = DateTime.parse('1969-07-20 20:18:04Z'); // 8:18pm

当创建对象时，DateTime对象固定在UTC时间区域或当前计算机的本地时间区域。

一旦创建，DateTime对象的值或时区都不能改变。

您可以使用属性来获取DateTime对象个体的单位。

print(berlinWallFell.year); // 1989
print(berlinWallFell.month); // 11
print(berlinWallFell.day); // 9
print(moonLanding.hour); // 20
print(moonLanding.minute); // 18

为了方便和易于阅读，DateTime类为每个day和month名称提供了常量 - 例如，august和friday。您可以使用这些常量来提高代码的可读性

final berlinWallFell = DateTime.utc(1989, DateTime.november, 9);
print(DateTime.november); // 11
assert(berlinWallFell.month == DateTime.november);
assert(berlinWallFell.weekday == DateTime.thursday);

day和month的值从1开始，星期从Monday开始。也就是说，january和monday的常量都是1。

UTC时间和本地时间的使用

DateTime对象在本地时间区域，除非显式创建在UTC时间区域。使用isUtc确定一个DateTime对象是否基于UTC。

final dDay = DateTime.utc(1944, 6, 6);
print(dDay.isUtc); // true

final dDayLocal = DateTime(1944, 6, 6);
print(dDayLocal.isUtc); // false

使用toLocal和toUtc方法获取在其他时区指定的等效日期/时间值。

final localDay = dDay.toLocal(); // e.g. 1944-06-06 02:00:00.000
print(localDay.isUtc); // false

final utcFromLocal = localDay.toUtc(); // 1944-06-06 00:00:00.000Z
print(utcFromLocal.isUtc); // true

使用timeZoneName获取DateTime对象的时区的缩写名称。

print(dDay.timeZoneName); // UTC
print(localDay.timeZoneName); // e.g. EET

要查询UTC和DateTime对象时区之间的差异，请调用timeZoneOffset。

print(dDay.timeZoneOffset); // 0:00:00.000000
print(localDay.timeZoneOffset); // e.g. 2:00:00.000000

比较DateTime对象

DateTime类包含比较时间的 chronologically 的方法，如isAfter、isBefore和isAtSameMomentAs。

print(berlinWallFell.isAfter(moonLanding)); // true
print(berlinWallFell.isBefore(moonLanding)); // false
print(dDay.isAtSameMomentAs(localDay)); // true

使用Duration与DateTime结合使用

使用一个Duration对象与add和subtract方法相结合，以基于另一个创建一个DateTime对象。例如，要找到现在36小时后的点，您可以写成

final now = DateTime.now();
final later = now.add(const Duration(hours: 36));

要找出两个DateTime对象之间的时间，请使用difference，它返回一个Duration对象

final difference = berlinWallFell.difference(moonLanding);
print(difference.inDays); // 7416

不同时区中两个日期的差异只是两个时间点之间的纳秒数。它不考虑日历天数。这意味着如果中间有夏令时变化，那么两次午夜之间的差异可能小于24小时乘以它们之间的天数。如果使用澳大利亚本地时间，上述差异计算为7415天和23小时，这仅报告为inDays中的7415整天。

其他资源

• 参见Duration用于表示一段时间。
• 参见Stopwatch用于测量时间段。
• DateTime类不提供国际化。要国际化您的代码，请使用intl包。