Files
godot-docs-l10n/classes/fr/class_time.rst

570 lines
31 KiB
ReStructuredText
Raw Permalink Blame History

This file contains invisible Unicode characters

This file contains invisible Unicode characters that are indistinguishable to humans but may be processed differently by a computer. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.

:github_url: hide
.. _class_Time:
Time
====
**Hérite de:** :ref:`Object<class_Object>`
Un singleton pour travailler avec des données temporelles.
.. rst-class:: classref-introduction-group
Description
-----------
Le singleton Time permet de convertir le temps entre différents formats et d'obtenir du système des informations de temps.
Cette classe est conforme au plus grand nombre possible de normes ISO 8601. Toutes les dates suivent le calendrier grégorien proleptique. Ainsi, la veille de ``1582-10-15`` est ``1582-10-14``, pas ``1582-10-04``. L'année précédant 1 ap. JC (i.e. 1 av. JC) est le numéro ``0``, l'année encore précédente (2 av. JC) étant ``-1``, etc.
Les méthodes de conversion supposent "le même fuseau horaire", et ne traitent pas les conversions de fuseau horaire ou l'heure d'été automatiquement. Les secondes intercalaires ne sont pas également gérées, elles doivent être faites manuellement si désiré. Les suffixes comme "Z" ne sont pas gérés, vous devez les retirer manuellement.
Lorsque vous obtenez des informations sur le temps du système, le temps peut être soit dans le fuseau horaire local soit en UTC (temps universel coordonné) en fonction du paramètre ``utc``. Cependant, la méthode :ref:`get_unix_time_from_system()<class_Time_method_get_unix_time_from_system>` utilise toujours l'UTC car elle renvoie les secondes passées depuis l'`époque Unix <https://fr.wikipedia.org/wiki/Heure_Unix>`__.
\ **Important :** Les méthodes ``_from_system`` utilisent l'horloge du système que l'utilisateur peut définir manuellement. **N'utilisez jamais** cette méthode pour un calcul précis du temps puisque ses résultats sont soumis à des ajustements automatiques par l'utilisateur ou le système d'exploitation. **Utilisez toujours** :ref:`get_ticks_usec()<class_Time_method_get_ticks_usec>` ou :ref:`get_ticks_msec()<class_Time_method_get_ticks_msec>` pour un calcul précis du temps, car ils sont garantis être monotones (c.-à-d. ne jamais diminuer).
.. rst-class:: classref-reftable-group
Méthodes
----------------
.. table::
:widths: auto
+-------------------------------------+------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+
| :ref:`Dictionary<class_Dictionary>` | :ref:`get_date_dict_from_system<class_Time_method_get_date_dict_from_system>`\ (\ utc\: :ref:`bool<class_bool>` = false\ ) |const| |
+-------------------------------------+------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+
| :ref:`Dictionary<class_Dictionary>` | :ref:`get_date_dict_from_unix_time<class_Time_method_get_date_dict_from_unix_time>`\ (\ unix_time_val\: :ref:`int<class_int>`\ ) |const| |
+-------------------------------------+------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+
| :ref:`String<class_String>` | :ref:`get_date_string_from_system<class_Time_method_get_date_string_from_system>`\ (\ utc\: :ref:`bool<class_bool>` = false\ ) |const| |
+-------------------------------------+------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+
| :ref:`String<class_String>` | :ref:`get_date_string_from_unix_time<class_Time_method_get_date_string_from_unix_time>`\ (\ unix_time_val\: :ref:`int<class_int>`\ ) |const| |
+-------------------------------------+------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+
| :ref:`Dictionary<class_Dictionary>` | :ref:`get_datetime_dict_from_datetime_string<class_Time_method_get_datetime_dict_from_datetime_string>`\ (\ datetime\: :ref:`String<class_String>`, weekday\: :ref:`bool<class_bool>`\ ) |const| |
+-------------------------------------+------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+
| :ref:`Dictionary<class_Dictionary>` | :ref:`get_datetime_dict_from_system<class_Time_method_get_datetime_dict_from_system>`\ (\ utc\: :ref:`bool<class_bool>` = false\ ) |const| |
+-------------------------------------+------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+
| :ref:`Dictionary<class_Dictionary>` | :ref:`get_datetime_dict_from_unix_time<class_Time_method_get_datetime_dict_from_unix_time>`\ (\ unix_time_val\: :ref:`int<class_int>`\ ) |const| |
+-------------------------------------+------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+
| :ref:`String<class_String>` | :ref:`get_datetime_string_from_datetime_dict<class_Time_method_get_datetime_string_from_datetime_dict>`\ (\ datetime\: :ref:`Dictionary<class_Dictionary>`, use_space\: :ref:`bool<class_bool>`\ ) |const| |
+-------------------------------------+------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+
| :ref:`String<class_String>` | :ref:`get_datetime_string_from_system<class_Time_method_get_datetime_string_from_system>`\ (\ utc\: :ref:`bool<class_bool>` = false, use_space\: :ref:`bool<class_bool>` = false\ ) |const| |
+-------------------------------------+------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+
| :ref:`String<class_String>` | :ref:`get_datetime_string_from_unix_time<class_Time_method_get_datetime_string_from_unix_time>`\ (\ unix_time_val\: :ref:`int<class_int>`, use_space\: :ref:`bool<class_bool>` = false\ ) |const| |
+-------------------------------------+------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+
| :ref:`String<class_String>` | :ref:`get_offset_string_from_offset_minutes<class_Time_method_get_offset_string_from_offset_minutes>`\ (\ offset_minutes\: :ref:`int<class_int>`\ ) |const| |
+-------------------------------------+------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+
| :ref:`int<class_int>` | :ref:`get_ticks_msec<class_Time_method_get_ticks_msec>`\ (\ ) |const| |
+-------------------------------------+------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+
| :ref:`int<class_int>` | :ref:`get_ticks_usec<class_Time_method_get_ticks_usec>`\ (\ ) |const| |
+-------------------------------------+------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+
| :ref:`Dictionary<class_Dictionary>` | :ref:`get_time_dict_from_system<class_Time_method_get_time_dict_from_system>`\ (\ utc\: :ref:`bool<class_bool>` = false\ ) |const| |
+-------------------------------------+------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+
| :ref:`Dictionary<class_Dictionary>` | :ref:`get_time_dict_from_unix_time<class_Time_method_get_time_dict_from_unix_time>`\ (\ unix_time_val\: :ref:`int<class_int>`\ ) |const| |
+-------------------------------------+------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+
| :ref:`String<class_String>` | :ref:`get_time_string_from_system<class_Time_method_get_time_string_from_system>`\ (\ utc\: :ref:`bool<class_bool>` = false\ ) |const| |
+-------------------------------------+------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+
| :ref:`String<class_String>` | :ref:`get_time_string_from_unix_time<class_Time_method_get_time_string_from_unix_time>`\ (\ unix_time_val\: :ref:`int<class_int>`\ ) |const| |
+-------------------------------------+------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+
| :ref:`Dictionary<class_Dictionary>` | :ref:`get_time_zone_from_system<class_Time_method_get_time_zone_from_system>`\ (\ ) |const| |
+-------------------------------------+------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+
| :ref:`int<class_int>` | :ref:`get_unix_time_from_datetime_dict<class_Time_method_get_unix_time_from_datetime_dict>`\ (\ datetime\: :ref:`Dictionary<class_Dictionary>`\ ) |const| |
+-------------------------------------+------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+
| :ref:`int<class_int>` | :ref:`get_unix_time_from_datetime_string<class_Time_method_get_unix_time_from_datetime_string>`\ (\ datetime\: :ref:`String<class_String>`\ ) |const| |
+-------------------------------------+------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+
| :ref:`float<class_float>` | :ref:`get_unix_time_from_system<class_Time_method_get_unix_time_from_system>`\ (\ ) |const| |
+-------------------------------------+------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+
.. rst-class:: classref-section-separator
----
.. rst-class:: classref-descriptions-group
Énumérations
------------------------
.. _enum_Time_Month:
.. rst-class:: classref-enumeration
enum **Month**: :ref:`🔗<enum_Time_Month>`
.. _class_Time_constant_MONTH_JANUARY:
.. rst-class:: classref-enumeration-constant
:ref:`Month<enum_Time_Month>` **MONTH_JANUARY** = ``1``
Le mois de janvier, représenté numériquement par ``01``.
.. _class_Time_constant_MONTH_FEBRUARY:
.. rst-class:: classref-enumeration-constant
:ref:`Month<enum_Time_Month>` **MONTH_FEBRUARY** = ``2``
Le mois de février, représenté numériquement par ``02``.
.. _class_Time_constant_MONTH_MARCH:
.. rst-class:: classref-enumeration-constant
:ref:`Month<enum_Time_Month>` **MONTH_MARCH** = ``3``
Le mois de mars, représenté numériquement par ``03``.
.. _class_Time_constant_MONTH_APRIL:
.. rst-class:: classref-enumeration-constant
:ref:`Month<enum_Time_Month>` **MONTH_APRIL** = ``4``
Le mois de avril, représenté numériquement par ``04``.
.. _class_Time_constant_MONTH_MAY:
.. rst-class:: classref-enumeration-constant
:ref:`Month<enum_Time_Month>` **MONTH_MAY** = ``5``
Le mois de mai, représenté numériquement par ``05``.
.. _class_Time_constant_MONTH_JUNE:
.. rst-class:: classref-enumeration-constant
:ref:`Month<enum_Time_Month>` **MONTH_JUNE** = ``6``
Le mois de juin, représenté numériquement par ``06``.
.. _class_Time_constant_MONTH_JULY:
.. rst-class:: classref-enumeration-constant
:ref:`Month<enum_Time_Month>` **MONTH_JULY** = ``7``
Le mois de juillet, représenté numériquement par ``07``.
.. _class_Time_constant_MONTH_AUGUST:
.. rst-class:: classref-enumeration-constant
:ref:`Month<enum_Time_Month>` **MONTH_AUGUST** = ``8``
Le mois de août, représenté numériquement par ``08``.
.. _class_Time_constant_MONTH_SEPTEMBER:
.. rst-class:: classref-enumeration-constant
:ref:`Month<enum_Time_Month>` **MONTH_SEPTEMBER** = ``9``
Le mois de septembre, représenté numériquement par ``09``.
.. _class_Time_constant_MONTH_OCTOBER:
.. rst-class:: classref-enumeration-constant
:ref:`Month<enum_Time_Month>` **MONTH_OCTOBER** = ``10``
Le mois de octobre, représenté numériquement par ``10``.
.. _class_Time_constant_MONTH_NOVEMBER:
.. rst-class:: classref-enumeration-constant
:ref:`Month<enum_Time_Month>` **MONTH_NOVEMBER** = ``11``
Le mois de novembre, représenté numériquement par ``11``.
.. _class_Time_constant_MONTH_DECEMBER:
.. rst-class:: classref-enumeration-constant
:ref:`Month<enum_Time_Month>` **MONTH_DECEMBER** = ``12``
Le mois de décembre, représenté numériquement par ``12``.
.. rst-class:: classref-item-separator
----
.. _enum_Time_Weekday:
.. rst-class:: classref-enumeration
enum **Weekday**: :ref:`🔗<enum_Time_Weekday>`
.. _class_Time_constant_WEEKDAY_SUNDAY:
.. rst-class:: classref-enumeration-constant
:ref:`Weekday<enum_Time_Weekday>` **WEEKDAY_SUNDAY** = ``0``
Le jour de la semaine du dimanche, représenté numériquement par ``0``.
.. _class_Time_constant_WEEKDAY_MONDAY:
.. rst-class:: classref-enumeration-constant
:ref:`Weekday<enum_Time_Weekday>` **WEEKDAY_MONDAY** = ``1``
Le jour de la semaine du lundi, représenté numériquement par ``1``.
.. _class_Time_constant_WEEKDAY_TUESDAY:
.. rst-class:: classref-enumeration-constant
:ref:`Weekday<enum_Time_Weekday>` **WEEKDAY_TUESDAY** = ``2``
Le jour de la semaine du mardi, représenté numériquement par ``2``.
.. _class_Time_constant_WEEKDAY_WEDNESDAY:
.. rst-class:: classref-enumeration-constant
:ref:`Weekday<enum_Time_Weekday>` **WEEKDAY_WEDNESDAY** = ``3``
Le jour de la semaine du mercredi, représenté numériquement par ``3``.
.. _class_Time_constant_WEEKDAY_THURSDAY:
.. rst-class:: classref-enumeration-constant
:ref:`Weekday<enum_Time_Weekday>` **WEEKDAY_THURSDAY** = ``4``
Le jour de la semaine du jeudi, représenté numériquement par ``4``.
.. _class_Time_constant_WEEKDAY_FRIDAY:
.. rst-class:: classref-enumeration-constant
:ref:`Weekday<enum_Time_Weekday>` **WEEKDAY_FRIDAY** = ``5``
Le jour de la semaine du vendredi, représenté numériquement par ``5``.
.. _class_Time_constant_WEEKDAY_SATURDAY:
.. rst-class:: classref-enumeration-constant
:ref:`Weekday<enum_Time_Weekday>` **WEEKDAY_SATURDAY** = ``6``
Le jour de la semaine du samedi, représenté numériquement par ``6``.
.. rst-class:: classref-section-separator
----
.. rst-class:: classref-descriptions-group
Descriptions des méthodes
--------------------------------------------------
.. _class_Time_method_get_date_dict_from_system:
.. rst-class:: classref-method
:ref:`Dictionary<class_Dictionary>` **get_date_dict_from_system**\ (\ utc\: :ref:`bool<class_bool>` = false\ ) |const| :ref:`🔗<class_Time_method_get_date_dict_from_system>`
Renvoie la date actuelle sous forme de dictionnaire avec les clés : ``year``, ``month``, ``day``, ``weekday``.
Les valeurs renvoyées sont dans l'heure locale du système quand ``utc`` vaut ``false``, sinon elle sont en UTC.
.. rst-class:: classref-item-separator
----
.. _class_Time_method_get_date_dict_from_unix_time:
.. rst-class:: classref-method
:ref:`Dictionary<class_Dictionary>` **get_date_dict_from_unix_time**\ (\ unix_time_val\: :ref:`int<class_int>`\ ) |const| :ref:`🔗<class_Time_method_get_date_dict_from_unix_time>`
Convertit l'horodatage Unix donné en un dictionnaire avec les clés : ``year`` (année), ``month`` (mois), ``day`` (jour), et ``weekday`` (jour de la semaine).
.. rst-class:: classref-item-separator
----
.. _class_Time_method_get_date_string_from_system:
.. rst-class:: classref-method
:ref:`String<class_String>` **get_date_string_from_system**\ (\ utc\: :ref:`bool<class_bool>` = false\ ) |const| :ref:`🔗<class_Time_method_get_date_string_from_system>`
Renvoie la date actuelle en tant que chaîne de caractère de date ISO 8601 (AAAA-MM-JJ).
Les valeurs renvoyées sont dans l'heure locale du système lorsque ``utc`` vaut ``false``, sinon elles sont en UTC.
.. rst-class:: classref-item-separator
----
.. _class_Time_method_get_date_string_from_unix_time:
.. rst-class:: classref-method
:ref:`String<class_String>` **get_date_string_from_unix_time**\ (\ unix_time_val\: :ref:`int<class_int>`\ ) |const| :ref:`🔗<class_Time_method_get_date_string_from_unix_time>`
Convertit l'horodatage Unix au format de date ISO 8601 (AAAA-MM-JJ).
.. rst-class:: classref-item-separator
----
.. _class_Time_method_get_datetime_dict_from_datetime_string:
.. rst-class:: classref-method
:ref:`Dictionary<class_Dictionary>` **get_datetime_dict_from_datetime_string**\ (\ datetime\: :ref:`String<class_String>`, weekday\: :ref:`bool<class_bool>`\ ) |const| :ref:`🔗<class_Time_method_get_datetime_dict_from_datetime_string>`
Convertit la chaîne de date et de tmpes ISO 8601 donnée (AAAA-MM-JJTHH:mm:SS) en un dictionnaire avec les clés : ``year`` (année), ``month`` (mois), ``day`` (jour), et ``weekday`` (jour de la semaine), ``hour`` (heure), ``minute``, et ``second``\ es.
Si ``weekday`` vaut ``false``, alors l'entrée ``weekday`` est exclue (le calcul est relativement cher).
\ **Note :** Toute fraction décimale dans la chaîne du temps sera ignorée silencieusement.
.. rst-class:: classref-item-separator
----
.. _class_Time_method_get_datetime_dict_from_system:
.. rst-class:: classref-method
:ref:`Dictionary<class_Dictionary>` **get_datetime_dict_from_system**\ (\ utc\: :ref:`bool<class_bool>` = false\ ) |const| :ref:`🔗<class_Time_method_get_datetime_dict_from_system>`
Renvoie la date actuelle sous forme de dictionnaire avec les clés : ``year`` (année), ``month`` (mois), ``day`` (jour), et ``weekday`` (jour de la semaine), ``hour`` (heure), ``minute``, ``second``\ es, et ``dst`` (Heure d'été).
.. rst-class:: classref-item-separator
----
.. _class_Time_method_get_datetime_dict_from_unix_time:
.. rst-class:: classref-method
:ref:`Dictionary<class_Dictionary>` **get_datetime_dict_from_unix_time**\ (\ unix_time_val\: :ref:`int<class_int>`\ ) |const| :ref:`🔗<class_Time_method_get_datetime_dict_from_unix_time>`
Convertit l'horodatage Unix donné en un dictionnaire avec les clés : ``year`` (année), ``month`` (mois), ``day`` (jour), et ``weekday`` (jour de la semaine), ``hour`` (heure), ``minute``, et ``second``\ es.
Les valeurs du Dictionnary renvoyé seront les mêmes que :ref:`get_datetime_dict_from_system()<class_Time_method_get_datetime_dict_from_system>` si l'horodatage Unix est le temps actuel, à l'exception de l'heure d'été qui ne peut être déterminée depuis l'epoch.
.. rst-class:: classref-item-separator
----
.. _class_Time_method_get_datetime_string_from_datetime_dict:
.. rst-class:: classref-method
:ref:`String<class_String>` **get_datetime_string_from_datetime_dict**\ (\ datetime\: :ref:`Dictionary<class_Dictionary>`, use_space\: :ref:`bool<class_bool>`\ ) |const| :ref:`🔗<class_Time_method_get_datetime_string_from_datetime_dict>`
Convertit le dictionnaire donné en une chaîne de date et de temps ISO 8601 (AAAA-MM-JJTHH:mm:SS).
Le dictionnaire donné peut être peuplé avec les clés suivantes : ``year`` (année), ``month`` (mois), ``day`` (jour), ``hour`` (heure), ``minute``, et ``second``\ es. Toute autre entrée (y compris ``dst``) est ignorée.
Si le dictionnaire est vide, ``0`` est renvoyé. Si des clés sont omises, elles sont remplacées par une valeur par défaut équivalente pour l'horodatage 0 Unix (1970-01-01 à 00:00:00).
Si ``use_space`` vaut ``true``, les parties de date et d'heure sont séparées par un caractère d'espace vide au lieu de la lettre T.
.. rst-class:: classref-item-separator
----
.. _class_Time_method_get_datetime_string_from_system:
.. rst-class:: classref-method
:ref:`String<class_String>` **get_datetime_string_from_system**\ (\ utc\: :ref:`bool<class_bool>` = false, use_space\: :ref:`bool<class_bool>` = false\ ) |const| :ref:`🔗<class_Time_method_get_datetime_string_from_system>`
Renvoie la date et l'heure actuelle au format ISO 8601 (AAAA-MM-JJTHH:mm:SS).
Les valeurs renvoyées sont dans la zone horaire locale du système quand ``utc`` vaut ``false``, sinon elles sont dans la zone horaire UTC (méridien de Greenwich).
Si ``use_space`` vaut ``true``, les parties de temps et d'heure sont séparées par un caractère d'espace vide au lieu de la lettre T.
.. rst-class:: classref-item-separator
----
.. _class_Time_method_get_datetime_string_from_unix_time:
.. rst-class:: classref-method
:ref:`String<class_String>` **get_datetime_string_from_unix_time**\ (\ unix_time_val\: :ref:`int<class_int>`, use_space\: :ref:`bool<class_bool>` = false\ ) |const| :ref:`🔗<class_Time_method_get_datetime_string_from_unix_time>`
Convertit l'horodatage Unix au format de date et heure ISO 8601 (AAAA-MM-JJTHH:mm:SS).
Si ``use_space`` vaut ``true``, les parties de temps et d'heure sont séparées par un caractère d'espace vide au lieu de la lettre T.
.. rst-class:: classref-item-separator
----
.. _class_Time_method_get_offset_string_from_offset_minutes:
.. rst-class:: classref-method
:ref:`String<class_String>` **get_offset_string_from_offset_minutes**\ (\ offset_minutes\: :ref:`int<class_int>`\ ) |const| :ref:`🔗<class_Time_method_get_offset_string_from_offset_minutes>`
Convertit le décalage de fuseau horaire donné en minutes en une chaîne de caractère de décalage de fuseau horaire. Par exemple, -480 renvoie "-08:00", 345 renvoie "+05:45", et 0 renvoie "+00:00".
.. rst-class:: classref-item-separator
----
.. _class_Time_method_get_ticks_msec:
.. rst-class:: classref-method
:ref:`int<class_int>` **get_ticks_msec**\ (\ ) |const| :ref:`🔗<class_Time_method_get_ticks_msec>`
Renvoie le temps passé en millisecondes depuis le démarrage du moteur.
Il sera toujours positif ou 0 et utilise une valeur de 64 bits (il rebouclera après environ 500 millions d'années).
.. rst-class:: classref-item-separator
----
.. _class_Time_method_get_ticks_usec:
.. rst-class:: classref-method
:ref:`int<class_int>` **get_ticks_usec**\ (\ ) |const| :ref:`🔗<class_Time_method_get_ticks_usec>`
Renvoie le temps passé en microsecondes depuis le démarrage du moteur.
Il sera toujours positif ou 0 et utilise une valeur de 64 bits (il rebouclera après environ 500 millions d'années).
.. rst-class:: classref-item-separator
----
.. _class_Time_method_get_time_dict_from_system:
.. rst-class:: classref-method
:ref:`Dictionary<class_Dictionary>` **get_time_dict_from_system**\ (\ utc\: :ref:`bool<class_bool>` = false\ ) |const| :ref:`🔗<class_Time_method_get_time_dict_from_system>`
Renvoie l'heure actuelle sous forme de dictionnaire avec les clés : ``hour`` (heure), ``minute``\ s, et ``second``\ es.
Les valeurs renvoyées sont dans l'heure locale du système quand ``utc`` vaut ``false``, sinon elle sont en UTC.
.. rst-class:: classref-item-separator
----
.. _class_Time_method_get_time_dict_from_unix_time:
.. rst-class:: classref-method
:ref:`Dictionary<class_Dictionary>` **get_time_dict_from_unix_time**\ (\ unix_time_val\: :ref:`int<class_int>`\ ) |const| :ref:`🔗<class_Time_method_get_time_dict_from_unix_time>`
Convertit le temps donné en dictionnaire avec les clés : ``hour`` (heure), ``minute``\ s, et ``second``\ es.
.. rst-class:: classref-item-separator
----
.. _class_Time_method_get_time_string_from_system:
.. rst-class:: classref-method
:ref:`String<class_String>` **get_time_string_from_system**\ (\ utc\: :ref:`bool<class_bool>` = false\ ) |const| :ref:`🔗<class_Time_method_get_time_string_from_system>`
Renvoie l'heure actuelle en une chaîne de caractère ISO 8601 (HH:mm:SS).
Les valeurs renvoyées sont dans l'heure locale du système quand ``utc`` vaut ``false``, sinon elle sont en UTC.
.. rst-class:: classref-item-separator
----
.. _class_Time_method_get_time_string_from_unix_time:
.. rst-class:: classref-method
:ref:`String<class_String>` **get_time_string_from_unix_time**\ (\ unix_time_val\: :ref:`int<class_int>`\ ) |const| :ref:`🔗<class_Time_method_get_time_string_from_unix_time>`
Convertit l'horodatage Unix au format d'heure ISO 8601 (HH:mm:SS).
.. rst-class:: classref-item-separator
----
.. _class_Time_method_get_time_zone_from_system:
.. rst-class:: classref-method
:ref:`Dictionary<class_Dictionary>` **get_time_zone_from_system**\ (\ ) |const| :ref:`🔗<class_Time_method_get_time_zone_from_system>`
Renvoie le fuseau horaire actuel en tant que dictionnaire avec les clés : ``bias`` et ``name``.
- ``bias`` est le décalage avec l'UTC en minutes, puisque tous les fuseaux horaires ne sont pas des multiples d'une heure de l'UTC.
- ``name`` est le nom localisé du fuseau horaire, selon les paramètres locaux de l'OS de l'utilisateur courant.
.. rst-class:: classref-item-separator
----
.. _class_Time_method_get_unix_time_from_datetime_dict:
.. rst-class:: classref-method
:ref:`int<class_int>` **get_unix_time_from_datetime_dict**\ (\ datetime\: :ref:`Dictionary<class_Dictionary>`\ ) |const| :ref:`🔗<class_Time_method_get_unix_time_from_datetime_dict>`
Convertit le dictionnaire de temps donné en un horodatage Unix.
Le dictionnaire donné peut être peuplé avec les clés suivantes : ``year`` (année), ``month`` (mois), ``day`` (jour), ``hour`` (heure), ``minute``, et ``second``\ es. Toute autre entrée (y compris ``dst``) est ignorée.
Si le dictionnaire est vide, ``0`` est renvoyé. Si des clés sont omises, elles sont remplacées par une valeur par défaut équivalente pour le horodatage 0 Unix (1970-01-01 à 00:00:00).
Vous pouvez passer la sortie de :ref:`get_datetime_dict_from_unix_time()<class_Time_method_get_datetime_dict_from_unix_time>` directement dans cette fonction et ré-obtenir la valeur de départ.
\ **Note :** Les horodatages Unix sont souvent en UTC. Cette méthode ne fait aucune conversion de fuseau horaire, de sorte que l'horodatage sera dans le même fuseau horaire que le dictionnaire date-heure donné.
.. rst-class:: classref-item-separator
----
.. _class_Time_method_get_unix_time_from_datetime_string:
.. rst-class:: classref-method
:ref:`int<class_int>` **get_unix_time_from_datetime_string**\ (\ datetime\: :ref:`String<class_String>`\ ) |const| :ref:`🔗<class_Time_method_get_unix_time_from_datetime_string>`
Convertit la chaîne de date et/ou d'heure ISO 8601 donnée en horodatage Unix. La chaîne peut contenir une date seulement, une heure seulement, ou les deux.
\ **Note :** Les horodatage Unix sont souvent en UTC. Cette méthode ne fait aucune conversion de fuseau horaire, de sorte que le horodatage sera dans le même fuseau horaire que le dictionnaire date-heure donné.
\ **Note :** Toute fraction décimale dans la chaîne de l'heure sera ignorée silencieusement.
.. rst-class:: classref-item-separator
----
.. _class_Time_method_get_unix_time_from_system:
.. rst-class:: classref-method
:ref:`float<class_float>` **get_unix_time_from_system**\ (\ ) |const| :ref:`🔗<class_Time_method_get_unix_time_from_system>`
Renvoie le horodatage Unix actuel en secondes en fonction de l'heure du système en UTC. Cette méthode est implémentée par le système d'exploitation et renvoie toujours le temps en UTC. L'horodatage Unix est le nombre de secondes écoulées depuis le 1er janvier 1970 à 00h00m00s, l'`epoch Unix <https://fr.wikipedia.org/wiki/Heure_Unix>`__.
\ **Note :** Contrairement à d'autres méthodes qui utilisent des horodatages entiers, cette méthode renvoie l'horodatage en tant que :ref:`float<class_float>` pour une précision inférieure à la seconde.
.. |virtual| replace:: :abbr:`virtual (Cette méthode doit typiquement être redéfinie par l'utilisateur pour avoir un effet.)`
.. |required| replace:: :abbr:`required (This method is required to be overridden when extending its base class.)`
.. |const| replace:: :abbr:`const (Cette méthode n'a pas d'effets de bord. Elle ne modifie aucune des variables membres de l'instance.)`
.. |vararg| replace:: :abbr:`vararg (Cette méthode accepte n'importe quel nombre d'arguments après ceux décris ici.)`
.. |constructor| replace:: :abbr:`constructor (Cette méthode est utilisée pour construire un type.)`
.. |static| replace:: :abbr:`static (Cette méthode n'a pas besoin d'instance pour être appelée, elle peut donc être directement appelée en utilisant le nom de la classe.)`
.. |operator| replace:: :abbr:`operator (Cette méthode décrit un opérateur valide à utiliser avec ce type en tant qu'opérande gauche.)`
.. |bitfield| replace:: :abbr:`BitField (Cette valeur est un nombre entier composé d'un masque de bits des options suivantes.)`
.. |void| replace:: :abbr:`void (Aucune valeur de retour.)`