DOCSP-42957: DateTimeInterface in queries

[norareidy]

JIRA - https://jira.mongodb.org/browse/DOCSP-42957
Staging - https://preview-mongodbnorareidy.gatsbyjs.io/laravel/DOCSP-42957-stage/upgrade/#version-5.x-breaking-changes

Checklist

• Add tests and ensure they pass
• Add an entry to the CHANGELOG.md file

[GromNaN]

The same applies in the other direction. UTCDateTime objects received as results are converted to Carbon date with the default timezone. #3119

I think this should be mentioned in the query builder docs, with an example.

[rustagir]

I left a suggestion that might change the scope of the PR, so requesting another look!

[GromNaN]

Adding a 2nd example would make more sense that changing the existing one.

[GromNaN]

The previous example was a lot better as it used whereDate method that convert the string to a date object. I don't think it makes sense to change it.

The purpose is to show that users can work with Carbon object without worring with UTCDateTime. This example shows the opposite of what should be done.

->where('released', Carbon::create(2010, 1, 15));

[norareidy]

I added back the old example and kept this one - lmk what you think

[GromNaN]

Thanks, that's perfect.

[rustagir]

your changes really cleared things up! left some small suggestions

[GromNaN]

LGTM