godotengine/godot-docs-l10n
1
0
Fork 0
mirror of https://github.com/godotengine/godot-docs-l10n.git synced 2025-12-31 09:49:22 +03:00
Code Issues Packages Projects Releases Wiki Activity
Files
4.x
godot-docs-l10n/classes/zh_Hant/class_time.rst

570 lines
29 KiB
ReStructuredText
Raw Permalink Blame History

This file contains ambiguous Unicode characters

This file contains Unicode characters that might be confused with other characters. 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
====
**繼承：** :ref:`Object<class_Object>`
用於處理時間資料的單例。
.. rst-class:: classref-introduction-group
說明
----
The Time singleton allows converting time between various formats and also getting time information from the system.
This class conforms with as many of the ISO 8601 standards as possible. All dates follow the Proleptic Gregorian calendar. As such, the day before ``1582-10-15`` is ``1582-10-14``, not ``1582-10-04``. The year before 1 AD (aka 1 BC) is number ``0``, with the year before that (2 BC) being ``-1``, etc.
Conversion methods assume "the same timezone", and do not handle timezone conversions or DST automatically. Leap seconds are also not handled, they must be done manually if desired. Suffixes such as "Z" are not handled, you need to strip them away manually.
When getting time information from the system, the time can either be in the local timezone or UTC depending on the ``utc`` parameter. However, the :ref:`get_unix_time_from_system()<class_Time_method_get_unix_time_from_system>` method always uses UTC as it returns the seconds passed since the `Unix epoch <https://en.wikipedia.org/wiki/Unix_time>`__.
\ **Important:** The ``_from_system`` methods use the system clock that the user can manually set. **Never use** this method for precise time calculation since its results are subject to automatic adjustments by the user or the operating system. **Always use** :ref:`get_ticks_usec()<class_Time_method_get_ticks_usec>` or :ref:`get_ticks_msec()<class_Time_method_get_ticks_msec>` for precise time calculation instead, since they are guaranteed to be monotonic (i.e. never decrease).
.. rst-class:: classref-reftable-group
方法
----
.. 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
列舉
----
.. _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``
一月份，使用數字 ``01`` 表示。
.. _class_Time_constant_MONTH_FEBRUARY:
.. rst-class:: classref-enumeration-constant
:ref:`Month<enum_Time_Month>` **MONTH_FEBRUARY** = ``2``
二月份，使用數字 ``02`` 表示。
.. _class_Time_constant_MONTH_MARCH:
.. rst-class:: classref-enumeration-constant
:ref:`Month<enum_Time_Month>` **MONTH_MARCH** = ``3``
三月份，使用數字 ``03`` 表示。
.. _class_Time_constant_MONTH_APRIL:
.. rst-class:: classref-enumeration-constant
:ref:`Month<enum_Time_Month>` **MONTH_APRIL** = ``4``
四月份，使用數字 ``04`` 表示。
.. _class_Time_constant_MONTH_MAY:
.. rst-class:: classref-enumeration-constant
:ref:`Month<enum_Time_Month>` **MONTH_MAY** = ``5``
五月份，使用數字 ``05`` 表示。
.. _class_Time_constant_MONTH_JUNE:
.. rst-class:: classref-enumeration-constant
:ref:`Month<enum_Time_Month>` **MONTH_JUNE** = ``6``
六月份，使用數字 ``06`` 表示。
.. _class_Time_constant_MONTH_JULY:
.. rst-class:: classref-enumeration-constant
:ref:`Month<enum_Time_Month>` **MONTH_JULY** = ``7``
七月份，使用數字 ``07`` 表示。
.. _class_Time_constant_MONTH_AUGUST:
.. rst-class:: classref-enumeration-constant
:ref:`Month<enum_Time_Month>` **MONTH_AUGUST** = ``8``
八月份，使用數字 ``08`` 表示。
.. _class_Time_constant_MONTH_SEPTEMBER:
.. rst-class:: classref-enumeration-constant
:ref:`Month<enum_Time_Month>` **MONTH_SEPTEMBER** = ``9``
九月份，使用數字 ``09`` 表示。
.. _class_Time_constant_MONTH_OCTOBER:
.. rst-class:: classref-enumeration-constant
:ref:`Month<enum_Time_Month>` **MONTH_OCTOBER** = ``10``
十月份，使用數字 ``10`` 表示。
.. _class_Time_constant_MONTH_NOVEMBER:
.. rst-class:: classref-enumeration-constant
:ref:`Month<enum_Time_Month>` **MONTH_NOVEMBER** = ``11``
十一月份，使用數字 ``11`` 表示。
.. _class_Time_constant_MONTH_DECEMBER:
.. rst-class:: classref-enumeration-constant
:ref:`Month<enum_Time_Month>` **MONTH_DECEMBER** = ``12``
十二月份，使用數字 ``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``
星期日，使用數字 ``0`` 表示。
.. _class_Time_constant_WEEKDAY_MONDAY:
.. rst-class:: classref-enumeration-constant
:ref:`Weekday<enum_Time_Weekday>` **WEEKDAY_MONDAY** = ``1``
星期一，使用數字 ``1`` 表示。
.. _class_Time_constant_WEEKDAY_TUESDAY:
.. rst-class:: classref-enumeration-constant
:ref:`Weekday<enum_Time_Weekday>` **WEEKDAY_TUESDAY** = ``2``
星期二，使用數字 ``2`` 表示。
.. _class_Time_constant_WEEKDAY_WEDNESDAY:
.. rst-class:: classref-enumeration-constant
:ref:`Weekday<enum_Time_Weekday>` **WEEKDAY_WEDNESDAY** = ``3``
星期三，使用數字 ``3`` 表示。
.. _class_Time_constant_WEEKDAY_THURSDAY:
.. rst-class:: classref-enumeration-constant
:ref:`Weekday<enum_Time_Weekday>` **WEEKDAY_THURSDAY** = ``4``
星期四，使用數字 ``4`` 表示。
.. _class_Time_constant_WEEKDAY_FRIDAY:
.. rst-class:: classref-enumeration-constant
:ref:`Weekday<enum_Time_Weekday>` **WEEKDAY_FRIDAY** = ``5``
星期五，使用數字 ``5`` 表示。
.. _class_Time_constant_WEEKDAY_SATURDAY:
.. rst-class:: classref-enumeration-constant
:ref:`Weekday<enum_Time_Weekday>` **WEEKDAY_SATURDAY** = ``6``
星期六，使用數字 ``6`` 表示。
.. rst-class:: classref-section-separator
----
.. rst-class:: classref-descriptions-group
方法說明
--------
.. _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>`
以字典的形式返回目前時間，包含的鍵為：\ ``year``\ 、\ ``month``\ 、\ ``day`` 和 ``weekday``\ 。
當 ``utc`` 為 ``false`` 時，返回的是系統的本地時間，否則為 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>`
將給定的 Unix 時間戳記轉換為字典，包含的鍵為：\ ``year``\ 、\ ``month``\ 、\ ``day``\ 、\ ``weekday``\ 。
.. 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>`
以 ISO 8601 日期字串的形式返回目前日期（YYYY-MM-DD）。
當 ``utc`` 為 ``false`` 時，返回的是系統的本地時間，否則為 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>`
將給定的 Unix 時間戳記轉換為 ISO 8601 日期字串（YYYY-MM-DD）。
.. 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>`
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.
.. 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>`
以字典形式返回目前日期，包含的鍵為：\ ``year``\ 、\ ``month``\ 、\ ``day``\ 、\ ``weekday``\ 、\ ``hour``\ 、\ ``minute``\ 、\ ``second`` 以及 ``dst``\ （夏令時，Daylight Savings Time）。
.. 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>`
將給定的 Unix 時間戳記轉換為字典，包含的鍵為：\ ``year``\ 、\ ``month``\ 、\ ``day``\ 、\ ``weekday``\ 、\ ``hour``\ 、\ ``minute``\ 、和 ``second``\ 。
如果 Unix 時間戳記是目前時間，則返回的字典值將與 :ref:`get_datetime_dict_from_system()<class_Time_method_get_datetime_dict_from_system>` 相同，夏令時除外，因為它無法根據紀元確定。
.. 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>`
將給定的時間值字典轉換為 ISO 8601 日期和時間字串（YYYY-MM-DDTHH:MM:SS）。
給定的字典可以包含以下鍵：\ ``year``\ 、\ ``month``\ 、\ ``day``\ 、\ ``hour``\ 、\ ``minute``\ 、\ ``second``\ 。其他的記錄（包括 ``dst``\ ）都會被忽略。
字典為空時將返回 ``0``\ 。如果省略了部分鍵，預設使用 Unix 紀元時間戳記 0（1970-01-01 的 00:00:00）的對應部分。
當 ``use_space`` 為 ``true`` 時，將使用空格代替中間的字母 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>`
以 ISO 8601 日期和時間字串的形式返回目前日期和時間（YYYY-MM-DDTHH:MM:SS）。
當 ``utc`` 為 ``false`` 時，返回的是系統的本地時間，否則為 UTC 時間。
當 ``use_space`` 為 ``true`` 時，將使用空格代替中間的字母 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>`
將給定的 Unix 時間戳記轉換為 ISO 8601 日期和時間字串（YYYY-MM-DDTHH:MM:SS）。
當 ``use_space`` 為 ``true`` 時，將使用空格代替中間的字母 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>`
將給定的時區偏移分鐘數轉換為時區偏移字串。例如，-480 返回 "-08:00"、345 返回 "+05:45"、0 返回 "+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>`
返回從引擎啟動開始所經過的時間，單位為毫秒。
始終為正數或 0，使用 64 位值（會在約 5 億年後繞回）。
.. 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>`
返回從引擎啟動開始所經過的時間，單位為微秒。
始終為正數或 0，使用 64 位值（會在約 50 萬年後繞回）。
.. 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>`
以字典的形式返回目前時間，包含的鍵為：\ ``hour``\ 、\ ``minute``\ 、\ ``second``\ 。
當 ``utc`` 為 ``false`` 時，返回的是系統的本地時間，否則為 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>`
將給定的時間轉換為字典，包含的鍵為：時 ``hour``\ 、分 ``minute``\ 、秒 ``second``\ 。
.. 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>`
以 ISO 8601 時間字串的形式返回目前時間（HH:MM:SS）。
當 ``utc`` 為 ``false`` 時，返回的是系統的本地時間，否則為 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>`
將給定的 Unix 時間戳記轉換為 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>`
Returns the current time zone as a dictionary of keys: ``bias`` and ``name``.
- ``bias`` is the offset from UTC in minutes, since not all time zones are multiples of an hour from UTC.
- ``name`` is the localized name of the time zone, according to the OS locale settings of the current user.
.. 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>`
將時間值字典轉換為 Unix 時間戳記。
給定的字典可以包含以下鍵：\ ``year``\ 、\ ``month``\ 、\ ``day``\ 、\ ``hour``\ 、\ ``minute``\ 、\ ``second``\ 。其他的記錄（包括 ``dst``\ ）都會被忽略。
字典為空時將返回 ``0``\ 。如果省略了部分鍵，預設使用 Unix 紀元時間戳記 0（1970-01-01 的 00:00:00）的對應部分。
你可以將 :ref:`get_datetime_dict_from_unix_time()<class_Time_method_get_datetime_dict_from_unix_time>` 的輸出直接傳給本函式，得到的就是最初的輸入。
\ **注意：**\ Unix 時間戳記通常是 UTC 的。本方法不會做任何時區轉換，所以時間戳記的時區與給定的日期時間字典相同。
.. 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>`
將給定的 ISO 8601 日期和/或時間字串轉換為 Unix 時間戳記。字串中可以只包含日期、只包含時間，也可以兩者都包含。
\ **注意：**\ Unix 時間戳記通常是 UTC 的。本方法不會做任何時區轉換，所以時間戳記的時區與給定的日期時間字串相同。
\ **注意：**\ 時間字串中的小數會被靜默忽略。
.. 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>`
Returns the current Unix timestamp in seconds based on the system time in UTC. This method is implemented by the operating system and always returns the time in UTC. The Unix timestamp is the number of seconds passed since 1970-01-01 at 00:00:00, the `Unix epoch <https://en.wikipedia.org/wiki/Unix_time>`__.
\ **Note:** Unlike other methods that use integer timestamps, this method returns the timestamp as a :ref:`float<class_float>` for sub-second precision.
.. |virtual| replace:: :abbr:`virtual (本方法通常需要使用者覆寫才能生效。)`
.. |required| replace:: :abbr:`required (This method is required to be overridden when extending its base class.)`
.. |const| replace:: :abbr:`const (本方法沒有副作用。不會修改該實例的任何成員變數。)`
.. |vararg| replace:: :abbr:`vararg (本方法除了這裡描述的參數外，還可以接受任意數量的參數。)`
.. |constructor| replace:: :abbr:`constructor (本方法用於建構一個型別。)`
.. |static| replace:: :abbr:`static (本方法無需實例即可呼叫，因此可以直接使用類別名稱呼叫。)`
.. |operator| replace:: :abbr:`operator (本方法描述將本型別作為左運算元時可用的有效運算子。)`
.. |bitfield| replace:: :abbr:`BitField (此值是由下列旗標組成的位元遮罩整數。)`
.. |void| replace:: :abbr:`void (無回傳值。)`
Reference in New Issue View Git Blame Copy Permalink