festival.edmaven.com:80

Linux b747.shapiroconsult.com 3.10.0-1160.119.1.vz7.224.4 #1 SMP Mon Sep 30 15:36:27 MSK 2024 x86_64
Apache
173.231.212.80

File Name : _tzhelper.py

# -*- test-case-name: twisted.python.test.test_tzhelper -*-
# Copyright (c) Twisted Matrix Laboratories.
# See LICENSE for details.

"""
Time zone utilities.
"""

from datetime import datetime as DateTime, timedelta as TimeDelta, tzinfo as TZInfo
from typing import Optional

__all__ = [
    "FixedOffsetTimeZone",
    "UTC",
]

class FixedOffsetTimeZone(TZInfo):
    """
    Represents a fixed timezone offset (without daylight saving time).

@ivar name: A L{str} giving the name of this timezone; the name just
        includes how much time this offset represents.

@ivar offset: A L{TimeDelta} giving the amount of time this timezone is
        offset.
    """

def __init__(self, offset: TimeDelta, name: Optional[str] = None) -> None:
        """
        Construct a L{FixedOffsetTimeZone} with a fixed offset.

@param offset: a delta representing the offset from UTC.
        @param name: A name to be given for this timezone.
        """
        self.offset = offset
        self.name = name

@classmethod
    def fromSignHoursMinutes(
        cls, sign: str, hours: int, minutes: int
    ) -> "FixedOffsetTimeZone":
        """
        Construct a L{FixedOffsetTimeZone} from an offset described by sign
        ('+' or '-'), hours, and minutes.

@note: For protocol compatibility with AMP, this method never uses 'Z'

@param sign: A string describing the positive or negative-ness of the
            offset.
        @param hours: The number of hours in the offset.
        @param minutes: The number of minutes in the offset

@return: A time zone with the given offset, and a name describing the
            offset.
        """
        name = "%s%02i:%02i" % (sign, hours, minutes)
        if sign == "-":
            hours = -hours
            minutes = -minutes
        elif sign != "+":
            raise ValueError(f"Invalid sign for timezone {sign!r}")
        return cls(TimeDelta(hours=hours, minutes=minutes), name)

@classmethod
    def fromLocalTimeStamp(cls, timeStamp: float) -> "FixedOffsetTimeZone":
        """
        Create a time zone with a fixed offset corresponding to a time stamp in
        the system's locally configured time zone.
        """
        offset = DateTime.fromtimestamp(timeStamp) - DateTime.utcfromtimestamp(
            timeStamp
        )
        return cls(offset)

def utcoffset(self, dt: Optional[DateTime]) -> TimeDelta:
        """
        Return the given timezone's offset from UTC.
        """
        return self.offset

def dst(self, dt: Optional[DateTime]) -> TimeDelta:
        """
        Return a zero L{TimeDelta} for the daylight saving time
        offset, since there is never one.
        """
        return TimeDelta(0)

def tzname(self, dt: Optional[DateTime]) -> str:
        """
        Return a string describing this timezone.
        """
        if self.name is not None:
            return self.name
        # XXX this is wrong; the tests are
        dt = DateTime.fromtimestamp(0, self)
        return dt.strftime("UTC%z")

UTC = FixedOffsetTimeZone.fromSignHoursMinutes("+", 0, 0)

