month  — функция скриптa и диаграммы
                Эта функция возвращает двойное значение с именем месяца, как определено переменной окружения MonthNames, и целое в диапазоне от 1 до 12. Месяц высчитывается на основе интерпретации данных выражения согласно стандартной интерпретации чисел.
Функция возвращает название месяца в формате системной переменной MonthName для определенной даты. Она широко используется с целью создания поля дня в качестве измерения в основном календаре.
Синтаксис:
month(expression)
Возвращаемые типы данных: целое
| Пример | Результат | 
|---|---|
| 
                                 month( 2012-10-12 )  | 
                            возвращает Oct (октябрь) | 
| month( 35648 ) | возвращает Aug (август), так как 35648 = 1997–08–06 | 
Пример 1. Набор данных DateFormat (скрипт)
Обзор
Откройте Редактор загрузки данных и добавьте приведенный ниже скрипт загрузки на новую вкладку.
Скрипт загрузки содержит следующее:
- 
                                    
Набор данных с датами под именем Master_Calendar. Системной переменной DateFormat задано значение DD/MM/YYYY.
 - 
                                    
Предшествующая загрузка, создающая дополнительное поле под именем month_name с использованием функции month().
 - 
                                    
Дополнительное поле под именем long_date с использованием функции date() для выражения даты в полном формате.
 
Скрипт загрузки
SET DateFormat='DD/MM/YYYY';
Master_Calendar:
Load
        date,
        date(date,'dd-MMMM-YYYY') as long_date,
        month(date) as month_name
Inline 
[
date
03/01/2022
03/02/2022
03/03/2022
03/04/2022
03/05/2022
03/06/2022
03/07/2022
03/08/2022
03/09/2022
03/10/2022
03/11/2022
];
Результаты
Загрузите данные и откройте лист. Создайте новую таблицу и добавьте эти поля как измерения:
- 
                                    
date
 - 
                                    
long_date
 - 
                                    
month_name
 
| 
                                             date  | 
                                        
                                             long_date  | 
                                        
                                             monthname  | 
                                    
|---|---|---|
| 
                                             03/01/2022  | 
                                        
                                             03-January- 2022  | 
                                        
                                             Jan  | 
                                    
| 
                                             03/02/2022  | 
                                        
                                             03-February- 2022  | 
                                        
                                             Feb  | 
                                    
| 
                                             03/03/2022  | 
                                        
                                             03-March- 2022  | 
                                        
                                             Mar  | 
                                    
| 
                                             03/04/2022  | 
                                        
                                             03-April- 2022  | 
                                        
                                             Apr  | 
                                    
| 
                                             03/05/2022  | 
                                        
                                             03-May- 2022  | 
                                        
                                             May  | 
                                    
| 
                                             03/06/2022  | 
                                        
                                             03-June- 2022  | 
                                        
                                             Jun  | 
                                    
| 
                                             03/07/2022  | 
                                        
                                             03-July- 2022  | 
                                        
                                             Jul  | 
                                    
| 
                                             03/08/2022  | 
                                        
                                             03-August- 2022  | 
                                        
                                             Aug  | 
                                    
| 
                                             03/09/2022  | 
                                        
                                             03-September- 2022  | 
                                        
                                             Sep  | 
                                    
| 
                                             03/10/2022  | 
                                        
                                             03-October- 2022  | 
                                        
                                             Oct  | 
                                    
| 
                                             03/11/2022  | 
                                        
                                             03-November- 2022  | 
                                        
                                             Nov  | 
                                    
Имя месяца правильно вычисляется функцией month() в скрипте.
Пример 2. Даты ANSI (скрипт)
Обзор
Откройте Редактор загрузки данных и добавьте приведенный ниже скрипт загрузки на новую вкладку.
Скрипт загрузки содержит следующее:
- 
                                    
Набор данных с датами под именем Master_Calendar. Используется системная переменная DateFormat DD/MM/YYYY. Однако даты, включенные в набор данных, имеют формат стандарта ANSI.
 - 
                                    
Предшествующая загрузка, создающая дополнительное поле под именем month_name с использованием функции month().
 - 
                                    
Дополнительное поле под именем long_date с использованием функции date() для выражения даты в полном формате.
 
Скрипт загрузки
SET DateFormat='DD/MM/YYYY'; 
Master_Calendar: 
Load 
       date, 
       date(date,'dd-MMMM-YYYY') as long_date, 
       month(date) as month_name 
Inline  
[ 
date 
2022-01-11 
2022-02-12 
2022-03-13 
2022-04-14 
2022-05-15 
2022-06-16 
2022-07-17 
2022-08-18 
2022-09-19
2022-10-20 
2022-11-21 
]; 
Результаты
Загрузите данные и откройте лист. Создайте новую таблицу и добавьте эти поля как измерения:
- 
                                    
date
 - 
                                    
long_date
 - 
                                    
