# monthsname - 脚本和图表函数

此函数用于返回一个显示值，表示时段各月份（根据 MonthNames 脚本变量的格式）和年的范围。基础数值与包含基准日期的一个月、两个月、季度、四个月或半年的第一毫秒的时间戳对应。

语法：

MonthsName(n\_months, date[, period\_no[, first\_month\_of\_year]])

**返回数据类型：**双

参数：

MonthsName 参数

| 参数 | 说明 |
| --- | --- |
| n\_months | 用于定义时段的月数。整数或解算为整数的表达式必须为下列之一：1（相当于 inmonth() 函数）、2（两个月）、3（相当于 inquarter() 函数）、4（四个月）或 6（半年）。 |
| date | 要求值的日期。 |
| period\_no | 该周期可通过 period\_no 偏移，其为整数，或解算为整数的表达式，其中值 0 表示该周期包含 base\_date。period\_no 为负数表示前几个时段，为正数则表示随后的几个时段。 |
| first\_month\_of\_year | 如果您不想从一月开始处理（财政）年，可在 first\_month\_of\_year 中指定一个介于 2 和 12 之间的值。 |

示例和结果：

以下示例使用日期格式 DD/MM/YYYY。日期格式已经在加载脚本顶部的 SET DateFormat 语句中指定。可以根据要求更改示例中的格式。

示例 1:

`monthsname(4, '19/10/2013')`

返回 Sep-Dec 2013。   
因为在此例和其他示例中，已将 SET Monthnames 语句设置为 Jan;Feb;Mar，以此类推。

示例 2:

`monthsname(4, '19/10/2013', -1)`

返回 May-Aug 2013。

示例 3:

`monthsname(4, '19/10/2013', 0, 2)`

返回 Oct-Jan 2014。   
因为已将该年度指定为从 2 月开始，因此四个月周期在下一年度的第一个月结束。

示例 4:

将示例脚本添加到文档并运行。然后，至少要将结果列中列出的字段添加到文档中的表格才能查看结果。

在此例中，对于表格中的每个发票日期，根据从该年度的两个月周期中的月份范围创建月份名称。范围为 4x2 个月的偏移（通过将 period\_no 指定为 4）。

`TempTable:` `LOAD RecNo() as InvID, * Inline [` `InvDate` `28/03/2012` `10/12/2012` `5/2/2013` `31/3/2013` `19/5/2013` `15/9/2013` `11/12/2013` `2/3/2014` `14/5/2014` `13/6/2014` `7/7/2014` `4/8/2014` `];` ` ` `InvoiceData:` `LOAD *,` `MonthsName(2, InvDate, 4) AS MthsName` `Resident TempTable;`

`Drop table TempTable;`

结果列表包含原始日期和包括 monthsname() 函数的返回值的列。

示例 4 结果

| InvDate | MthsName |
| --- | --- |
| 28/03/2012 | Nov-Dec 2012 |
| 10/12/2012 | Jul-Aug 2013 |
| 5/2/2013 | Sep-Oct 2013 |
| 31/3/2013 | Nov-Dec2013 |
| 19/5/2013 | Jan-Feb 2014 |
| 15/9/2013 | May-Jun 2014 |
| 11/12/2013 | Jul-Aug 2014 |
| 2/3/2014 | Nov-Dec 2014 |
| 14/5/2014 | Jan-Feb 2015 |
| 13/6/2014 | Jan-Feb 2015 |
| 7/7/2014 | Mar-Apr 2015 |
| 4/8/2014 | Mar-Apr 2015 |