DateTime类

时间点，例如1969年7月20日，晚上8:18GMT。

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和本地时间

除非明确创建在UTC时区，否则DateTime对象位于本地时区。使用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类包含用于按时间顺序比较DateTime的方法，例如isAfter、isBefore和isAtSameMomentAs。

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

使用DateTime与Duration

使用与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包。