Name	Type	Size	Owner/Group	Permission	Last Modified	Actions
.	dir	-	root/root	0755	2025-01-07 04:51:53
..	dir	-	root/root	0755	2025-01-07 04:51:53
__pycache__	dir	-	root/root	0755	2025-01-07 04:51:53
_pydoctortemplates	dir	-	root/root	0755	2025-01-07 04:51:53
test	dir	-	root/root	0755	2025-01-07 04:51:53
__init__.py	text/x-python	598 B	root/root	0644	2025-01-06 04:11:15
_appdirs.py	text/x-python	820 B	root/root	0644	2025-01-06 04:11:15
_inotify.py	text/x-python	3.41 KB	root/root	0644	2025-01-06 04:11:15
_pydoctor.py	text/x-python	6.58 KB	root/root	0644	2025-01-06 04:11:15
_release.py	text/x-python	18.44 KB	root/root	0644	2025-01-06 04:11:15
_shellcomp.py	text/x-python	24.69 KB	root/root	0644	2025-01-06 04:11:15
_textattributes.py	text/x-python	8.88 KB	root/root	0644	2025-01-06 04:11:15
_tzhelper.py	text/x-python	3.05 KB	root/root	0644	2025-01-06 04:11:15
_url.py	text/x-python	228 B	root/root	0644	2025-01-06 04:11:15
compat.py	text/x-python	16.53 KB	root/root	0644	2025-01-06 04:11:15
components.py	text/x-python	13.87 KB	root/root	0644	2025-01-06 04:11:15
constants.py	text/x-python	513 B	root/root	0644	2025-01-06 04:11:15
context.py	text/x-python	3.96 KB	root/root	0644	2025-01-06 04:11:15
deprecate.py	text/x-python	27.02 KB	root/root	0644	2025-01-06 04:11:15
failure.py	text/x-python	27.21 KB	root/root	0644	2025-01-06 04:11:15
fakepwd.py	text/x-python	6.57 KB	root/root	0644	2025-01-06 04:11:15
filepath.py	text/x-python	52.76 KB	root/root	0644	2025-01-06 04:11:15
formmethod.py	text/x-python	11.82 KB	root/root	0644	2025-01-06 04:11:15
htmlizer.py	text/x-python	3.54 KB	root/root	0644	2025-01-06 04:11:15
lockfile.py	text/x-python	7.84 KB	root/root	0644	2025-01-06 04:11:15
log.py	text/x-python	21.78 KB	root/root	0644	2025-01-06 04:11:15
logfile.py	text/x-python	9.88 KB	root/root	0644	2025-01-06 04:11:15
modules.py	text/x-python	26.09 KB	root/root	0644	2025-01-06 04:11:15
monkey.py	text/x-python	2.11 KB	root/root	0644	2025-01-06 04:11:15
procutils.py	text/x-python	1.34 KB	root/root	0644	2025-01-06 04:11:15
randbytes.py	text/x-python	3.38 KB	root/root	0644	2025-01-06 04:11:15
rebuild.py	text/x-python	6.96 KB	root/root	0644	2025-01-06 04:11:15
reflect.py	text/x-python	20 KB	root/root	0644	2025-01-06 04:11:15
release.py	text/x-python	1.08 KB	root/root	0644	2025-01-06 04:11:15
roots.py	text/x-python	7.01 KB	root/root	0644	2025-01-06 04:11:15
runtime.py	text/x-python	5.79 KB	root/root	0644	2025-01-06 04:11:15
sendmsg.py	text/x-python	2.62 KB	root/root	0644	2025-01-06 04:11:15
shortcut.py	text/x-python	2.25 KB	root/root	0644	2025-01-06 04:11:15
syslog.py	text/x-python	3.57 KB	root/root	0644	2025-01-06 04:11:15
systemd.py	text/x-python	2.92 KB	root/root	0644	2025-01-06 04:11:15
text.py	text/x-python	5.29 KB	root/root	0644	2025-01-06 04:11:15
threadable.py	text/x-python	3.25 KB	root/root	0644	2025-01-06 04:11:15
threadpool.py	text/x-python	9.96 KB	root/root	0644	2025-01-06 04:11:15
twisted-completion.zsh	text/plain	1.34 KB	root/root	0644	2025-01-06 04:11:15
url.py	text/x-python	244 B	root/root	0644	2025-01-06 04:11:15
urlpath.py	text/x-python	8.25 KB	root/root	0644	2025-01-06 04:11:15
usage.py	text/x-python	33.77 KB	root/root	0644	2025-01-06 04:11:15
util.py	text/x-python	26.79 KB	root/root	0644	2025-01-06 04:11:15
versions.py	text/x-python	273 B	root/root	0644	2025-01-06 04:11:15
win32.py	text/x-python	4.68 KB	root/root	0644	2025-01-06 04:11:15
zippath.py	text/x-python	8.82 KB	root/root	0644	2025-01-06 04:11:15
zipstream.py	text/x-python	9.45 KB	root/root	0644	2025-01-06 04:11:15