20679683854

Committed 03 Jan 2026 04:05PM UTC coverage: 99.079% (-0.05%) from 99.132%

Build # 20679683854

Build Type

push

github

Committed by

BenMorel

Commit Message

Use PHP 8.2.0 with lowest deps

Run Details

1829 of 1846 relevant lines covered (99.08%)

183.87 hits per line

Source File
Press 'n' to go to next uncovered line, 'b' for previous

92.86

/src/TimeZone.php

<?php

declare(strict_types=1);

namespace Brick\DateTime;

use Brick\DateTime\Parser\DateTimeParseException;
use DateTimeImmutable;
use DateTimeZone;
use Override;
use Stringable;

use const PHP_VERSION_ID;

/**
 * A time-zone. This is the parent class for `TimeZoneOffset` and `TimeZoneRegion`.
 *
 * * `TimeZoneOffset` represents a fixed offset from UTC such as `+02:00`.
 * * `TimeZoneRegion` represents a geographical region such as `Europe/London`.
 */
abstract class TimeZone implements Stringable
{
    /**
     * Obtains an instance of `TimeZone` from a string representation.
     *
     * @throws DateTimeParseException
     */
    public static function parse(string $text): TimeZone
    {
        if ($text === 'Z' || $text === 'z') {
            return TimeZoneOffset::utc();
        }

        if ($text === '') {
            throw new DateTimeParseException('The string is empty.');
        }

        if ($text[0] === '+' || $text[0] === '-') {
            return TimeZoneOffset::parse($text);
        }

        return TimeZoneRegion::parse($text);
    }

    public static function utc(): TimeZoneOffset
    {
        return TimeZoneOffset::utc();
    }

    /**
     * Returns the unique time-zone ID.
     *
     * @psalm-return non-empty-string
     */
    abstract public function getId(): string;

    /**
     * Returns the offset from UTC at the given instant.
     *
     * @param Instant $pointInTime The instant.
     *
     * @return int The offset from UTC in seconds.
     */
    abstract public function getOffset(Instant $pointInTime): int;

    public function isEqualTo(TimeZone $other): bool
    {
        return $this->getId() === $other->getId();
    }

    public static function fromNativeDateTimeZone(DateTimeZone $dateTimeZone): TimeZone
    {
        $parsed = TimeZone::parse($dateTimeZone->getName());

        /**
         * PHP >= 8.1.7 supports sub-minute offsets, but truncates the seconds in getName(). Only getOffset() returns
         * the correct offset including seconds, so let's use it to make a correction if we have an offset-based TZ.
         * This has been fixed in PHP 8.1.20 and PHP 8.2.7.
         */
        if ($parsed instanceof TimeZoneOffset && PHP_VERSION_ID < 8_02_07) {
            return TimeZoneOffset::ofTotalSeconds($dateTimeZone->getOffset(new DateTimeImmutable()));
        }

        return $parsed;
    }

    /**
     * Returns an equivalent native `DateTimeZone` object for this TimeZone.
     */
    abstract public function toNativeDateTimeZone(): DateTimeZone;

    /**
     * @psalm-return non-empty-string
     */
    #[Override]
    public function __toString(): string
    {
        return $this->getId();
    }
}

1	<?php
2
3	declare(strict_types=1);
4
5	namespace Brick\DateTime;
6
7	use Brick\DateTime\Parser\DateTimeParseException;
8	use DateTimeImmutable;
9	use DateTimeZone;
10	use Override;
11	use Stringable;
12
13	use const PHP_VERSION_ID;
14
15	/**
16	* A time-zone. This is the parent class for `TimeZoneOffset` and `TimeZoneRegion`.
17	*
18	* * `TimeZoneOffset` represents a fixed offset from UTC such as `+02:00`.
19	* * `TimeZoneRegion` represents a geographical region such as `Europe/London`.
20	*/
21	abstract class TimeZone implements Stringable
22	{
23	/**
24	* Obtains an instance of `TimeZone` from a string representation.
25	*
26	* @throws DateTimeParseException
27	*/
28	public static function parse(string $text): TimeZone
29	{
30	if ($text === 'Z' \|\| $text === 'z') {	285✔
31	return TimeZoneOffset::utc();	3✔
32	}
33
34	if ($text === '') {	282✔
35	throw new DateTimeParseException('The string is empty.');	1✔
36	}
37
38	if ($text[0] === '+' \|\| $text[0] === '-') {	281✔
39	return TimeZoneOffset::parse($text);	88✔
40	}
41
42	return TimeZoneRegion::parse($text);	193✔
43	}
44
45	public static function utc(): TimeZoneOffset
46	{
47	return TimeZoneOffset::utc();	93✔
48	}
49
50	/**
51	* Returns the unique time-zone ID.
52	*
53	* @psalm-return non-empty-string
54	*/
55	abstract public function getId(): string;
56
57	/**
58	* Returns the offset from UTC at the given instant.
59	*
60	* @param Instant $pointInTime The instant.
61	*
62	* @return int The offset from UTC in seconds.
63	*/
64	abstract public function getOffset(Instant $pointInTime): int;
65
66	public function isEqualTo(TimeZone $other): bool
67	{
68	return $this->getId() === $other->getId();	186✔
69	}
70
71	public static function fromNativeDateTimeZone(DateTimeZone $dateTimeZone): TimeZone
72	{
73	$parsed = TimeZone::parse($dateTimeZone->getName());	8✔
74
75	/**
76	* PHP >= 8.1.7 supports sub-minute offsets, but truncates the seconds in getName(). Only getOffset() returns
77	* the correct offset including seconds, so let's use it to make a correction if we have an offset-based TZ.
78	* This has been fixed in PHP 8.1.20 and PHP 8.2.7.
79	*/
80	if ($parsed instanceof TimeZoneOffset && PHP_VERSION_ID < 8_02_07) {	8✔
81	return TimeZoneOffset::ofTotalSeconds($dateTimeZone->getOffset(new DateTimeImmutable()));	×
82	}
83
84	return $parsed;	8✔
85	}
86
87	/**
88	* Returns an equivalent native `DateTimeZone` object for this TimeZone.
89	*/
90	abstract public function toNativeDateTimeZone(): DateTimeZone;
91
92	/**
93	* @psalm-return non-empty-string
94	*/
95	#[Override]
96	public function __toString(): string
97	{
98	return $this->getId();	652✔
99	}
100	}

brick / date-time / 20679683854

Source File Press 'n' to go to next uncovered line, 'b' for previous

Source File
Press 'n' to go to next uncovered line, 'b' for previous