month_name
 
| 
                                             date  | 
                                        
                                             long_date  | 
                                        
                                             month_name  | 
                                    
|---|---|---|
| 03/11/2022 | 11-March- 2022 | 11 | 
| 03/12/2022 | 12-March- 2022 | 12 | 
| 03/13/2022 | 13-March- 2022 | 13 | 
| 03/14/2022 | 14-March- 2022 | 14 | 
| 03/15/2022 | 15-March- 2022 | 15 | 
| 03/16/2022 | 16-March- 2022 | 16 | 
| 03/17/2022 | 17-March- 2022 | 17 | 
| 03/18/2022 | 18-March- 2022 | 18 | 
| 03/19/2022 | 19-March- 2022 | 19 | 
| 03/20/2022 | 20-March- 2022 | 20 | 
| 03/21/2022 | 21-March- 2022 | 21 | 
Имя месяца правильно вычисляется функцией month() в скрипте.
Пример 3. Неформатированные даты (скрипт)
Обзор
Откройте Редактор загрузки данных и добавьте приведенный ниже скрипт загрузки на новую вкладку.
Скрипт загрузки содержит следующее:
- 
                                    
Набор данных с датами под именем Master_Calendar. Используется системная переменная DateFormat DD/MM/YYYY.
 - 
                                    
Предшествующая загрузка, создающая дополнительное поле под именем month_name с использованием функции month() .
 - 
                                    
Первоначальная дата без форматирования под именем unformatted_date.
 - 
                                    
Дополнительное поле под именем long_date с использованием функции date() для выражения даты в полном формате.
 
Скрипт загрузки
SET DateFormat='DD/MM/YYYY'; 
Master_Calendar: 
Load 
      unformatted_date, 
      date(unformatted_date,'dd-MMMM-YYYY') as long_date, 
      month(unformatted_date) as month_name 
Inline
[ 
unformatted_date 
44868 
44898 
44928 
44958 
44988 
45018 
45048 
45078 
45008 
45038 
45068 
]; Результаты
Загрузите данные и откройте лист. Создайте новую таблицу и добавьте эти поля как измерения:
- 
                                    
unformatted_date
 - 
                                    
long_date
 - 
                                    
month_name
 
| 
                                             unformatted_date  | 
                                        
                                             long_date  | 
                                        
                                             month_name  | 
                                    
|---|---|---|
| 44868 | 03-January- 2022 | Jan | 
| 44898 | 03-February- 2022 | Feb | 
| 44928 | 03-March- 2022 | Mar | 
| 44958 | 03-April- 2022 | Apr | 
| 44988 | 03-May- 2022 | May | 
| 45018 | 03-June- 2022 | Jun | 
| 45048 | 03-July- 2022 | Jul | 
| 45078 | 03-August- 2022 | Aug | 
| 45008 | 03-September- 2022 | Sep | 
| 45038 | 03-October- 2022 | Oct | 
| 45068 | 03-November- 2022 | Nov | 
Имя месяца правильно вычисляется функцией month() в скрипте.
Пример 4. Расчет месяца окончания срока действия
Обзор
Откройте Редактор загрузки данных и добавьте приведенный ниже скрипт загрузки на новую вкладку.
Скрипт загрузки содержит следующее:
- 
                                    
Набор данных с заказами, размещенными в марте, под именем Subscriptions. Данная таблица содержит слишком много полей.
- 
                                            
id
 - 
                                            
order_date
 - 
                                            
amount
 
 - 
                                            
 
Скрипт загрузки
Subscriptions: 
Load 
	 id, 
	 order_date, 
	 amount 
Inline  
[ 
id,order_date,amount 
1,03/01/2022,231.24 
2,03/02/2022,567.28 
3,03/03/2022,364.28 
4,03/04/2022,575.76 
5,03/05/2022,638.68 
6,03/06/2022,785.38 
7,03/07/2022,967.46 
8,03/08/2022,287.67 
9,03/09/2022,764.45 
10,03/10/2022,875.43 
11,03/11/2022,957.35 
]; 
Результаты
Загрузите данные и откройте лист. Создайте новую таблицу и добавьте это поле как измерение: order_date.
Чтобы рассчитать месяц, когда истекает срок действия заказа, создайте эту меру: =month(order_date+180).
| order_date | =month(order_date+180) | 
|---|---|
| 03/01/2022 | Jul | 
| 03/02/2022 | Aug | 
| 03/03/2022 | Aug | 
| 03/04/2022 | Sep | 
| 03/05/2022 | Oct | 
| 03/06/2022 | Nov | 
| 03/07/2022 | Dec | 
| 03/08/2022 | Jan | 
| 03/09/2022 | Mar | 
| 03/10/2022 | Apr | 
| 03/11/2022 | May | 
Функция month() правильно определяет, что срок действия заказа, размещенного 11 марта, истекает в июле.