monthsname - スクリプトおよびチャート関数
この関数は、期間の月の範囲 (MonthNames スクリプト変数に従った書式で表示) および年を表す表示値を返します。基底値は、ベース日付を含む月、2 か月、四半期、4 か月、半年のいずれかの期間の最初のミリ秒のタイムスタンプに相当する値です。
構文:
MonthsName(n_months, date[, period_no[, first_month_of_year]])
戻り値データ型:デュアル
引数:
引数 | 説明 |
---|---|
n_months | 期間を定義する月数。整数、または計算結果が整数になる数式で次のうちのいずれかである必要があります: 1 (inmonth() 関数と同機能)、2 (2 か月)、3 (inquarter() 関数と同機能)、4 (4 か月)、6 (半年)。 |
date | 評価する日付。 |
period_no | 期間は、period_no、整数、計算結果が整数になる数式を使用して補正できます。値 0 は base_date を含む期間を示します。period_no の値が負の場合は過去の期間を、正の場合は将来の期間を示します。 |
first_month_of_year |
事業年度が 1 月以外の月に始まる場合は、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 か月単位の期間は次の年の最初の月に終了します。
例4:
ドキュメントに例のスクリプトを追加して実行します。その後、結果列に含まれている項目をドキュメントのシートに追加して結果を表示します。
この例では、テーブルの各請求書日付について、月の名前が 2 か月単位の期間の月の範囲と年に基づいて作成されます。範囲は、period_no に 4 を指定して、4x2 か月補正されています。
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() 関数の戻り値の列が含まれています。
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 |