Time
Успадковує: Object
Однотон для роботи з даними часу.
Опис
Однотон Time дозволяє перетворювати час між різними форматами, а також отримувати інформацію про час від системи.
Даний клас відповідає якнайбільше стандартів ISO 8601. Всі дати слідувати за Пролептичним Григорієм. Так, день до 1582-10-15.1582-10-14, не 1582-10-04. Рік до 1 AD (aka 1 BC) є число 0, з роком до того, що (2 BC) будучи -1 і т.д.
Перетворення методів передбачається "то ж часовий пояс", і не обробляти часові перетворення або DST автоматично. Пропустити секунди також не обробляється, вони повинні бути зроблені вручну при бажанні. Суфікси, такі як "Z" не обробляються, потрібно роздягати їх вручну.
Коли отримувати інформацію про час від системи, час може бути в локальному часовому поясі або UTC залежно від параметра utc. Тим не менш, метод get_unix_time_from_system() завжди використовує UTC, оскільки він повертає секунди, передані з Unix epoch.
Important: _from_system методи використання системного годинника, який користувач може вручну встановити. Never use Цей метод для точного розрахунку часу, оскільки його результати підлягають автоматичним регулюванням користувача або операційної системи. Always use get_ticks_usec() або get_ticks_msec() для точного розрахунку часу замість того, як вони гарантовані бути монотонними (тобто ніколи не зменшуються).
Методи
Переліки
enum Month: 🔗
Month MONTH_JANUARY = 1
Місяць січня, представлений чисельно, як 01.
Month MONTH_FEBRUARY = 2
Місяць лютого, представлений чисельно як 02.
Month MONTH_MARCH = 3
Місяць березня, представлений чисельно як 03.
Month MONTH_APRIL = 4
Місяць квітня, представлений чисельно як 04.
Month MONTH_MAY = 5
Місяць травня, представлений чисельно як 05.
Month MONTH_JUNE = 6
Місяць червня, представлений чисельно як 06.
Month MONTH_JULY = 7
На місяць липня представлено чисельно як 07.
Month MONTH_AUGUST = 8
Рік серпня, представлений чисельно як 08.
Month MONTH_SEPTEMBER = 9
Місяць вересня, представлений чисельно як 09.
Month MONTH_OCTOBER = 10
Місяць жовтня, представлений чисельно як 10.
Month MONTH_NOVEMBER = 11
Місяць листопада, представлений чисельно як 11.
Month MONTH_DECEMBER = 12
Місяць грудня, представлений чисельно, як 12.
enum Weekday: 🔗
Weekday WEEKDAY_SUNDAY = 0
У день неділі тижня, представлений числом, як 0.
Weekday WEEKDAY_MONDAY = 1
День тижня Понеділок, представлена чисельно як 1.
Weekday WEEKDAY_TUESDAY = 2
Днів тижня Вівторок, представлена чисельно як 2.
Weekday WEEKDAY_WEDNESDAY = 3
У день тижня середа, представлена чисельно як 3.
Weekday WEEKDAY_THURSDAY = 4
День тижня Четвер, представлений числом, як 4.
Weekday WEEKDAY_FRIDAY = 5
День тижня П'ятниця, представлена чисельно як 5.
Weekday WEEKDAY_SATURDAY = 6
У день тижня субота, представлена чисельно як 6.
Описи методів
Dictionary get_date_dict_from_system(utc: bool = false) const 🔗
Повертає поточну дату як словник ключів: year, month, day, і weekday.
Повернуті значення в локальний час системи, коли utc false, інакше вони знаходяться в UTC.
Dictionary get_date_dict_from_unix_time(unix_time_val: int) const 🔗
Перетворює заданий Unix timestamp у словник ключів: year, month, day, і weekday.
String get_date_string_from_system(utc: bool = false) const 🔗
Повертає поточну дату ISO 8601 дата рядка (YYYY-MM-DDDD).
Повернуті значення в локальний час системи, коли utc false, інакше вони знаходяться в UTC.
String get_date_string_from_unix_time(unix_time_val: int) const 🔗
Конвертує заданий Unix timestamp до ISO 8601 дата рядка (YYYY-MM-DDDD).
Dictionary get_datetime_dict_from_datetime_string(datetime: String, weekday: bool) const 🔗
Перетворення даної ISO 8601 дата і часовий рядок (YYYY-MM-DDDTHH:MM:SSS) до словника ключів: year, `` місяць``, day, код пропустити-лінтweekday[/код], год, хв, і секунд.
Якщо пам'ятний тиждень є false, то код пропустити-лінтweekday[/код] запис виключено (рахунок порівняно дорого).
Примітка: Будь-яка десяткова дроба в часовому рядку буде ігноруватися мовно.
Dictionary get_datetime_dict_from_system(utc: bool = false) const 🔗
Повертає поточну дату як словник ключів: year, month, day, weekday, час, `` хвилини``, сек, і dst (Daylight Savings Time).
Dictionary get_datetime_dict_from_unix_time(unix_time_val: int) const 🔗
Перетворює заданий Unix timestamp до словника ключів: year, month, day, weekday, год, хвили, і секунд.
Повернуті значення словника будуть такими самими, як get_datetime_dict_from_system(), якщо унікс частамп є поточний час, за винятком Daylight Savings Time, оскільки він не може бути визначений з епоху.
String get_datetime_string_from_datetime_dict(datetime: Dictionary, use_space: bool) const 🔗
Перетворює даний словник ключів до ISO 8601 дата і часовий рядок (YYYY-MM-DDDTHH:MM:SS).
Заданий словник може бути ізольований з наступними ключами: year, `` місяць``, day, год, хвили, і сек. Будь-які інші записи (включаючи dst) ігноруються.
Якщо словник порожній, 0 повертається. Якщо деякі ключі випускаються, вони за замовчуванням до еквівалентних значень для Unix epoch timestamp 0 (1970-01-01 о 00:00:00).
Якщо use_space є true, дата і час біти відокремлені порожньою символом простору замість літери T.
String get_datetime_string_from_system(utc: bool = false, use_space: bool = false) const 🔗
Повертає поточну дату та час як ISO 8601 дата та часовий рядок (YYYY-MM-DDDTHH:MM:SS).
Повернуті значення в локальний час системи, коли utc false, інакше вони знаходяться в UTC.
Якщо use_space є true, дата і час біти відокремлені порожньою символом простору замість літери T.
String get_datetime_string_from_unix_time(unix_time_val: int, use_space: bool = false) const 🔗
Конвертує заданий Unix timestamp до ISO 8601 дата та часовий рядок (YYYY-MM-DDDTHH:MM:SS).
Якщо use_space є true, дата і часові біти відокремлені порожньою символом простору замість літери T.
String get_offset_string_from_offset_minutes(offset_minutes: int) const 🔗
Перетворює заданий часзоновий зсув протягом декількох хвилин на рядок зсуву часу. Наприклад, -480 повертає "-08:00", 345 повертає "+05:45", а 0 повертає "+00:00".
Повертає кількість часу, що пропущена в мілісекундах з моменту запуску двигуна.
Ми завжди повинні бути позитивними або 0 і використовує 64-бітне значення (він буде обгорнути після приблизно 500 мільйонів років).
Повертає кількість часу, що пропущена в мікросекундах, починаючи з початку двигуна.
Чи завжди буде позитивним або 0 і використовує 64-розрядне значення (навіть після грубої половини мільйонів років).
Dictionary get_time_dict_from_system(utc: bool = false) const 🔗
Повертає поточний час як словник ключів: год i `` хвилини,`` i секунд.
Повернуті значення в локальний час системи, коли utc false, інакше вони знаходяться в UTC.
Dictionary get_time_dict_from_unix_time(unix_time_val: int) const 🔗
Перетворює вказаний час у словник ключів: година, хвилина та секунда.
String get_time_string_from_system(utc: bool = false) const 🔗
Повертає поточний час як ISO 8601 рядок часу (HH:MM:SS).
Повернуті значення в локальний час системи, коли utc false, інакше вони знаходяться в UTC.
String get_time_string_from_unix_time(unix_time_val: int) const 🔗
Конвертує заданий Unix timestamp до ISO 8601 рядок часу (HH:MM:SS).
Dictionary get_time_zone_from_system() const 🔗
Повертає поточний часовий пояс як словник ключів: bias і name.
biasє офсетом з UTC за хвилину, так як не всі часові зони є безліччю години з UTC.nameє локалізованою назвою часової зони, відповідно до параметрів локалізації ОС поточного користувача.
int get_unix_time_from_datetime_dict(datetime: Dictionary) const 🔗
Конвертує словник значень часу в Unix.
Заданий словник може бути заповнений наступними ключами: year, `` місяць``, day, год, хвилин, і сек. Будь-які інші записи (включаючи dst) ігноруються.
Якщо словник порожній, 0 повертається. Якщо деякі ключі випускаються, вони за замовчуванням до еквівалентних значень для Unix epoch timestamp 0 (1970-01-01 о 00:00:00).
Ви можете пройти вихід з get_datetime_dict_unix_time_time() безпосередньо в цю функцію і отримати те саме, що було зроблено.
Примітка: Unix частампи часто зустрічаються в UTC. Цей метод не робить ніяких перетворень часового поясу, тому часовий апарат буде в той же час, як даний словник часу.
int get_unix_time_from_datetime_string(datetime: String) const 🔗
Перетворення заданої ISO 8601 дата та / або часової рядки до Unix timestamp. Рядок може містити дату тільки, час тільки, або обидва.
Note: Unix частампи часто зустрічаються в UTC. Цей метод не робить ніяких перетворень часового поясу, тому часовий апарат буде в той же час, як заданий рядок часу.
Примітка: Будь-яка десяткова дроба в рядку часу буде ігноруватися мовно.
float get_unix_time_from_system() const 🔗
Повернення поточної одноразової за секундами на основі системного часу в UTC. Цей метод реалізується операційною системою і завжди повертає час в UTC. Унікс частамп є числом секунд, що пройшли з 1970-01-01 в 00:00:00, Unix epoch.
Примітка: На відміну від інших методів, які використовують цілі мітки часу, цей метод повертає мітку часу, як float для субсекундної точності.