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

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

Эта функция возвращает 4-значное значение года с базовым числовым значением, соответствующим метке времени с первой миллисекундой первого дня года, содержащего значение, указанное в поле date.

Диаграмма диапазона времени функции yearname().

Диаграмма, показывающая диапазон времени, в рамках которого функция yearname возвращает результат.

Функция yearname() отличается от функции year() тем, что позволяет сместить дату, которую требуется оценить, и позволяет задать первый месяц года.

Если первый месяц года не январь, функция вернет два четырехзначных значения года в течение двенадцатимесячного периода, содержащего дату. Например, если начало года — апрель, а оцениваемая дата — 06/30/2020, будет возвращен результат будет 2020-2021.

Диаграмма функции yearname(), где в качестве первого месяца года задан апрель.

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

Синтаксис:  

YearName(date[, period_no[, first_month_of_year]] )

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

Аргумент Описание
date Дата или метка времени для вычисления.
period_no period_no — целое число, где 0 обозначает год, включающий значение, указанное в поле date. Отрицательные значения, заданные в поле period_no, означают предшествующие годы, положительные — последующие.
first_month_of_year Если необходимо работать с годами (финансовыми), которые начинаются не в январе, задайте значение от 2 до 12 в поле first_month_of_year. Отображаемое значение будет строчным, показывающим два года.

Можно использовать следующие значения, чтобы задать первый месяц года в аргументе first_month_of_year:

значения first_month_of_year
Месяц Значение
Февраль 2
Март 3
Апрель 4
May 5
Июнь 6
Июль 7
Август 8
Сентябрь 9
Октябрь 10
Ноябрь 11
Декабрь 12

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

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

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

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

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

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

Примеры функции
Пример Результат
yearname('10/19/2001') Возвращает «2001».
yearname('10/19/2001',-1) Возвращает «2000».
yearname('10/19/2001',0,4) Возвращает «2001-2002».
Связанные темы
Тема Описание
year — функция скриптa и диаграммы Эта функция возвращает год в виде целого числа, а выражение интерпретируется как дата согласно стандартной интерпретации чисел.

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

Пример 2. Скрипт period_no

Пример 3. Аргумент first_month_of_year

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

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

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

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