+ replaced Query\Builder::expr() calls to Query\Builder::createQueryExpression()

vincent-le-henaff · vincent-le-henaff · commit eb60a6f4ef8c · 2022-11-06T16:55:45.000+01:00
+ replaced Aggregation\Builder::expr() calls to Aggregation\Builder::createAggregationExpression()
+ minor psalm docblock update
diff --git a/lib/Doctrine/ODM/MongoDB/Aggregation/Stage/Bucket/AbstractOutput.php b/lib/Doctrine/ODM/MongoDB/Aggregation/Stage/Bucket/AbstractOutput.php
@@ -25,7 +25,7 @@ public function __construct(Builder $builder, Stage\AbstractBucket $bucket)
         parent::__construct($builder);
 
         $this->bucket = $bucket;
-        $this->expr   = $builder->expr();
+        $this->expr   = $builder->createAggregationExpression();
     }
 
     public function getExpression(): array
diff --git a/lib/Doctrine/ODM/MongoDB/Aggregation/Stage/Group.php b/lib/Doctrine/ODM/MongoDB/Aggregation/Stage/Group.php
@@ -19,7 +19,7 @@ public function __construct(Builder $builder)
     {
         parent::__construct($builder);
 
-        $this->expr = $builder->expr();
+        $this->expr = $builder->createAggregationExpression();
     }
 
     public function getExpression(): array
