Class UTCTimeField

scapy/fields.py:3541–3601

class UTCTimeField(Field[float, int]):
    __slots__ = ["epoch", "delta", "strf",
                 "use_msec", "use_micro", "use_nano", "custom_scaling"]

    def __init__(self,
                 name,  # type: str
                 default,  # type: int
                 use_msec=False,  # type: bool
                 use_micro=False,  # type: bool
                 use_nano=False,  # type: bool
                 epoch=None,  # type: Optional[Tuple[int, int, int, int, int, int, int, int, int]]  # noqa: E501
                 strf="%a, %d %b %Y %H:%M:%S %z",  # type: str
                 custom_scaling=None,  # type: Optional[int]
                 fmt="I"  # type: str
                 ):
        # type: (...) -> None
        Field.__init__(self, name, default, fmt=fmt)
        mk_epoch = EPOCH if epoch is None else calendar.timegm(epoch)
        self.epoch = mk_epoch
        self.delta = mk_epoch - EPOCH
        self.strf = strf
        self.use_msec = use_msec
        self.use_micro = use_micro
        self.use_nano = use_nano
        self.custom_scaling = custom_scaling

    def i2repr(self, pkt, x):
        # type: (Optional[Packet], float) -> str
        if x is None:
            x = time.time() - self.delta
        elif self.use_msec:
            x = x / 1e3
        elif self.use_micro:
            x = x / 1e6
        elif self.use_nano:
            x = x / 1e9
        elif self.custom_scaling:
            x = x / self.custom_scaling
        x += self.delta
        # To make negative timestamps work on all plateforms (e.g. Windows),
        # we need a trick.
        t = (
            datetime.datetime(1970, 1, 1) +
            datetime.timedelta(seconds=x)
        ).strftime(self.strf)
        return "%s (%d)" % (t, int(x))

    def i2m(self, pkt, x):
        # type: (Optional[Packet], Optional[float]) -> int
        if x is None:
            x = time.time() - self.delta
            if self.use_msec:
                x = x * 1e3
            elif self.use_micro:
                x = x * 1e6
            elif self.use_nano:
                x = x * 1e9
            elif self.custom_scaling: