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

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

Эта функция возвращает дату через n месяцев после даты начала startdate или, если n является отрицательным числом, — дату за n месяцев до даты начала startdate.

Синтаксис:  

AddMonths(startdate, n , [ , mode])

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

Функция addmonths() прибавляет или вычитает определенное количество месяцев, n, из startdate и возвращает полученную дату.

Аргумент mode оказывает влияние на значения startdate начиная с 28 числа месяца. Задавая аргументу mode значение 1, функция addmonths() возвращает дату, которая находится на том же относительном расстоянии до конца месяца, что и startdate.

Диаграмма примера функции addmonths()

Диаграмма с примером того, как различные компоненты функции addmonths объединяются для получения результирующей даты.

Например, 28 февраля является последним днем месяца. Если функция addmonths() с mode = 1 используется для получения даты через два месяца после этой, функция возвращает последнюю дату апреля — 30 апреля.

Диаграмма с примером функции addmonths() с mode=1

Диаграмма с примером того, как изменение аргумента mode позволяет получить другую результирующую дату с помощью функции addmonths.
Аргументы
Аргумент Описание
startdate Начальная дата в виде метки времени, например '2012-10-12'.
n Количество месяцев в виде положительного или отрицательного целого числа.
mode Указывает, добавляется ли месяц относительно начала или конца месяца. Режим по умолчанию при добавлении относительно начала месяца — 0. Для добавлений относительно конца месяца установите режим 1. Если установлен режим 1 и введенная дата — 28-е число или выше, функция оценивает количество дней, оставшихся от начальной даты до конца месяца. То же количество дней до конца месяца устанавливается для возвращенной даты.

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

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

Например, функцию addmonths() можно использовать для определения даты окончания договоров на обслуживание мобильных телефонов.

Примеры функции
Пример Результат
addmonths ('01/29/2003' ,3) Возвращает 04/29/2003.
addmonths ('01/29/2003',3,0) Возвращает 04/29/2003.
addmonths ('01/29/2003',3,1) Возвращает 04/28/2003.
addmonths ('01/29/2003',1,0) Возвращает 02/28/2003.
addmonths ('01/29/2003',1,1) Возвращает 02/26/2003.
addmonths ('02/28/2003',1,0) Возвращает 03/28/2003.
addmonths ('02/28/2003',1,1) Возвращает 03/31/2003.
addmonths ('01/29/2003',-3) Возвращает 10/29/2002.

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

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

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

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

Пример 1. Без дополнительных аргументов

Пример 2. Относительный конец месяца

Пример 3. Пример объекта диаграммы

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

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

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