PHPLIB-1350 PHPLIB-1350 Add tests on Date Expression Operators and add Yaml tags for BSON types

[GromNaN]

Fix PHPLIB-1350

https://www.mongodb.com/docs/manual/reference/operator/aggregation/#date-expression-operators

• $dateAdd
• $dateDiff
• $dateFromParts
• $dateFromString
• $dateSubtract
• $dateToParts
• $dateToString
• $dateTrunc
• $dayOfMonth using verbose date field
• $dayOfWeek using verbose date field
• $dayOfYear using verbose date field
• $hour using verbose date field
• $isoDayOfWeek using verbose date field
• $isoWeek using verbose date field
• $isoWeekYear using verbose date field
• $millisecond using verbose date field
• $minute using verbose date field
• $month using verbose date field
• $second using verbose date field
• $toDate
• $week using verbose date field
• $year using verbose date field

[GromNaN]

I tried to represent the date using the Extended JSON format: { $date: 0 }, but this get converted to { $date: { $numberInt: 0 } } and the date is actually represented with a long { $date: { $numberLong: 0 } }.

So I ended using Yaml date, that why I configured the parser to parse dates, and added a transformation pass using array_walk_recursive to convert DateTimeInterface into MongoDB\BSON\UTCDateTime.

[alcaeus]

Just adding a note that we can leverage a custom tag for this if we run into issues with the automatic parsing of dates when we don't expect it: https://symfony.com/doc/current/components/yaml.html#parsing-and-dumping-custom-tags

[GromNaN]

I switched all specific BSON types to Yaml tags. That's more explicit.

[GromNaN]

The example is the same for all this date part operators. So I picked only the tested operator for each.

[GromNaN]

It would be very useful to have an enum for this units. PHPLIB-1370

[alcaeus]

Noted you left a comment denoting the original since our $merge operator always uses the into argument.

[GromNaN]

I did this in few other place. So that if we find there is a bug, it's easier to see the original example.

[alcaeus]

This looks like it's left over from before extracting convertTypeRecursively.

[GromNaN]

Removed, thanks.

[alcaeus]

Just adding a note that we can leverage a custom tag for this if we run into issues with the automatic parsing of dates when we don't expect it: https://symfony.com/doc/current/components/yaml.html#parsing-and-dumping-custom-tags

[GromNaN]

Added support for !date 0 Yaml tag, and !binary 'base64' for #37 (comment)

[alcaeus]

Yaml tags look a lot better, great work!