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

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

この関数は、現在の日付を返します。この関数は、DateFormat システム変数形式の値を返します。

構文:  

today([ timer_mode])

戻り値データ型: dual

today() 関数は、ロード スクリプトまたはチャート オブジェクトのいずれかで使用できます。

既定の timer_mode 値は 1 です。

引数
引数 説明
timer_mode

以下の値を取ることができます。

0 (最後にデータ ロードが終了した日付)
1 (関数を呼び出した日付)
2 (アプリを開いた日付)

情報メモロード スクリプトでこの関数を使用する場合、timer_mode=0を指定すると最後にデータ ロードが終了した日付を取得でき、timer_mode=1を指定すると現在のデータ ロードの日付を取得できます。
関数の例
timer_mode value ロード スクリプトで使用された場合の結果 チャート オブジェクトで使用された場合の結果
0 DateFormat システム変数形式で、最新のデータ リロードの前に成功した前回のデータ リロードの日付を返します。 DateFormat システム変数形式で、最新のデータ リロードの日付を返します。

1

DateFormat システム変数形式で、最新のデータ リロードの日付を返します。 DateFormat システム変数形式で、関数呼び出しの日付を返します。

2

DateFormat システム変数形式で、アプリケーションでユーザーのセッションが開始されたときの日付を返します。これは、ユーザーがスクリプトをリロードしない限り構成されます。 DateFormat システム変数形式で、アプリケーションでユーザーのセッションが開始されたときの日付を返します。これは、新しいセッションが開始されたり、アプリケーションのデータがリロードされたりすると、更新されます。

使用に適しているケース

today() 関数は、数式内のコンポーネントとしてよく使用されます。たとえば、月の現在の日付までに累積した利息を計算するのに使用できます。

次のテーブルは、timer_mode 引数に異なる値を与えた場合に、today() 関数が返す結果についての説明を提供しています。

地域の設定

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

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

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

例 1 – ロード スクリプトを使用したオブジェクトの生成

例 2 – ロード スクリプトを使用しないオブジェクトの生成

例 3 – シナリオ

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

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