Date::isValid() - Code Metrics - Inspection of "Update CHANGELOG" - Cecilapp/Cecil - Measure and Improve Code Quality continuously with Scrutinizer

Passed

Push — master ( 2c25f8...c0741a )

unknown

created 2025-08-26 12:34 UTC

Date::isValid() A

↳ Parent: Date

Complexity

Conditions	2
Paths	2

Size

Total Lines	5
Code Lines	2

Duplication

Lines	0
Ratio	0 %

Code Coverage

Tests	3
CRAP Score	2

Importance

Changes

Metric	Value
cc	2
eloc	2
c	0
b	0
f	0
nc	2
nop	2
dl	0
loc	5
ccs	3
cts	3
cp	1
crap	2
rs	10

<?php

/**
 * This file is part of Cecil.
 *
 * (c) Arnaud Ligny <[email protected]>
 *
 * For the full copyright and license information, please view the LICENSE
 * file that was distributed with this source code.
 */

declare(strict_types=1);

namespace Cecil\Util;

/**
 * Date utility class.
 *
 * This class provides utility methods for handling dates,
 * including validation, conversion to DateTime, and formatting durations.
 */
class Date
{
    /**
     * Checks if a date is valid.
     */
    public static function isValid(string $date, string $format = 'Y-m-d'): bool
    {
        $d = \DateTime::createFromFormat($format, $date);

        return $d && $d->format($format) === $date;
    }

    /**
     * Date to DateTime.
     *
     * @param mixed $date
     */
    public static function toDatetime($date): \DateTime
    {
        if ($date === null) {
            throw new \Exception('$date can\'t be null.');
        }
        // DateTime
        if ($date instanceof \DateTime) {
            return $date;
        }
        // DateTimeImmutable
        if ($date instanceof \DateTimeImmutable) {
            return \DateTime::createFromImmutable($date);
        }
        // timestamp
        if (\is_int($date)) {
            return (new \DateTime())->setTimestamp($date);
        }

        return new \DateTime($date);
    }

    /**
     * Duration in seconds to ISO 8601.
     */
    public static function durationToIso8601(float $duration): string
    {
        $duration = (int) round($duration);
        $dateInterval = \DateInterval::createFromDateString("$duration seconds");

        return $dateInterval->format('PT%HH%IM%SS');
    }
}


1		<?php
2
3		/**
4		* This file is part of Cecil.
5		*
6		* (c) Arnaud Ligny <[email protected]>
7		*
8		* For the full copyright and license information, please view the LICENSE
9		* file that was distributed with this source code.
10		*/
11
12		declare(strict_types=1);
13
14		namespace Cecil\Util;
15
16		/**
17		* Date utility class.
18		*
19		* This class provides utility methods for handling dates,
20		* including validation, conversion to DateTime, and formatting durations.
21		*/
22		class Date
23		{
24		/**
25		* Checks if a date is valid.
26		*/
27	1	public static function isValid(string $date, string $format = 'Y-m-d'): bool
28		{
29	1	$d = \DateTime::createFromFormat($format, $date);
30
31	1	return $d && $d->format($format) === $date;
32		}
33
34		/**
35		* Date to DateTime.
36		*
37		* @param mixed $date
38		*/
39	1	public static function toDatetime($date): \DateTime
40		{
41	1	if ($date === null) {
42		throw new \Exception('$date can\'t be null.');
43		}
44		// DateTime
45	1	if ($date instanceof \DateTime) {
46	1	return $date;
47		}
48		// DateTimeImmutable
49	1	if ($date instanceof \DateTimeImmutable) {
50	1	return \DateTime::createFromImmutable($date);
51		}
52		// timestamp
53	1	if (\is_int($date)) {
54		return (new \DateTime())->setTimestamp($date);
55		}
56
57	1	return new \DateTime($date);
58		}
59
60		/**
61		* Duration in seconds to ISO 8601.
62		*/
63	1	public static function durationToIso8601(float $duration): string
64		{
65	1	$duration = (int) round($duration);
66	1	$dateInterval = \DateInterval::createFromDateString("$duration seconds");
67
68	1	return $dateInterval->format('PT%HH%IM%SS');
69		}
70		}
71

Cecilapp / Cecil

Push — master ( 2c25f8...c0741a )

Date::isValid() A

Complexity

Size

Duplication

Code Coverage

Importance

Duplication Side-by-Side

Filter issues like