Time
Hereda: Object
Un singleton para trabajar con datos de tiempo.
Descripción
El singleton Time permite convertir el tiempo entre varios formatos y también obtener información del tiempo del sistema.
Esta clase cumple con la mayor cantidad posible de estándares ISO 8601. Todas las fechas siguen el calendario gregoriano proléptico. Como tal, el día anterior a 1582-10-15 es 1582-10-14, no 1582-10-04. El año anterior a 1 d.C. (también conocido como 1 a.C.) es el número 0, y el año anterior a ese (2 a.C.) es -1, etc.
Los métodos de conversión asumen "la misma zona horaria" y no manejan las conversiones de zona horaria o el horario de verano automáticamente. Los segundos bisiestos tampoco se manejan, deben hacerse manualmente si se desea. Los sufijos como "Z" no se manejan, debes eliminarlos manualmente.
Al obtener información de tiempo del sistema, el tiempo puede estar en la zona horaria local o en UTC dependiendo del parámetro utc. Sin embargo, el método get_unix_time_from_system() siempre usa UTC ya que devuelve los segundos transcurridos desde la época de Unix.
Importante: Los métodos _from_system usan el reloj del sistema que el usuario puede configurar manualmente. Nunca uses este método para cálculos de tiempo precisos ya que sus resultados están sujetos a ajustes automáticos por parte del usuario o del sistema operativo. Usa siempre get_ticks_usec() o get_ticks_msec() para cálculos de tiempo precisos en su lugar, ya que se garantiza que sean monótonos (es decir, que nunca disminuyan).
Métodos
Enumeraciones
enum Month: 🔗
Month MONTH_JANUARY = 1
El mes de enero, representado numéricamente como 01.
Month MONTH_FEBRUARY = 2
El mes de febrero, representado numéricamente como 02.
Month MONTH_MARCH = 3
El mes de marzo, representado numéricamente como 03.
Month MONTH_APRIL = 4
El mes de abril, representado numéricamente como 04.
Month MONTH_MAY = 5
El mes de mayo, representado numéricamente como 05.
Month MONTH_JUNE = 6
El mes de junio, representado numéricamente como 06.
Month MONTH_JULY = 7
El mes de julio, representado numéricamente como 07.
Month MONTH_AUGUST = 8
El mes de agosto, representado numéricamente como 08.
Month MONTH_SEPTEMBER = 9
El mes de septiembre, representado numéricamente como 09.
Month MONTH_OCTOBER = 10
El mes de octubre, representado numéricamente como 10.
Month MONTH_NOVEMBER = 11
El mes de noviembre, representado numéricamente como 11.
Month MONTH_DECEMBER = 12
El mes de diciembre, representado numéricamente como 12.
enum Weekday: 🔗
Weekday WEEKDAY_SUNDAY = 0
El día domingo de la semana, representado numéricamente como 0.
Weekday WEEKDAY_MONDAY = 1
El día lunes de la semana, representado numéricamente como 1.
Weekday WEEKDAY_TUESDAY = 2
El día martes de la semana, representado numéricamente como 2.
Weekday WEEKDAY_WEDNESDAY = 3
El día miércoles de la semana, representado numéricamente como 3.
Weekday WEEKDAY_THURSDAY = 4
El día jueves de la semana, representado numéricamente como 4.
Weekday WEEKDAY_FRIDAY = 5
El día viernes de la semana, representado numéricamente como 5.
Weekday WEEKDAY_SATURDAY = 6
El día sábado de la semana, representado numéricamente como 6.
Descripciones de Métodos
Dictionary get_date_dict_from_system(utc: bool = false) const 🔗
Devuelve la fecha actual como un diccionario de claves: year, month, day y weekday.
Los valores devueltos están en la hora local del sistema cuando utc es false, de lo contrario, están en UTC.
Dictionary get_date_dict_from_unix_time(unix_time_val: int) const 🔗
Convierte la marca de tiempo de Unix dada en un diccionario de claves: year, month, day y weekday.
String get_date_string_from_system(utc: bool = false) const 🔗
Devuelve la fecha actual como una cadena de fecha ISO 8601 (AAAA-MM-DD).
Los valores devueltos están en la hora local del sistema cuando utc es false, de lo contrario, están en UTC.
String get_date_string_from_unix_time(unix_time_val: int) const 🔗
Convierte la marca de tiempo de Unix dada en una string de fecha ISO 8601 (AAAA-MM-DD).
Dictionary get_datetime_dict_from_datetime_string(datetime: String, weekday: bool) const 🔗
Converts the given ISO 8601 date and time string (YYYY-MM-DDTHH:MM:SS) to a dictionary of keys: year, month, day, weekday, hour, minute, and second.
If weekday is false, then the weekday entry is excluded (the calculation is relatively expensive).
Note: Any decimal fraction in the time string will be ignored silently.
Dictionary get_datetime_dict_from_system(utc: bool = false) const 🔗
Devuelve la fecha actual como un diccionario de claves: year, month, day, weekday, hour, minute, second y dst (horario de verano).
Dictionary get_datetime_dict_from_unix_time(unix_time_val: int) const 🔗
Convierte la marca de tiempo de Unix dada en un diccionario de claves: year, month, day, weekday, hour, minute y second.
Los valores del diccionario devuelto serán los mismos que los de get_datetime_dict_from_system() si la marca de tiempo de Unix es la hora actual, con la excepción del horario de verano, ya que no se puede determinar a partir de la época.
String get_datetime_string_from_datetime_dict(datetime: Dictionary, use_space: bool) const 🔗
Convierte el diccionario de claves dado en una string de fecha y hora ISO 8601 (AAAA-MM-DDTHH:MM:SS).
El diccionario dado se puede rellenar con las siguientes claves: year, month, day, hour, minute y second. Cualquier otra entrada (incluyendo dst) se ignora.
Si el diccionario está vacío, se devuelve 0. Si se omiten algunas claves, el valor predeterminado es el equivalente a la marca de tiempo de la época de Unix 0 (1970-01-01 a las 00:00:00).
Si use_space es true, los bits de fecha y hora se separan con un carácter de espacio vacío en lugar de la letra T.
String get_datetime_string_from_system(utc: bool = false, use_space: bool = false) const 🔗
Devuelve la fecha y hora actuales como una string de fecha y hora ISO 8601 (AAAA-MM-DDTHH:MM:SS).
Los valores devueltos están en la hora local del sistema cuando utc es false; de lo contrario, están en UTC.
Si use_space es true, los bits de fecha y hora se separan con un carácter de espacio vacío en lugar de la letra T.
String get_datetime_string_from_unix_time(unix_time_val: int, use_space: bool = false) const 🔗
Convierte la marca de tiempo de Unix dada en una string de fecha y hora ISO 8601 (AAAA-MM-DDTHH:MM:SS).
Si use_space es true, los bits de fecha y hora se separan con un carácter de espacio vacío en lugar de la letra T.
String get_offset_string_from_offset_minutes(offset_minutes: int) const 🔗
Convierte el desplazamiento de la zona horaria dado en minutos en una string de desplazamiento de la zona horaria. Por ejemplo, -480 devuelve "-08:00", 345 devuelve "+05:45" y 0 devuelve "+00:00".
Devuelve la cantidad de tiempo transcurrido en milisegundos desde que se inició el motor.
Siempre será positivo o 0 y utiliza un valor de 64 bits (se ajustará después de aproximadamente 500 millones de años).
Devuelve la cantidad de tiempo transcurrido en microsegundos desde que se inició el motor.
Siempre será positivo o 0 y utiliza un valor de 64 bits (se ajustará después de aproximadamente medio millón de años).
Dictionary get_time_dict_from_system(utc: bool = false) const 🔗
Devuelve la hora actual como un diccionario de claves: hour, minute y second.
Los valores devueltos están en la hora local del sistema cuando utc es false; de lo contrario, están en UTC.
Dictionary get_time_dict_from_unix_time(unix_time_val: int) const 🔗
Convierte la hora dada en un diccionario de claves: hour, minute y second.
String get_time_string_from_system(utc: bool = false) const 🔗
Devuelve la hora actual como una string de hora ISO 8601 (HH:MM:SS).
Los valores devueltos están en la hora local del sistema cuando utc es false; de lo contrario, están en UTC.
String get_time_string_from_unix_time(unix_time_val: int) const 🔗
Convierte la marca de tiempo de Unix dada en una string de hora ISO 8601 (HH:MM:SS).
Dictionary get_time_zone_from_system() const 🔗
Devuelve la zona horaria actual como un diccionario de claves: bias y name.
biases la diferencia con respecto a UTC en minutos, ya que no todas las zonas horarias son múltiplos de una hora con respecto a UTC.namees el nombre localizado de la zona horaria, de acuerdo con la configuración regional del sistema operativo del usuario actual.
int get_unix_time_from_datetime_dict(datetime: Dictionary) const 🔗
Convierte un diccionario de valores de tiempo a un timestamp de Unix.
El diccionario dado puede ser rellenado con las siguientes claves: year, month, day, hour, minute, y second. Cualquier otra entrada (incluyendo dst) se ignora.
Si el diccionario está vacío, se devuelve 0. Si algunas claves se omiten, se establece por defecto el valor equivalente para el timestamp de la época de Unix 0 (1970-01-01 a las 00:00:00).
Puedes pasar la salida de get_datetime_dict_from_unix_time() directamente a esta función y obtener lo mismo que se introdujo.
Nota: Los timestamps de Unix suelen estar en UTC. Este método no realiza ninguna conversión de zona horaria, por lo que el timestamp estará en la misma zona horaria que el diccionario de fecha y hora dado.
int get_unix_time_from_datetime_string(datetime: String) const 🔗
Convierte la string de fecha y/u hora ISO 8601 dada a un timestamp de Unix. La string puede contener solo una fecha, solo una hora o ambas.
Nota: Los timestamps de Unix suelen estar en UTC. Este método no realiza ninguna conversión de zona horaria, por lo que el timestamp estará en la misma zona horaria que la string de fecha y hora dada.
Nota: Cualquier fracción decimal en la string de tiempo se ignorará silenciosamente.
float get_unix_time_from_system() const 🔗
Devuelve el timestamp de Unix actual en segundos basado en la hora del sistema en UTC. Este método es implementado por el sistema operativo y siempre devuelve la hora en UTC. El timestamp de Unix es el número de segundos transcurridos desde 1970-01-01 a las 00:00:00, la época de Unix.
Nota: A diferencia de otros métodos que utilizan timestamps enteros, este método devuelve el timestamp como un float para una precisión de sub-segundos.