相対日付の利用方法

パラメータを使って最新の日付のデータにアクセスする方法

「日付入力」や「日付範囲」のパラメータにデフォルト値を設定することで、「今日」「昨日」「先週」などの相対日付をパラメータに簡単に設定することができるようになります。

相対日付を利用可能なパラメータ

パラメータの値をデフォルト値に変更するタイミングで、相対日付の計算が行われます。各機能ごとに、どのタイミングでパラメータの値がデフォルト値に変更されるかを以下に示します。

パラメータの入力フォームでユーザーが以下の操作を行った時
- フォーム全体に対してパラメータの値をデフォルト値にリセットを行った時
- パラメータ個別でデフォルト値にリセットを行った時

ノートブックのパラメータの変更は、他のユーザーとリアルタイムに共有されるため、デフォルト値への変更はユーザーの明示的な操作が必要となります。ノートブックを開いたタイミングで、相対日付の計算を行うことはできません。

パラメータの変更はできないため、相対日付の機能は利用できません。

以下の設定をすることで、レポートを開いたタイミングで、相対日付を適用できます
- レポートをパラメータ編集を許可の設定で公開
- レポート設定のオプションで自動実行を有効化
- レポート設定のオプションでパラメータのデフォルト値を使用を有効化
  - パラメータのデフォルト値を使用を有効化しない場合、パラメータの値はレポートの公開時点の値になります
パラメータの入力フォームでの操作は、ノートブックの場合と同様です

レポートのパラメータ変更は、他のユーザーとは共有されません。

以下の設定をすることで、署名付き埋め込みを開いたタイミングで、相対日付を適用できます
- パラメータをクライアントサイドパラメータに指定（サーバーサイドパラメータに指定しない）
- iframeの埋め込みのクライアントサイドパラメータで、パラメータのデフォルト値を初期値として利用を指定
  - 署名付き埋め込みの生成を行うスクリプトの変更が必要になります
  - パラメータのデフォルト値を初期値として利用を有効化しない場合、パラメータの値は署名付き埋め込みの公開時点の値になります
パラメータをサーバーサイドパラメータに指定している場合、相対日付の機能は利用できず、サーバーサイドで日付を指定する際に、別途相対日付の計算処理を行う必要があります。
パラメータの入力フォームでの操作は、ノートブックの場合と同様です
- ただし、入力フォームを非表示にしている場合、デフォルト値へのリセット処理の対象外となるため、相対日付の計算は行われません

署名付き埋め込みのパラメータ変更は、他のユーザーとは共有されません。

A: ブラウザの現在時刻を基準にして相対日付を計算します。タイムゾーンはブラウザでの設定に従うため、同じ時刻でもタイムゾーンが異なる場合は、計算される相対日付が異なる場合があります。

最終更新 1 か月前

役に立ちましたか？