Перейти к основному содержимому Перейти к дополнительному содержимому

today — функция скриптa и диаграммы

Эта функция возвращает текущую дату. Эта функция возвращает значения в формате системной переменной DateFormat.

Синтаксис:  

today([ timer_mode])

Возвращаемые типы данных: двойное значение

Функцию today() можно использовать в скрипте загрузки или в объектах диаграммы.

Значение timer_mode по умолчанию — 1.

Аргументы
Аргумент Описание
timer_mode

Может иметь следующие значения:

0 (день последней завершенной загрузки данных)
1 (день вызова функции)
2 (день открытия приложения)

Примечание к информацииЕсли функция используется в скрипте загрузки данных, функция timer_mode=0 выдает день последней завершенной загрузки данных, а timer_mode=1 выдает день текущей загрузки данных.
Примеры функции
Значение timer_mode Результат при использовании в скрипте загрузки Результат при использовании в объекте диаграммы
0 Возвращает дату в формате системной переменной DateFormat для даты последней успешной перезагрузки, предшествующей самой последней перезагрузке данных. Возвращает дату в формате системной переменной DateFormat для даты самой последней перезагрузки данных.

1

Возвращает дату в формате системной переменной DateFormat для самой последней перезагрузки данных. Возвращает дату вызова функции в формате системной переменной DateFormat.

2

Возвращает дату в формате системной переменной DateFormat для начала сеанса пользователя в приложении. Это значение не будет обновляться, если пользователь не перезагрузит скрипт. Возвращает дату в формате системной переменной DateFormat для начала сеанса пользователя в приложении. Это значение будет обновляться в случае начала нового сеанса или перезагрузки данных в приложение.

Когда это следует использовать

Функция today() часто используется как компонент внутри выражения. Например, можно ее использовать, если требуется рассчитать проценты, накопленные в течение месяца до текущей даты.

В следующей таблице приводится объяснение результата, возвращаемого функцией today(), в зависимости от различных значений аргумента timer_mode:

Региональные настройки

Если не указано иное, в примерах, приведенных в данном разделе, используется следующий формат даты: ММ/ДД/ГГГГ. Формат даты указан в операторе SET DateFormat скрипта загрузки данных. В вашей системе может быть установлен другой формат даты по умолчанию в зависимости от региональных настроек и других факторов. Можно изменить формат в примерах в соответствии с потребностями. Или можно изменить форматы в скрипте загрузки в соответствии с этими примерами. Для получения дополнительной информации см. Изменение региональных настроек для создания приложений и скриптов.

Региональные настройки по умолчанию в приложениях основаны на профиле пользователя. Эти параметры регионального формата не связаны с языком, отображаемым в интерфейсе пользователя Qlik Cloud. Qlik Cloud будет отображаться на языке, который используется в браузере.

Если вы — разработчик приложений, то можете задать регион по умолчанию для создаваемых приложений. Для получения дополнительной информации см. Установка предпочтительных региональных настроек для создания приложений и скриптов в Аналитика Qlik Cloud.

Пример 1. Создание объектов с использованием скрипта загрузки

Пример 2. Создание объектов без использования скрипта загрузки

Пример 3. Сценарий

Помогла ли вам эта страница?

Если вы обнаружили какую-либо проблему на этой странице и с ее содержанием — будь то опечатка, пропущенный шаг или техническая ошибка, сообщите нам об этом, чтобы мы смогли ее исправить!