Class BusinessOpeningHours

src/telegram/_business.py:541–691

This object describes the opening hours of a business. Objects of this class are comparable in terms of equality. Two objects of this class are considered equal, if their :attr:`time_zone_name` and :attr:`opening_hours` are equal. .. versionadded:: 21.1 Args: time

class BusinessOpeningHours(TelegramObject):
    """
    This object describes the opening hours of a business.

    Objects of this class are comparable in terms of equality.
    Two objects of this class are considered equal, if their
    :attr:`time_zone_name` and :attr:`opening_hours` are equal.

    .. versionadded:: 21.1

    Args:
        time_zone_name (:obj:`str`): Unique name of the time zone for which the opening
            hours are defined.
        opening_hours (Sequence[:class:`telegram.BusinessOpeningHoursInterval`]): List of
            time intervals describing business opening hours.

    Attributes:
        time_zone_name (:obj:`str`): Unique name of the time zone for which the opening
            hours are defined.
        opening_hours (Sequence[:class:`telegram.BusinessOpeningHoursInterval`]): List of
            time intervals describing business opening hours.
    """

    __slots__ = ("_cached_zone_info", "opening_hours", "time_zone_name")

    def __init__(
        self,
        time_zone_name: str,
        opening_hours: Sequence[BusinessOpeningHoursInterval],
        *,
        api_kwargs: JSONDict | None = None,
    ):
        super().__init__(api_kwargs=api_kwargs)
        self.time_zone_name: str = time_zone_name
        self.opening_hours: Sequence[BusinessOpeningHoursInterval] = parse_sequence_arg(
            opening_hours
        )

        self._cached_zone_info: ZoneInfo | None = None

        self._id_attrs = (self.time_zone_name, self.opening_hours)

        self._freeze()

    @property
    def _zone_info(self) -> ZoneInfo:
        if self._cached_zone_info is None:
            self._cached_zone_info = get_zone_info(self.time_zone_name)
        return self._cached_zone_info

    def get_opening_hours_for_day(
        self, date: dtm.date, time_zone: dtm.tzinfo | str | None = None
    ) -> tuple[tuple[dtm.datetime, dtm.datetime], ...]:
        """Returns the opening hours intervals for a specific day as datetime objects.

        .. versionadded:: 22.5

        Args: