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

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

この関数は、年 、週番号、曜日 から算出された日付を返します。

構文:  

MakeWeekDate(weekyear [, week [, weekday [, first_week_day [, broken_weeks [, reference_day]]]]])

戻り値データ型: dual

makeweekdate() 関数はスクリプトとチャート関数の両方として使用できます。関数は、関数に渡されたパラメータに基づいて日付を計算します。

引数
引数 説明
weekyear

特定の日付に対して WeekYear() 関数によって定義された年、つまり週番号が属する年です。

情報メモ前年の 12 月に第 1 週がすでに開始されている場合など、週の年が暦年と異なる場合があります。
week

特定の日付に対して Week() 関数によって定義された週番号です。

週番号が指定されていない場合は、1 として処理されます。

weekday

質問の日付に対して WeekDay() 関数によって定義された曜日です。0 は週の最初の日、6 は週の最後の日になります。

曜日が指定されていない場合は、0 として処理されます。

情報メモ0 は常に週の最初の日を意味し、6 は常に最後の日を意味しますが、対応する曜日は first_week_day パラメーターによって決定されます。省略されている場合は、変数 FirstWeekDay の値が使用されます。

分離した週が使用され、パラメーターを組み合わせることができない場合、選択した年に属さない結果になる可能性があります。

 

MakeWeekDate(2021,1,0,6,1)

この日は指定された週の最初の日 (日曜日) であるため、「2020 年 12 月 27 日」を返します。2021 年 1 月 1 日は金曜日でした。

first_week_day

週の開始日を指定します。省略されている場合は、変数 FirstWeekDay の値が使用されます。

first_week_day には、0 が月曜日、1 が火曜日、2 が水曜日、3 が木曜日、4 が金曜日、5 が土曜日、6 が日曜日の値を使用できます。

システム変数の詳細については、FirstWeekDay を参照してください。

broken_weeks

broken_weeks が指定されていない場合は、変数 BrokenWeeks の値を使用して、週が分離しているかどうかを定義します。

システム変数の詳細については、BrokenWeeks を参照してください

reference_day

reference_day が指定されていない場合は、変数 ReferenceDay の値を使用して、第 1 週を定義する参照日として設定する 1 月の日を定義します。

システム変数の詳細については、ReferenceDay を参照してください

使用に適しているケース

makeweekdate() 関数は、日付のリストを生成したり、入力データに年、週、曜日がある場合に日付を作成したりするために、データ生成用のスクリプトで一般的に使用されます。

次の例は下記の内容を推測します。

SET FirstWeekDay=0; SET BrokenWeeks=0; SET ReferenceDay=4;
関数の例
結果
makeweekdate(2014,6,6) の戻り値: 02/09/2014
makeweekdate(2014,6,1) の戻り値: 02/04/2014
makeweekdate(2014,6) 02/03/2014 を返します (曜日が 0 として処理されます)

地域の設定

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

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

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

例 1 – 日を含む

例 2 – 日を除外

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

例 4 – シナリオ

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

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