メイン コンテンツをスキップする

yearend - スクリプトおよびチャート関数

この関数は、date を含む年の最終日の最後のミリ秒のタイムスタンプに相当する値を返します。デフォルトの出力形式は、スクリプトに設定されている DateFormat です。

構文:  

YearEnd( date[, period_no[, first_month_of_year = 1]])

つまり、yearend() 関数は、日付がどの年に該当するかを判断します。次に、その年の最後のミリ秒のタイムスタンプを日付形式で返します。年の最初の月は、既定では 1 月です。ただし、yearend() 関数で first_month_of_year 引数を使用して、どの月を最初に設定するかを変更することができます。

情報メモ yearend() 関数は FirstMonthOfYear システム変数を考慮しません。 first_month_of_year 引数を使用して変更しない限り、年は 1 月 1 日から始まります。

yearend() 関数の図。

yearend() 関数が、それが発生する日付と年度末を識別する方法を示す図。

yearend() 関数は、ユーザーがまだ発生していない年の端数を計算に使用する場合に、数式の一部として使用されます。たとえば、その年にまだ発生していない利息の合計を計算したい場合などに使います。

戻り値データ型: dual

引数
引数 説明
date 評価する日付。
period_no period_no は整数で、値 0 は date を含む年を示します。period_no の値が負の場合は過去の年を、正の場合は将来の年を示します。
first_month_of_year 事業年度が 1 月以外の月に始まる場合は、first_month_of_year で 2 から 12 の間の値を指定します。

次の値を使用して、first_month_of_year 引数に年の最初の月を設定できます。

first_month_of_year values
February 2
3 月 3
April 4
May 5
June 6
7 月 7
8 月 8
September 9
10 月 10
November 11
12 月 12

地域の設定

特に指定のない限り、このトピックの例では次の日付書式を使用しています: MM/DD/YYYY。日付書式は、データ ロード スクリプトの SET DateFormat ステートメントで指定されています。既定の日付書式は、地域の設定やその他の要因により、システムによって異なる場合があります。以下の例の書式は、要件に合わせて変更できます。または、これらの例に一致するようにロード スクリプトの書式を変更できます。詳しくは「アプリの地域設定の変更」を参照してください。

アプリの既定の地域設定は、ID プロバイダー設定、システム設定、またはブラウザー設定の組み合わせに基づいています。これらの地域の書式設定は、Qlik Cloud ユーザー インターフェースに表示される言語とは関係ありません。Qlik Cloud は使用しているブラウザと同じ言語で表示されます。

アプリの作成者は、作成するアプリの既定の地域を設定できます。詳細については、「アプリを作成するための優先地域設定の設定」を参照してください。

関数の例
結果
yearend('10/19/2001') Returns 12/31/2001 23:59:59.
yearend('10/19/2001', -1) Returns 12/31/2000 23:59:59.
yearend('10/19/2001', 0, 4) Returns 03/31/2002 23:59:59.

例 1 – 追加の引数なし

例 2 – period_no

例 3 – first_month_of_year

例 4 – チャート オブジェクトの例

例 5 – シナリオ