Работа с датой и временем в BAS

Автоматизация живёт на времени: метки времени, интервалы, «подождать до завтра», «постить только раз в шесть часов». Модуль «Дата и время» даёт BAS точный и согласованный способ со всем этим работать.

Как BAS хранит время

BAS использует своё представление даты и времени на базе UNIX-времени — количества миллисекунд с полуночи UTC 1 января 1970 года («эра UNIX»). UNIX-время согласуется с UTC и является стандартной кодировкой, принятой в операционных системах.

Хранение времени одним числом миллисекунд даёт реальные плюсы: тривиально сравнивать две даты с точностью до миллисекунды, оно чисто конвертируется в любой человекочитаемый формат и компактно — всего 4 или 8 байт. На больших объёмах куда эффективнее держать время одной величиной, чем набором отдельных полей.

Что умеет модуль

Модуль богат действиями под любую частую нужду:

• Конвертировать дату в строку и строку обратно в дату.
• Конвертировать миллисекунды в дату и обратно.
• Создать дату явно или получить текущую дату сейчас.
• Добавить секунды к дате и вычислить разницу между двумя датами.
• Изменить таймзону даты и прочитать её таймзону.
• Извлечь части: день месяца, день недели, год, месяц, неделю, часы, минуты, секунды, миллисекунды.

Когда к нему обращаться

Используйте его всегда, когда боту нужно проставить данным время, измерить, сколько прошло с события, ограничить действие интервалом или привязать записи к таймзоне. Если вы планируете запуск скрипта в конкретное время, этот модуль покрывает логику — либо опирайтесь на встроенный планировщик. В любом случае, поскольку под капотом всё лежит на миллисекундах UNIX, арифметика времени остаётся согласованной, как бы вы её ни отображали.