diff --git a/lib/Doctrine/ODM/MongoDB/Aggregation/Stage/MatchStage.php b/lib/Doctrine/ODM/MongoDB/Aggregation/Stage/MatchStage.php
@@ -25,7 +25,7 @@ public function __construct(Builder $builder)
     {
         parent::__construct($builder);
 
-        $this->query = $this->expr();
+        $this->query = $this->createQueryExpression();
     }
 
     /**
diff --git a/lib/Doctrine/ODM/MongoDB/Aggregation/Stage/Operator.php b/lib/Doctrine/ODM/MongoDB/Aggregation/Stage/Operator.php
@@ -27,7 +27,7 @@ public function __construct(Builder $builder)
     {
         parent::__construct($builder);
 
-        $this->expr = $builder->expr();
+        $this->expr = $builder->createAggregationExpression();
     }
 
     /**
diff --git a/lib/Doctrine/ODM/MongoDB/Query/Builder.php b/lib/Doctrine/ODM/MongoDB/Query/Builder.php
@@ -122,7 +122,7 @@ public function __clone()
     /**
      * Add one or more $and clauses to the current query.
      *
-     * You can create a new expression using the {@link Builder::expr()} method.
+     * You can create a new expression using the {@link Builder::createAggregationExpression()} method.
      *
      * @see Expr::addAnd()
      * @see https://docs.mongodb.com/manual/reference/operator/and/
@@ -140,7 +140,7 @@ public function addAnd($expression, ...$expressions): self
     /**
      * Add one or more $nor clauses to the current query.
      *
-     * You can create a new expression using the {@link Builder::expr()} method.
+     * You can create a new expression using the {@link Builder::createAggregationExpression()} method.
      *
      * @see Expr::addNor()
      * @see https://docs.mongodb.com/manual/reference/operator/nor/
@@ -158,7 +158,7 @@ public function addNor($expression, ...$expressions): self
     /**
      * Add one or more $or clauses to the current query.
      *
-     * You can create a new expression using the {@link Builder::expr()} method.
+     * You can create a new expression using the {@link Builder::createAggregationExpression()} method.
      *
      * @see Expr::addOr()
      * @see https://docs.mongodb.com/manual/reference/operator/or/
@@ -430,7 +430,7 @@ public function distinct(string $field): self
     /**
      * Specify $elemMatch criteria for the current field.
      *
-     * You can create a new expression using the {@link Builder::expr()} method.
+     * You can create a new expression using the {@link Builder::createAggregationExpression()} method.
      *
      * @see Expr::elemMatch()
      * @see https://docs.mongodb.com/manual/reference/operator/elemMatch/
@@ -465,6 +465,9 @@ public function equals($value): self
      * excluded.
      *
      * @param string[]|string $fieldName,...
+     * @param null|string|string[] $fieldName
+     *
+     * @psalm-param 'comments'|array{0: 'name', 1: 'issues'}|null $fieldName
      */
     public function exclude($fieldName = null): self
     {
@@ -1054,7 +1057,7 @@ public function nearSphere($x, $y = null): self
     /**
      * Negates an expression for the current field.
      *
-     * You can create a new expression using the {@link Builder::expr()} method.
+     * You can create a new expression using the {@link Builder::createAggregationExpression()} method.
      *
      * @see Expr::not()
      * @see https://docs.mongodb.com/manual/reference/operator/not/
@@ -1288,7 +1291,9 @@ public function returnNew(bool $bool = true): self
     /**
      * Set one or more fields to be included in the query projection.
      *
-     * @param string[]|string $fieldName,...
+     * @param null|string|string[] $fieldName
+     *
+     * @return Builder
      */
     public function select($fieldName = null): self
     {
diff --git a/lib/Doctrine/ODM/MongoDB/Query/QueryExpressionVisitor.php b/lib/Doctrine/ODM/MongoDB/Query/QueryExpressionVisitor.php
@@ -71,14 +71,14 @@ public function walkComparison(Comparison $comparison): Expr
             case Comparison::NIN:
                 $method = self::$operatorMethods[$comparison->getOperator()];
 
-                return $this->builder->expr()
+                return $this->builder->createQueryExpression()
                     ->field($comparison->getField())
                     ->{$method}($this->walkValue($comparison->getValue()));
 
             case Comparison::CONTAINS:
                 $value = $this->walkValue($comparison->getValue());
 
-                return $this->builder->expr()
+                return $this->builder->createQueryExpression()
                     ->field($comparison->getField())
                     ->equals(new Regex($value, ''));
 
@@ -99,7 +99,7 @@ public function walkCompositeExpression(CompositeExpression $expr): Expr
         }
 
         $method     = self::$compositeMethods[$expr->getType()];
-        $outputExpr = $this->builder->expr();
+        $outputExpr = $this->builder->createQueryExpression();
 
         foreach ($expr->getExpressionList() as $child) {
             $outputExpr->{$method}($this->dispatch($child));
diff --git a/lib/Doctrine/ODM/MongoDB/Types/DateImmutableType.php b/lib/Doctrine/ODM/MongoDB/Types/DateImmutableType.php
@@ -16,6 +16,8 @@ class DateImmutableType extends DateType
 {
     /**
      * @return DateTimeImmutable
+     *
+     * @param \MongoDB\BSON\UTCDateTime|float $value
      */
     public static function getDateTime($value): DateTimeInterface
     {
diff --git a/tests/Doctrine/ODM/MongoDB/Tests/Aggregation/BuilderTest.php b/tests/Doctrine/ODM/MongoDB/Tests/Aggregation/BuilderTest.php
@@ -135,7 +135,7 @@ public function testGetPipeline(): void
             ->unwind('b')
             ->redact()
                 ->cond(
-                    $builder->expr()->lte('$accessLevel', 3),
+                    $builder->createAggregationExpression()->lte('$accessLevel', 3),
                     '$$KEEP',
                     '$$REDACT'
                 )
@@ -144,9 +144,9 @@ public function testGetPipeline(): void
                 ->includeFields(['user', 'amount', 'invoiceAddress'])
                 ->field('deliveryAddress')
                 ->cond(
-                    $builder->expr()
-                        ->addAnd($builder->expr()->eq('$useAlternateDeliveryAddress', true))
-                        ->addAnd($builder->expr()->ne('$deliveryAddress', null)),
+                    $builder->createAggregationExpression()
+                        ->addAnd($builder->createAggregationExpression()->eq('$useAlternateDeliveryAddress', true))
+                        ->addAnd($builder->createAggregationExpression()->ne('$deliveryAddress', null)),
                     '$deliveryAddress',
                     '$invoiceAddress'
                 )
@@ -157,7 +157,7 @@ public function testGetPipeline(): void
                 ->sum(1)
                 ->field('amount')
                 ->expression(
-                    $builder->expr()
+                    $builder->createAggregationExpression()
                         ->field('total')
                         ->sum('$amount')
                         ->field('avg')
@@ -267,9 +267,9 @@ public function testPipelineConvertsTypes(): void
             ->group()
                 ->field('id')
                 ->expression(
-                    $builder->expr()
+                    $builder->createAggregationExpression()
                         ->cond(
-                            $builder->expr()->lt('$createdAt', $dateTime),
+                            $builder->createAggregationExpression()->lt('$createdAt', $dateTime),
                             true,
                             false
                         )
diff --git a/tests/Doctrine/ODM/MongoDB/Tests/Aggregation/Stage/RedactTest.php b/tests/Doctrine/ODM/MongoDB/Tests/Aggregation/Stage/RedactTest.php
@@ -19,7 +19,7 @@ public function testRedactStage(): void
         $redactStage = new Redact($builder);
         $redactStage
             ->cond(
-                $builder->expr()->lte('$accessLevel', 3),
+                $builder->createAggregationExpression()->lte('$accessLevel', 3),
                 '$$KEEP',
                 '$$REDACT'
             );
@@ -33,7 +33,7 @@ public function testRedactFromBuilder(): void
         $builder
             ->redact()
             ->cond(
-                $builder->expr()->lte('$accessLevel', 3),
+                $builder->createAggregationExpression()->lte('$accessLevel', 3),
                 '$$KEEP',
                 '$$REDACT'
             );
diff --git a/tests/Doctrine/ODM/MongoDB/Tests/Aggregation/Stage/ReplaceRootTest.php b/tests/Doctrine/ODM/MongoDB/Tests/Aggregation/Stage/ReplaceRootTest.php
@@ -43,7 +43,7 @@ public function testTypeConversionWithDirectExpression(): void
         $mongoDate = new UTCDateTime((int) $dateTime->format('Uv'));
         $stage     = $builder
             ->replaceRoot(
-                $builder->expr()
+                $builder->createAggregationExpression()
                     ->field('isToday')
                     ->eq('$createdAt', $dateTime)
             );
diff --git a/tests/Doctrine/ODM/MongoDB/Tests/Functional/QueryTest.php b/tests/Doctrine/ODM/MongoDB/Tests/Functional/QueryTest.php
@@ -53,7 +53,7 @@ public function testAddElemMatch(): void
         $qb         = $this->dm->createQueryBuilder(User::class);
         $embeddedQb = $this->dm->createQueryBuilder(Phonenumber::class);
 
-        $qb->field('phonenumbers')->elemMatch($embeddedQb->expr()->field('phonenumber')->equals('6155139185'));
+        $qb->field('phonenumbers')->elemMatch($embeddedQb->createQueryExpression()->field('phonenumber')->equals('6155139185'));
         $query = $qb->getQuery();
         $user  = $query->getSingleResult();
         self::assertNotNull($user);
@@ -76,7 +76,8 @@ public function testAddElemMatchWithDeepFields(): void
         $qb         = $this->dm->createQueryBuilder(User::class);
         $embeddedQb = $this->dm->createQueryBuilder(Phonenumber::class);
 
-        $qb->field('phonenumbers')->elemMatch($embeddedQb->expr()->field('lastCalledBy.$id')->equals(new ObjectId($user1->getId())));
+        $qb->field('phonenumbers')->elemMatch($embeddedQb->createQueryExpression()->field('lastCalledBy.$id')->equals(new ObjectId
+        ($user1->getId())));
         $query = $qb->getQuery();
         $user  = $query->getSingleResult();
         self::assertNotNull($user);
@@ -91,12 +92,12 @@ public function testAddNot(): void
         $this->dm->flush();
 
         $qb = $this->dm->createQueryBuilder(User::class);
-        $qb->field('username')->not($qb->expr()->in(['boo']));
+        $qb->field('username')->not($qb->createQueryExpression()->in(['boo']));
         $query = $qb->getQuery();
         $user  = $query->getSingleResult();
         self::assertNull($user);
 
-        $qb->field('username')->not($qb->expr()->in(['1boo']));
+        $qb->field('username')->not($qb->createQueryExpression()->in(['1boo']));
         $query = $qb->getQuery();
         $user  = $query->getSingleResult();
         self::assertNotNull($user);
diff --git a/tests/Doctrine/ODM/MongoDB/Tests/Functional/Ticket/GH1674Test.php b/tests/Doctrine/ODM/MongoDB/Tests/Functional/Ticket/GH1674Test.php
@@ -18,7 +18,7 @@ public function testElemMatchUsesCorrectMapping(): void
         $builder
             ->field('embedded')
             ->elemMatch(
-                $builder->expr()
+                $builder->createQueryExpression()
                     ->field('id')
                     ->equals(1)
             );
diff --git a/tests/Doctrine/ODM/MongoDB/Tests/Functional/Ticket/GH2251Test.php b/tests/Doctrine/ODM/MongoDB/Tests/Functional/Ticket/GH2251Test.php
@@ -23,8 +23,8 @@ public function testElemMatchQuery(string $fieldName): void
             new ObjectId('5fae9a775ef4492e3c72b3f4'),
         ];
 
-        $notIn     = $builder->expr()->notIn($objectIds);
-        $elemMatch = $builder->expr()
+        $notIn     = $builder->createQueryExpression()->notIn($objectIds);
+        $elemMatch = $builder->createQueryExpression()
             ->field($fieldName)
             ->elemMatch($notIn);
 
diff --git a/tests/Doctrine/ODM/MongoDB/Tests/Functional/Ticket/GH596Test.php b/tests/Doctrine/ODM/MongoDB/Tests/Functional/Ticket/GH596Test.php
@@ -26,8 +26,8 @@ public function testExpressionPreparationDoesNotInjectFilterCriteria(): void
 
         $repository = $this->dm->getRepository($class);
         $qb         = $repository->createQueryBuilder();
-        $qb->addOr($qb->expr()->field('name')->equals('foo'));
-        $qb->addOr($qb->expr()->field('name')->equals('bar'));
+        $qb->addOr($qb->createQueryExpression()->field('name')->equals('foo'));
+        $qb->addOr($qb->createQueryExpression()->field('name')->equals('bar'));
 
         $query = $qb->getQuery();
         $query = $query->getQuery();
diff --git a/tests/Doctrine/ODM/MongoDB/Tests/Query/BuilderTest.php b/tests/Doctrine/ODM/MongoDB/Tests/Query/BuilderTest.php
@@ -242,8 +242,8 @@ public function provideArrayUpdateOperatorsOnReferenceOne(): Generator
     public function testThatOrAcceptsAnotherQuery(): void
     {
         $qb = $this->getTestQueryBuilder();
-        $qb->addOr($qb->expr()->field('firstName')->equals('Kris'));
-        $qb->addOr($qb->expr()->field('firstName')->equals('Chris'));
+        $qb->addOr($qb->createQueryExpression()->field('firstName')->equals('Kris'));
+        $qb->addOr($qb->createQueryExpression()->field('firstName')->equals('Chris'));
 
         self::assertEquals([
             '$or' => [
@@ -256,8 +256,8 @@ public function testThatOrAcceptsAnotherQuery(): void
     public function testThatAndAcceptsAnotherQuery(): void
     {
         $qb = $this->getTestQueryBuilder();
-        $qb->addAnd($qb->expr()->field('hits')->gte(1));
-        $qb->addAnd($qb->expr()->field('hits')->lt(5));
+        $qb->addAnd($qb->createQueryExpression()->field('hits')->gte(1));
+        $qb->addAnd($qb->createQueryExpression()->field('hits')->lt(5));
 
         self::assertEquals([
             '$and' => [
@@ -270,8 +270,8 @@ public function testThatAndAcceptsAnotherQuery(): void
     public function testThatNorAcceptsAnotherQuery(): void
     {
         $qb = $this->getTestQueryBuilder();
-        $qb->addNor($qb->expr()->field('firstName')->equals('Kris'));
-        $qb->addNor($qb->expr()->field('firstName')->equals('Chris'));
+        $qb->addNor($qb->createQueryExpression()->field('firstName')->equals('Kris'));
+        $qb->addNor($qb->createQueryExpression()->field('firstName')->equals('Chris'));
 
         self::assertEquals([
             '$nor' => [
@@ -284,7 +284,7 @@ public function testThatNorAcceptsAnotherQuery(): void
     public function testAddElemMatch(): void
     {
         $qb = $this->getTestQueryBuilder();
-        $qb->field('phonenumbers')->elemMatch($qb->expr()->field('phonenumber')->equals('6155139185'));
+        $qb->field('phonenumbers')->elemMatch($qb->createQueryExpression()->field('phonenumber')->equals('6155139185'));
         $expected = [
             'phonenumbers' => [
                 '$elemMatch' => ['phonenumber' => '6155139185'],
@@ -296,7 +296,7 @@ public function testAddElemMatch(): void
     public function testAddNot(): void
     {
         $qb = $this->getTestQueryBuilder();
-        $qb->field('username')->not($qb->expr()->in(['boo']));
+        $qb->field('username')->not($qb->createQueryExpression()->in(['boo']));
         $expected = [
             'username' => [
                 '$not' => [
@@ -662,7 +662,7 @@ public function testSelectElemMatchWithArray(): void
     public function testSelectElemMatchWithExpr(): void
     {
         $qb = $this->getTestQueryBuilder();
-        $qb->selectElemMatch('addresses', $qb->expr()->field('state')->equals('ny'));
+        $qb->selectElemMatch('addresses', $qb->createQueryExpression()->field('state')->equals('ny'));
 
         $expected = ['addresses' => ['$elemMatch' => ['state' => 'ny']]];
 
diff --git a/tests/Doctrine/ODM/MongoDB/Tests/Query/ExprTest.php b/tests/Doctrine/ODM/MongoDB/Tests/Query/ExprTest.php
@@ -87,7 +87,7 @@ public function testAndIsPrepared(): void
 
         $qb = $this->dm->createQueryBuilder(User::class);
         $qb
-            ->addAnd($qb->expr()->field('groups.id')->in($ids))
+            ->addAnd($qb->createQueryExpression()->field('groups.id')->in($ids))
             ->select('id')->hydrate(false);
         $query = $qb->getQuery();
         $debug = $query->debug('query');
@@ -102,7 +102,7 @@ public function testOrIsPrepared(): void
 
         $qb = $this->dm->createQueryBuilder(User::class);
         $qb
-            ->addOr($qb->expr()->field('groups.id')->in($ids))
+            ->addOr($qb->createQueryExpression()->field('groups.id')->in($ids))
             ->select('id')->hydrate(false);
         $query = $qb->getQuery();
         $debug = $query->debug('query');
diff --git a/tests/Doctrine/ODM/MongoDB/Tests/QueryTest.php b/tests/Doctrine/ODM/MongoDB/Tests/QueryTest.php
@@ -59,8 +59,8 @@ public function testThatOrAcceptsAnotherQuery(): void
         $expression2 = ['firstName' => 'Chris'];
 
         $qb = $this->dm->createQueryBuilder($class);
-        $qb->addOr($qb->expr()->field('firstName')->equals('Kris'));
-        $qb->addOr($qb->expr()->field('firstName')->equals('Chris'));
+        $qb->addOr($qb->createQueryExpression()->field('firstName')->equals('Kris'));
+        $qb->addOr($qb->createQueryExpression()->field('firstName')->equals('Chris'));
 
         self::assertEquals([
             '$or' => [
@@ -283,7 +283,7 @@ public function testElemMatch(): void
         $qb         = $this->dm->createQueryBuilder(User::class);
         $embeddedQb = $this->dm->createQueryBuilder(Phonenumber::class);
 
-        $qb->field('phonenumbers')->elemMatch($embeddedQb->expr()
+        $qb->field('phonenumbers')->elemMatch($embeddedQb->createQueryExpression()
             ->field('lastCalledBy.id')->equals($refId));
         $query = $qb->getQuery();
 

Original file line number	Diff line number	Diff line change
`@@ -25,7 +25,7 @@ public function __construct(Builder $builder, Stage\AbstractBucket $bucket)`
`25`	`25`	`parent::__construct($builder);`
`26`	`26`
`27`	`27`	`$this->bucket = $bucket;`
`28`		`- $this->expr = $builder->expr();`
	`28`	`+ $this->expr = $builder->createAggregationExpression();`
`29`	`29`	`}`
`30`	`30`
`31`	`31`	`public function getExpression(): array`
Original file line number	Diff line number	Diff line change
`@@ -19,7 +19,7 @@ public function __construct(Builder $builder)`
`19`	`19`	`{`
`20`	`20`	`parent::__construct($builder);`
`21`	`21`
`22`		`- $this->expr = $builder->expr();`
	`22`	`+ $this->expr = $builder->createAggregationExpression();`
`23`	`23`	`}`
`24`	`24`
`25`	`25`	`public function getExpression(): array`
Original file line number	Diff line number	Diff line change
`@@ -27,7 +27,7 @@ public function __construct(Builder $builder)`
`27`	`27`	`{`
`28`	`28`	`parent::__construct($builder);`
`29`	`29`
`30`		`- $this->expr = $builder->expr();`
	`30`	`+ $this->expr = $builder->createAggregationExpression();`
`31`	`31`	`}`
`32`	`32`
`33`	`33`	`/**`
Original file line number	Diff line number	Diff line change
`@@ -122,7 +122,7 @@ public function __clone()`
`122`	`122`	`/**`
`123`	`123`	`* Add one or more $and clauses to the current query.`
`124`	`124`	`*`
`125`		`- * You can create a new expression using the {@link Builder::expr()} method.`
	`125`	`+ * You can create a new expression using the {@link Builder::createAggregationExpression()} method.`
`126`	`126`	`*`
`127`	`127`	`* @see Expr::addAnd()`
`128`	`128`	`* @see https://docs.mongodb.com/manual/reference/operator/and/`
`@@ -140,7 +140,7 @@ public function addAnd($expression, ...$expressions): self`
`140`	`140`	`/**`
`141`	`141`	`* Add one or more $nor clauses to the current query.`
`142`	`142`	`*`
`143`		`- * You can create a new expression using the {@link Builder::expr()} method.`
	`143`	`+ * You can create a new expression using the {@link Builder::createAggregationExpression()} method.`
`144`	`144`	`*`
`145`	`145`	`* @see Expr::addNor()`
`146`	`146`	`* @see https://docs.mongodb.com/manual/reference/operator/nor/`
`@@ -158,7 +158,7 @@ public function addNor($expression, ...$expressions): self`
`158`	`158`	`/**`
`159`	`159`	`* Add one or more $or clauses to the current query.`
`160`	`160`	`*`
`161`		`- * You can create a new expression using the {@link Builder::expr()} method.`
	`161`	`+ * You can create a new expression using the {@link Builder::createAggregationExpression()} method.`
`162`	`162`	`*`
`163`	`163`	`* @see Expr::addOr()`
`164`	`164`	`* @see https://docs.mongodb.com/manual/reference/operator/or/`
`@@ -430,7 +430,7 @@ public function distinct(string $field): self`
`430`	`430`	`/**`
`431`	`431`	`* Specify $elemMatch criteria for the current field.`
`432`	`432`	`*`
`433`		`- * You can create a new expression using the {@link Builder::expr()} method.`
	`433`	`+ * You can create a new expression using the {@link Builder::createAggregationExpression()} method.`
`434`	`434`	`*`
`435`	`435`	`* @see Expr::elemMatch()`
`436`	`436`	`* @see https://docs.mongodb.com/manual/reference/operator/elemMatch/`
`@@ -465,6 +465,9 @@ public function equals($value): self`
`465`	`465`	`* excluded.`
`466`	`466`	`*`
`467`	`467`	`* @param string[]\|string $fieldName,...`
	`468`	`+ * @param null\|string\|string[] $fieldName`
	`469`	`+ *`
	`470`	`+ * @psalm-param 'comments'\|array{0: 'name', 1: 'issues'}\|null $fieldName`
`468`	`471`	`*/`
`469`	`472`	`public function exclude($fieldName = null): self`
`470`	`473`	`{`
`@@ -1054,7 +1057,7 @@ public function nearSphere($x, $y = null): self`
`1054`	`1057`	`/**`
`1055`	`1058`	`* Negates an expression for the current field.`
`1056`	`1059`	`*`
`1057`		`- * You can create a new expression using the {@link Builder::expr()} method.`
	`1060`	`+ * You can create a new expression using the {@link Builder::createAggregationExpression()} method.`
`1058`	`1061`	`*`
`1059`	`1062`	`* @see Expr::not()`
`1060`	`1063`	`* @see https://docs.mongodb.com/manual/reference/operator/not/`
`@@ -1288,7 +1291,9 @@ public function returnNew(bool $bool = true): self`
`1288`	`1291`	`/**`
`1289`	`1292`	`* Set one or more fields to be included in the query projection.`
`1290`	`1293`	`*`
`1291`		`- * @param string[]\|string $fieldName,...`
	`1294`	`+ * @param null\|string\|string[] $fieldName`
	`1295`	`+ *`
	`1296`	`+ * @return Builder`
`1292`	`1297`	`*/`
`1293`	`1298`	`public function select($fieldName = null): self`
`1294`	`1299`	`{`
Original file line number	Diff line number	Diff line change
`@@ -16,6 +16,8 @@ class DateImmutableType extends DateType`
`16`	`16`	`{`
`17`	`17`	`/**`
`18`	`18`	`* @return DateTimeImmutable`
	`19`	`+ *`
	`20`	`+ * @param \MongoDB\BSON\UTCDateTime\|float $value`
`19`	`21`	`*/`
`20`	`22`	`public static function getDateTime($value): DateTimeInterface`
`21`	`23`	`{`