Passed
Push — variadic-pattern ( b0f4a5...705257 )
by Martin
10:38
created

DateAdd::getNodeMappingPattern()   A

Complexity

Conditions 1
Paths 1

Size

Total Lines 3
Code Lines 1

Duplication

Lines 0
Ratio 0 %

Code Coverage

Tests 2
CRAP Score 1

Importance

Changes 0
Metric Value
cc 1
eloc 1
c 0
b 0
f 0
nc 1
nop 0
dl 0
loc 3
ccs 2
cts 2
cp 1
crap 1
rs 10
1
<?php
2
3
declare(strict_types=1);
4
5
namespace MartinGeorgiev\Doctrine\ORM\Query\AST\Functions;
6
7
use Doctrine\ORM\Query\AST\Node;
8
use MartinGeorgiev\Doctrine\ORM\Query\AST\Functions\Exception\InvalidArgumentForVariadicFunctionException;
9
use MartinGeorgiev\Doctrine\ORM\Query\AST\Functions\Traits\TimezoneValidationTrait;
10
11
/**
12
 * Implementation of PostgreSQL DATE_ADD().
13
 *
14
 * Adds an interval to a timestamp with time zone, computing times of day and daylight-savings
15
 * adjustments according to the time zone.
16
 *
17
 * @see https://www.postgresql.org/docs/16/functions-datetime.html
18
 * @since 3.1
19
 *
20
 * @author Martin Georgiev <[email protected]>
21
 *
22
 * @example Using it in DQL: "SELECT DATE_ADD(e.timestampWithTz, '1 day', 'Europe/Sofia') FROM Entity e"
23
 */
24
class DateAdd extends BaseVariadicFunction
25
{
26
    use TimezoneValidationTrait;
0 ignored issues
show
Bug introduced by
The trait MartinGeorgiev\Doctrine\...TimezoneValidationTrait requires the property $value which is not provided by MartinGeorgiev\Doctrine\...y\AST\Functions\DateAdd.
Loading history...
27
28 4
    protected function getNodeMappingPattern(): array
29
    {
30 4
        return ['StringPrimary'];
31
    }
32
33 4
    protected function customizeFunction(): void
34
    {
35 4
        $this->setFunctionPrototype('date_add(%s)');
36
    }
37
38 4
    protected function validateArguments(Node ...$arguments): void
39
    {
40 4
        $argumentCount = \count($arguments);
41 4
        if ($argumentCount < 2 || $argumentCount > 3) {
42 2
            throw InvalidArgumentForVariadicFunctionException::between('date_add', 2, 3);
43
        }
44
45
        // Validate that the third parameter is a valid timezone if provided
46 2
        if ($argumentCount === 3) {
47 2
            $this->validateTimezone($arguments[2], 'DATE_ADD');
48
        }
49
    }
50
}
51