As DateTime (from UTC)
KismetTextLibraryЧто это
Pure-функция для преобразования значения DateTime (в формате UTC) в локализованный текст с учётом указанного часового пояса. Возвращает строку вида «4/15/2025 12:30:00 PM», но с поправкой на переданный временной пояс. Не является exec-функцией (не требует последовательного выполнения).
Пины
Exec-входы: нет (pure)
Exec-выходы: нет (pure)
Входы (данные):
- InDateTime (DateTime) — исходная дата/время в UTC
- InTimeZone (String) — идентификатор часового пояса (например,
"Europe/Moscow","America/New_York")
Выходы (данные):
- ReturnValue (Text) — отформатированная строка с датой/временем в указанном часовом поясе
Когда используется
- Отображение времени события, которое хранится в UTC, в конкретном часовом поясе пользователя или сервера.
- Преобразование логов или данных из глобального времени в локальное при выводе в UI.
- Генерация текстовых отчётов с привязкой к региону.
Типичные проблемы
- Некорректный идентификатор часового пояса — если строка не соответствует системным именам (например,
"Moscow"вместо"Europe/Moscow"), функция вернёт пустой текст или выдаст предупреждение в лог. - Забытый перевод из локального времени — если входной
DateTimeуже является локальным (а не UTC), результат будет смещён ещё раз, что приведёт к неверному отображению. - Игнорирование обработки ошибок — функция не возвращает статус успеха; если идентификатор неверен, результат будет пустым, и это может остаться незамеченным при выводе.