メイン コンテンツをスキップする 補完的コンテンツへスキップ

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

この関数は、date を含む年の初日の最初のミリ秒のタイムスタンプに対応する数値を基底として、4 桁の年の表示値を返します。

yearname() 関数の時間範囲の図。

yearname 関数が結果を返す時間の範囲を示す図。

yearname() 関数は、評価する日付をオフセットし、年の最初の月を設定できるという点で、 year() 関数とは異なります。

年の最初の月が 1 月でない場合、この関数は、その日付を含む 12 か月期間を表す 2 つの 4 桁の年を返します。たとえば、年度の始まりが 4 月で、評価される日付が 06/30/2020 の場合、返される結果は 2020-2021になります。

4 月が年の最初の月に設定された yearname() 関数の図。

yearname 関数が 12 か月間内の日付を識別できること、およびその返された値が年の最初の月として設定されている月によって異なることを示す図。

構文:  

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

戻り値データ型: dual

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

次の値を使用して、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

yearname() 関数は、集計を年ごとに比較するのに役立ちます。たとえば、製品の総売上高を年ごとに表示する場合などが考えられます。

これらのは、関数を使用してマスター カレンダー テーブルに項目を作成することにより、ロード スクリプトで作成できます。また、計算軸としてチャートで作成することもできます

地域の設定

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

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

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

関数の例
結果
yearname('10/19/2001') 「2001」を返します。
yearname('10/19/2001',-1) 「2000」を返します。
yearname('10/19/2001',0,4) 「2001-2002」を返します。
関連トピック
トピック 説明
year - スクリプトおよびチャート関数 この関数は、expression が標準的な数値の解釈に従って日付と判断される場合に、年を表す整数を返します。

例 1 – 追加の引数なし

例 2 – period_no

例 3 – first_month_of_year

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

例 5 – シナリオ

このページは役に立ちましたか?

このページまたはコンテンツに、タイポ、ステップの省略、技術的エラーなどの問題が見つかった場合は、お知らせください。改善に役立たせていただきます。