:py:mod:`dissect.target.plugins.os.unix.datetime` ================================================= .. py:module:: dissect.target.plugins.os.unix.datetime Module Contents --------------- Classes ~~~~~~~ .. autoapisummary:: dissect.target.plugins.os.unix.datetime.DateTimePlugin .. py:class:: DateTimePlugin(target: dissect.target.target.Target) Bases: :py:obj:`dissect.target.plugin.Plugin` Base class for plugins. Plugins can optionally be namespaced by specifying the ``__namespace__`` class attribute. Namespacing results in your plugin needing to be prefixed with this namespace when being called. For example, if your plugin has specified ``test`` as namespace and a function called ``example``, you must call your plugin with ``test.example``:: A ``Plugin`` class has the following private class attributes: - ``__namespace__`` - ``__record_descriptors__`` With the following three being assigned in :func:`register`: - ``__plugin__`` - ``__functions__`` - ``__exports__`` Additionally, the methods and attributes of :class:`Plugin` receive more private attributes by using decorators. The :func:`export` decorator adds the following private attributes - ``__exported__`` - ``__output__``: Set with the :func:`export` decorator. - ``__record__``: Set with the :func:`export` decorator. The :func:`internal` decorator and :class:`InternalPlugin` set the ``__internal__`` attribute. Finally. :func:`args` decorator sets the ``__args__`` attribute. :param target: The :class:`~dissect.target.target.Target` object to load the plugin for. .. py:attribute:: __namespace__ :value: 'datetime' .. py:method:: check_compatible() -> None Perform a compatibility check with the target. This function should return ``None`` if the plugin is compatible with the current target (``self.target``). For example, check if a certain file exists. Otherwise it should raise an ``UnsupportedPluginError``. :raises UnsupportedPluginError: If the plugin could not be loaded. .. py:method:: tz(name: str) -> datetime.tzinfo .. py:method:: tzinfo() -> datetime.tzinfo Return a datetime.tzinfo of the current system timezone. .. py:method:: local(dt: datetime.datetime) -> datetime.datetime Replace the tzinfo of a given datetime.datetime object with the current system tzinfo without conversion. .. py:method:: to_utc(dt: datetime.datetime) -> datetime.datetime Convert any datetime.datetime object into a UTC datetime.datetime object. First replaces the current tzinfo with the system tzinfo without conversion, then converts it to an aware UTC datetime object.