Attention: Here be dragons
This is the latest
(unstable) version of this documentation, which may document features
not available in or compatible with released stable versions of Godot.
Checking the stable version of the documentation...
Time
Hérite de : Object
Un singleton pour travailler avec des données temporelles.
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 get_unix_time_from_system() utilise toujours l'UTC car elle renvoie les secondes passées depuis l'époque 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 get_ticks_usec() ou get_ticks_msec() pour un calcul précis du temps, car ils sont garantis être monotones (c.-à-d. ne jamais diminuer).
Méthodes
Énumérations
enum Month: 🔗
Month MONTH_JANUARY = 1
Le mois de janvier, représenté numériquement par 01.
Month MONTH_FEBRUARY = 2
Le mois de février, représenté numériquement par 02.
Month MONTH_MARCH = 3
Le mois de mars, représenté numériquement par 03.
Month MONTH_APRIL = 4
Le mois de avril, représenté numériquement par 04.
Month MONTH_MAY = 5
Le mois de mai, représenté numériquement par 05.
Month MONTH_JUNE = 6
Le mois de juin, représenté numériquement par 06.
Month MONTH_JULY = 7
Le mois de juillet, représenté numériquement par 07.
Month MONTH_AUGUST = 8
Le mois de août, représenté numériquement par 08.
Month MONTH_SEPTEMBER = 9
Le mois de septembre, représenté numériquement par 09.
Month MONTH_OCTOBER = 10
Le mois de octobre, représenté numériquement par 10.
Month MONTH_NOVEMBER = 11
Le mois de novembre, représenté numériquement par 11.
Month MONTH_DECEMBER = 12
Le mois de décembre, représenté numériquement par 12.
enum Weekday: 🔗
Weekday WEEKDAY_SUNDAY = 0
Le jour de la semaine du dimanche, représenté numériquement par 0.
Weekday WEEKDAY_MONDAY = 1
Le jour de la semaine du lundi, représenté numériquement par 1.
Weekday WEEKDAY_TUESDAY = 2
Le jour de la semaine du mardi, représenté numériquement par 2.
Weekday WEEKDAY_WEDNESDAY = 3
Le jour de la semaine du mercredi, représenté numériquement par 3.
Weekday WEEKDAY_THURSDAY = 4
Le jour de la semaine du jeudi, représenté numériquement par 4.
Weekday WEEKDAY_FRIDAY = 5
Le jour de la semaine du vendredi, représenté numériquement par 5.
Weekday WEEKDAY_SATURDAY = 6
Le jour de la semaine du samedi, représenté numériquement par 6.
Descriptions des méthodes
Dictionary get_date_dict_from_system(utc: bool = false) const 🔗
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.
Dictionary get_date_dict_from_unix_time(unix_time_val: int) const 🔗
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).
String get_date_string_from_system(utc: bool = false) const 🔗
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.
String get_date_string_from_unix_time(unix_time_val: int) const 🔗
Convertit l'horodatage Unix au format de date ISO 8601 (AAAA-MM-JJ).
Dictionary get_datetime_dict_from_datetime_string(datetime: String, weekday: bool) const 🔗
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 secondes.
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.
Dictionary get_datetime_dict_from_system(utc: bool = false) const 🔗
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, secondes, et dst (Heure d'été).
Dictionary get_datetime_dict_from_unix_time(unix_time_val: int) const 🔗
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 secondes.
Les valeurs du Dictionnary renvoyé seront les mêmes que 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.
String get_datetime_string_from_datetime_dict(datetime: Dictionary, use_space: bool) const 🔗
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 secondes. 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.
String get_datetime_string_from_system(utc: bool = false, use_space: bool = false) const 🔗
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.
String get_datetime_string_from_unix_time(unix_time_val: int, use_space: bool = false) const 🔗
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.
String get_offset_string_from_offset_minutes(offset_minutes: int) const 🔗
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".
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).
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).
Dictionary get_time_dict_from_system(utc: bool = false) const 🔗
Renvoie l'heure actuelle sous forme de dictionnaire avec les clés : hour (heure), minutes, et secondes.
Les valeurs renvoyées sont dans l'heure locale du système quand utc vaut false, sinon elle sont en UTC.
Dictionary get_time_dict_from_unix_time(unix_time_val: int) const 🔗
Convertit le temps donné en dictionnaire avec les clés : hour (heure), minutes, et secondes.
String get_time_string_from_system(utc: bool = false) const 🔗
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.
String get_time_string_from_unix_time(unix_time_val: int) const 🔗
Convertit l'horodatage Unix au format d'heure ISO 8601 (HH:mm:SS).
Dictionary get_time_zone_from_system() const 🔗
Renvoie le fuseau horaire actuel en tant que dictionnaire avec les clés : bias et name.
biasest le décalage avec l'UTC en minutes, puisque tous les fuseaux horaires ne sont pas des multiples d'une heure de l'UTC.nameest le nom localisé du fuseau horaire, selon les paramètres locaux de l'OS de l'utilisateur courant.
int get_unix_time_from_datetime_dict(datetime: Dictionary) const 🔗
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 secondes. 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 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é.
int get_unix_time_from_datetime_string(datetime: String) const 🔗
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.
float get_unix_time_from_system() const 🔗
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.
Note : Contrairement à d'autres méthodes qui utilisent des horodatages entiers, cette méthode renvoie l'horodatage en tant que float pour une précision inférieure à la seconde.