# Copyright (C) 2001-2018, Python Software Foundation # For licence information, see README file. # msgid "" msgstr "" "Project-Id-Version: Python 3\n" "Report-Msgid-Bugs-To: \n" "POT-Creation-Date: 2020-08-24 09:01+0200\n" "PO-Revision-Date: 2020-12-11 15:55+0100\n" "Last-Translator: Julien Palard \n" "Language-Team: FRENCH \n" "Language: fr\n" "MIME-Version: 1.0\n" "Content-Type: text/plain; charset=UTF-8\n" "Content-Transfer-Encoding: 8bit\n" #: library/zoneinfo.rst:2 msgid ":mod:`zoneinfo` --- IANA time zone support" msgstr "" #: library/zoneinfo.rst:14 msgid "" "The :mod:`zoneinfo` module provides a concrete time zone implementation to " "support the IANA time zone database as originally specified in :pep:`615`. " "By default, :mod:`zoneinfo` uses the system's time zone data if available; " "if no system time zone data is available, the library will fall back to " "using the first-party `tzdata`_ package available on PyPI." msgstr "" #: library/zoneinfo.rst:24 msgid "Module: :mod:`datetime`" msgstr "" #: library/zoneinfo.rst:23 msgid "" "Provides the :class:`~datetime.time` and :class:`~datetime.datetime` types " "with which the :class:`ZoneInfo` class is designed to be used." msgstr "" #: library/zoneinfo.rst:27 msgid "Package `tzdata`_" msgstr "" #: library/zoneinfo.rst:27 msgid "" "First-party package maintained by the CPython core developers to supply time " "zone data via PyPI." msgstr "" #: library/zoneinfo.rst:32 msgid "Using ``ZoneInfo``" msgstr "" #: library/zoneinfo.rst:34 msgid "" ":class:`ZoneInfo` is a concrete implementation of the :class:`datetime." "tzinfo` abstract base class, and is intended to be attached to ``tzinfo``, " "either via the constructor, the :meth:`datetime.replace ` method or :meth:`datetime.astimezone `::" msgstr "" #: library/zoneinfo.rst:49 msgid "" "Datetimes constructed in this way are compatible with datetime arithmetic " "and handle daylight saving time transitions with no further intervention::" msgstr "" #: library/zoneinfo.rst:60 msgid "" "These time zones also support the :attr:`~datetime.datetime.fold` attribute " "introduced in :pep:`495`. During offset transitions which induce ambiguous " "times (such as a daylight saving time to standard time transition), the " "offset from *before* the transition is used when ``fold=0``, and the offset " "*after* the transition is used when ``fold=1``, for example::" msgstr "" #: library/zoneinfo.rst:73 msgid "" "When converting from another time zone, the fold will be set to the correct " "value::" msgstr "" #: library/zoneinfo.rst:89 msgid "Data sources" msgstr "" #: library/zoneinfo.rst:91 msgid "" "The ``zoneinfo`` module does not directly provide time zone data, and " "instead pulls time zone information from the system time zone database or " "the first-party PyPI package `tzdata`_, if available. Some systems, " "including notably Windows systems, do not have an IANA database available, " "and so for projects targeting cross-platform compatibility that require time " "zone data, it is recommended to declare a dependency on tzdata. If neither " "system data nor tzdata are available, all calls to :class:`ZoneInfo` will " "raise :exc:`ZoneInfoNotFoundError`." msgstr "" #: library/zoneinfo.rst:103 msgid "Configuring the data sources" msgstr "" #: library/zoneinfo.rst:105 msgid "" "When ``ZoneInfo(key)`` is called, the constructor first searches the " "directories specified in :data:`TZPATH` for a file matching ``key``, and on " "failure looks for a match in the tzdata package. This behavior can be " "configured in three ways:" msgstr "" #: library/zoneinfo.rst:110 msgid "" "The default :data:`TZPATH` when not otherwise specified can be configured " "at :ref:`compile time `." msgstr "" #: library/zoneinfo.rst:112 msgid "" ":data:`TZPATH` can be configured using :ref:`an environment variable " "`." msgstr "" #: library/zoneinfo.rst:114 msgid "" "At :ref:`runtime `, the search path can be " "manipulated using the :func:`reset_tzpath` function." msgstr "" #: library/zoneinfo.rst:120 msgid "Compile-time configuration" msgstr "" #: library/zoneinfo.rst:122 msgid "" "The default :data:`TZPATH` includes several common deployment locations for " "the time zone database (except on Windows, where there are no \"well-known\" " "locations for time zone data). On POSIX systems, downstream distributors and " "those building Python from source who know where their system time zone data " "is deployed may change the default time zone path by specifying the compile-" "time option ``TZPATH`` (or, more likely, the ``configure`` flag ``--with-" "tzpath``), which should be a string delimited by :data:`os.pathsep`." msgstr "" #: library/zoneinfo.rst:130 msgid "" "On all platforms, the configured value is available as the ``TZPATH`` key " "in :func:`sysconfig.get_config_var`." msgstr "" #: library/zoneinfo.rst:136 msgid "Environment configuration" msgstr "" #: library/zoneinfo.rst:138 msgid "" "When initializing :data:`TZPATH` (either at import time or whenever :func:" "`reset_tzpath` is called with no arguments), the ``zoneinfo`` module will " "use the environment variable ``PYTHONTZPATH``, if it exists, to set the " "search path." msgstr "" #: library/zoneinfo.rst:145 msgid "" "This is an :data:`os.pathsep`-separated string containing the time zone " "search path to use. It must consist of only absolute rather than relative " "paths. Relative components specified in ``PYTHONTZPATH`` will not be used, " "but otherwise the behavior when a relative path is specified is " "implementation-defined; CPython will raise :exc:`InvalidTZPathWarning`, but " "other implementations are free to silently ignore the erroneous component or " "raise an exception." msgstr "" #: library/zoneinfo.rst:153 msgid "" "To set the system to ignore the system data and use the tzdata package " "instead, set ``PYTHONTZPATH=\"\"``." msgstr "" #: library/zoneinfo.rst:159 msgid "Runtime configuration" msgstr "" #: library/zoneinfo.rst:161 msgid "" "The TZ search path can also be configured at runtime using the :func:" "`reset_tzpath` function. This is generally not an advisable operation, " "though it is reasonable to use it in test functions that require the use of " "a specific time zone path (or require disabling access to the system time " "zones)." msgstr "" #: library/zoneinfo.rst:168 msgid "The ``ZoneInfo`` class" msgstr "" #: library/zoneinfo.rst:172 msgid "" "A concrete :class:`datetime.tzinfo` subclass that represents an IANA time " "zone specified by the string ``key``. Calls to the primary constructor will " "always return objects that compare identically; put another way, barring " "cache invalidation via :meth:`ZoneInfo.clear_cache`, for all values of " "``key``, the following assertion will always be true:" msgstr "" #: library/zoneinfo.rst:184 msgid "" "``key`` must be in the form of a relative, normalized POSIX path, with no up-" "level references. The constructor will raise :exc:`ValueError` if a non-" "conforming key is passed." msgstr "" #: library/zoneinfo.rst:188 msgid "" "If no file matching ``key`` is found, the constructor will raise :exc:" "`ZoneInfoNotFoundError`." msgstr "" #: library/zoneinfo.rst:192 msgid "The ``ZoneInfo`` class has two alternate constructors:" msgstr "" #: library/zoneinfo.rst:196 msgid "" "Constructs a ``ZoneInfo`` object from a file-like object returning bytes (e." "g. a file opened in binary mode or an :class:`io.BytesIO` object). Unlike " "the primary constructor, this always constructs a new object." msgstr "" #: library/zoneinfo.rst:200 msgid "" "The ``key`` parameter sets the name of the zone for the purposes of :py:meth:" "`~object.__str__` and :py:meth:`~object.__repr__`." msgstr "" #: library/zoneinfo.rst:203 msgid "" "Objects created via this constructor cannot be pickled (see `pickling`_)." msgstr "" #: library/zoneinfo.rst:207 msgid "" "An alternate constructor that bypasses the constructor's cache. It is " "identical to the primary constructor, but returns a new object on each call. " "This is most likely to be useful for testing or demonstration purposes, but " "it can also be used to create a system with a different cache invalidation " "strategy." msgstr "" #: library/zoneinfo.rst:213 msgid "" "Objects created via this constructor will also bypass the cache of a " "deserializing process when unpickled." msgstr "" #: library/zoneinfo.rst:220 msgid "" "Using this constructor may change the semantics of your datetimes in " "surprising ways, only use it if you know that you need to." msgstr "" #: library/zoneinfo.rst:223 msgid "The following class methods are also available:" msgstr "" #: library/zoneinfo.rst:227 msgid "" "A method for invalidating the cache on the ``ZoneInfo`` class. If no " "arguments are passed, all caches are invalidated and the next call to the " "primary constructor for each key will return a new instance." msgstr "" #: library/zoneinfo.rst:231 msgid "" "If an iterable of key names is passed to the ``only_keys`` parameter, only " "the specified keys will be removed from the cache. Keys passed to " "``only_keys`` but not found in the cache are ignored." msgstr "" #: library/zoneinfo.rst:239 msgid "" "Invoking this function may change the semantics of datetimes using " "``ZoneInfo`` in surprising ways; this modifies process-wide global state and " "thus may have wide-ranging effects. Only use it if you know that you need to." msgstr "" #: library/zoneinfo.rst:244 msgid "The class has one attribute:" msgstr "" #: library/zoneinfo.rst:248 msgid "" "This is a read-only :term:`attribute` that returns the value of ``key`` " "passed to the constructor, which should be a lookup key in the IANA time " "zone database (e.g. ``America/New_York``, ``Europe/Paris`` or ``Asia/" "Tokyo``)." msgstr "" #: library/zoneinfo.rst:253 msgid "" "For zones constructed from file without specifying a ``key`` parameter, this " "will be set to ``None``." msgstr "" #: library/zoneinfo.rst:258 msgid "" "Although it is a somewhat common practice to expose these to end users, " "these values are designed to be primary keys for representing the relevant " "zones and not necessarily user-facing elements. Projects like CLDR (the " "Unicode Common Locale Data Repository) can be used to get more user-friendly " "strings from these keys." msgstr "" #: library/zoneinfo.rst:265 msgid "String representations" msgstr "" #: library/zoneinfo.rst:267 msgid "" "The string representation returned when calling :py:class:`str` on a :class:" "`ZoneInfo` object defaults to using the :attr:`ZoneInfo.key` attribute (see " "the note on usage in the attribute documentation)::" msgstr "" #: library/zoneinfo.rst:279 msgid "" "For objects constructed from a file without specifying a ``key`` parameter, " "``str`` falls back to calling :func:`repr`. ``ZoneInfo``'s ``repr`` is " "implementation-defined and not necessarily stable between versions, but it " "is guaranteed not to be a valid ``ZoneInfo`` key." msgstr "" #: library/zoneinfo.rst:287 msgid "Pickle serialization" msgstr "" #: library/zoneinfo.rst:289 msgid "" "Rather than serializing all transition data, ``ZoneInfo`` objects are " "serialized by key, and ``ZoneInfo`` objects constructed from files (even " "those with a value for ``key`` specified) cannot be pickled." msgstr "" #: library/zoneinfo.rst:293 msgid "The behavior of a ``ZoneInfo`` file depends on how it was constructed:" msgstr "" #: library/zoneinfo.rst:295 msgid "" "``ZoneInfo(key)``: When constructed with the primary constructor, a " "``ZoneInfo`` object is serialized by key, and when deserialized, the " "deserializing process uses the primary and thus it is expected that these " "are expected to be the same object as other references to the same time " "zone. For example, if ``europe_berlin_pkl`` is a string containing a pickle " "constructed from ``ZoneInfo(\"Europe/Berlin\")``, one would expect the " "following behavior:" msgstr "" #: library/zoneinfo.rst:310 msgid "" "``ZoneInfo.no_cache(key)``: When constructed from the cache-bypassing " "constructor, the ``ZoneInfo`` object is also serialized by key, but when " "deserialized, the deserializing process uses the cache bypassing " "constructor. If ``europe_berlin_pkl_nc`` is a string containing a pickle " "constructed from ``ZoneInfo.no_cache(\"Europe/Berlin\")``, one would expect " "the following behavior:" msgstr "" #: library/zoneinfo.rst:324 msgid "" "``ZoneInfo.from_file(fobj, /, key=None)``: When constructed from a file, the " "``ZoneInfo`` object raises an exception on pickling. If an end user wants to " "pickle a ``ZoneInfo`` constructed from a file, it is recommended that they " "use a wrapper type or a custom serialization function: either serializing by " "key or storing the contents of the file object and serializing that." msgstr "" #: library/zoneinfo.rst:330 msgid "" "This method of serialization requires that the time zone data for the " "required key be available on both the serializing and deserializing side, " "similar to the way that references to classes and functions are expected to " "exist in both the serializing and deserializing environments. It also means " "that no guarantees are made about the consistency of results when unpickling " "a ``ZoneInfo`` pickled in an environment with a different version of the " "time zone data." msgstr "" #: library/zoneinfo.rst:338 msgid "Functions" msgstr "Fonctions" #: library/zoneinfo.rst:342 msgid "" "Get a set containing all the valid keys for IANA time zones available " "anywhere on the time zone path. This is recalculated on every call to the " "function." msgstr "" #: library/zoneinfo.rst:346 msgid "" "This function only includes canonical zone names and does not include " "\"special\" zones such as those under the ``posix/`` and ``right/`` " "directories, or the ``posixrules`` zone." msgstr "" #: library/zoneinfo.rst:352 msgid "" "This function may open a large number of files, as the best way to determine " "if a file on the time zone path is a valid time zone is to read the \"magic " "string\" at the beginning." msgstr "" #: library/zoneinfo.rst:358 msgid "" "These values are not designed to be exposed to end-users; for user facing " "elements, applications should use something like CLDR (the Unicode Common " "Locale Data Repository) to get more user-friendly strings. See also the " "cautionary note on :attr:`ZoneInfo.key`." msgstr "" #: library/zoneinfo.rst:365 msgid "" "Sets or resets the time zone search path (:data:`TZPATH`) for the module. " "When called with no arguments, :data:`TZPATH` is set to the default value." msgstr "" #: library/zoneinfo.rst:368 msgid "" "Calling ``reset_tzpath`` will not invalidate the :class:`ZoneInfo` cache, " "and so calls to the primary ``ZoneInfo`` constructor will only use the new " "``TZPATH`` in the case of a cache miss." msgstr "" #: library/zoneinfo.rst:372 msgid "" "The ``to`` parameter must be a :term:`sequence` of strings or :class:`os." "PathLike` and not a string, all of which must be absolute paths. :exc:" "`ValueError` will be raised if something other than an absolute path is " "passed." msgstr "" #: library/zoneinfo.rst:378 msgid "Globals" msgstr "" #: library/zoneinfo.rst:382 msgid "" "A read-only sequence representing the time zone search path -- when " "constructing a ``ZoneInfo`` from a key, the key is joined to each entry in " "the ``TZPATH``, and the first file found is used." msgstr "" #: library/zoneinfo.rst:386 msgid "" "``TZPATH`` may contain only absolute paths, never relative paths, regardless " "of how it is configured." msgstr "" #: library/zoneinfo.rst:389 msgid "" "The object that ``zoneinfo.TZPATH`` points to may change in response to a " "call to :func:`reset_tzpath`, so it is recommended to use ``zoneinfo." "TZPATH`` rather than importing ``TZPATH`` from ``zoneinfo`` or assigning a " "long-lived variable to ``zoneinfo.TZPATH``." msgstr "" #: library/zoneinfo.rst:394 msgid "" "For more information on configuring the time zone search path, see :ref:" "`zoneinfo_data_configuration`." msgstr "" #: library/zoneinfo.rst:398 msgid "Exceptions and warnings" msgstr "" #: library/zoneinfo.rst:402 msgid "" "Raised when construction of a :class:`ZoneInfo` object fails because the " "specified key could not be found on the system. This is a subclass of :exc:" "`KeyError`." msgstr "" #: library/zoneinfo.rst:408 msgid "" "Raised when :envvar:`PYTHONTZPATH` contains an invalid component that will " "be filtered out, such as a relative path." msgstr ""