Microseconds are lost when creating DateTime.parse or DateTime.fromMicrosecondsSinceEpoch

[osaxma]

As mentioned in the title and as shown in the example below:

main() {
 final datetimeParsed = DateTime.parse('2021-02-05T22:37:12.933232+00:00');
 final datetimeMS = DateTime.fromMicrosecondsSinceEpoch(1612564632933232);
  
 print(datetimeParsed.toIso8601String()); // prints 2021-02-05T22:37:12.933Z
 print(datetimeMS.toUtc().toIso8601String()); // prints 2021-02-05T22:37:12.933Z
  
 print(datetimeParsed.microsecondsSinceEpoch); // prints 1612564632933000
 print(datetimeMS.microsecondsSinceEpoch); // prints 1612564632933000 
}

Dart SDK on 2.10.4 (example on DartPad)

[lrhn]

The web Date object doesn't support microseconds. It's implemented using the JavaScript Date object which only supports millisecond precision. So, working as well as possible.

[rydmike]

Since Flutter Web is probably going mainstream very soon, it would be helpful to devs if the Flutter and Dart teams could collaborate and create an overview list of APIs with different behavior in VM and WEB builds. Since more and many devs new to Dart, will probably start to build cross platforms apps, more devs are likely to stumble on such issues from time to time. It would be good to preempt it a bit at least, and provide a consolidated source for already known such potential pitfalls.

Perhaps there already is such an overview in the Dart lang docs site? In that case it would be good to promote it better and reference it from the Flutter site as well.

Yes this particular case is of course documented at least in the doc comments for the getter in question, so it is in API docs, IDE tooling and when you drill into the source:
https://api.dart.dev/stable/2.10.5/dart-core/DateTime/microsecondsSinceEpoch.html

But can be easy to miss, especially if you just build something that was originally built just for Flutter VM apps to run on Flutter Web as well.

[rydmike]

On that note, would it be possible to create a lint rule that could be enabled to detect these kind of issues, and it would warn you when you might have an issue due to differences in VM and WEB implementations?

[vsmenon]

Assigning to lib to improve the doc on this API to at least say what @lrhn says above. As written, it looks like it could return anything. The implementation uses millisecond precision and multiplies by 1000 here:

sdk/sdk/lib/_internal/js_runtime/lib/core_patch.dart

Line 333 in 30ba97b

int get microsecondsSinceEpoch => 1000 * _value;

A general VM vs Web lint would be difficult ( any API uses int might behave different, but it's usually not likely to matter ). We might consider flagging certain APIs more likely to be misused though. ( @pq @rakudrama @ferhatb ?)

[rydmike]

A lint rule that can catch and warn about certain APIs, that you might stumble on in Flutter Web and VM cross platform dev, would already imo be very useful and helpful, definitely better than nothing and relaying on memory to remember them.

Would you like a separate submission of a suggestion/issue for such a lint rule? Just to have it as its own actionable topic instead of the comment I just threw up in the air here to see if it might stick... 😃

[vsmenon]

@rydmike - please do - you can file it here and reference this issue:

https://github.com/dart-lang/linter/issues

thanks!

[pq]

Yes, thank you @rydmike. Issues would be greatly appreciated!

[rydmike]

Added: #58320