Skip to content

相対日付

日付入力日付範囲のデフォルト値に、相対日付を設定できます。「今日」「昨日」「先週」など、基準日からのオフセットで値を定義します。

オフセットの単位は、パラメータ設定の 単位(日 / 週 / 月 / 年)に従います。例えば 単位 のときオフセット 0 は今日、-1 は昨日です。単位 のときオフセット 0 は今週、-1 は先週です。

相対日付は、値の展開とデフォルト値のとおり、リセット時に具体的な日付へ計算されて現在値へ書き込まれます。実行のたびに自動再計算されるわけではありません。

設定方法

  1. パラメータの入力フォーム右上のメニューを開きます
  2. デフォルト値相対日付 または 相対日付範囲 を選ぶ
  3. オフセット(日付範囲では 下限オフセット / 上限オフセット)を指定します

相対日付が計算されるタイミング

パラメータ値をデフォルト値へ戻すタイミングで、相対日付が計算されます。機能ごとの適用タイミングは次のとおりです。

ノートブック

次の操作をしたときに適用されます。

  • フォーム全体の パラメータの値をデフォルト値にリセット
  • パラメータ個別の デフォルト値にリセット

TIP

ノートブックでは、パラメータ変更を他のユーザーとリアルタイム共有します。デフォルト値へ戻すには明示的な操作が必要です。ノートブックを開いただけでは、相対日付を再計算しません。

パブリックリンク

パラメータを変更できないため、相対日付は利用できません。詳細はパブリックリンクを参照してください。

レポート

次の公開設定にすると、レポートを開いたときに相対日付を適用できます。

  • レポートタイプで インタラクティブレポート を選ぶ
  • 自動実行を有効化 し、あわせて パラメータのデフォルト値を使用 を有効にします

パラメータのデフォルト値を使用 を無効にした場合、パラメータ値はレポート公開時点の値になります。入力フォームでのリセット操作は、ノートブックと同様です。

TIP

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

詳細はレポートを参照してください。

署名付き埋め込み

次の条件で、署名付き埋め込みを開いたときに相対日付を適用できます。

  • パラメータをクライアントサイドパラメータに指定する(サーバーサイドパラメータにしない)
  • クライアントサイドパラメータで、パラメータのデフォルト値を初期値として利用する設定にします

この設定を無効にした場合、パラメータ値は公開時点の値になります。サーバーサイドパラメータでは相対日付は利用できません。サーバー側で日付を指定する場合は、別途相対日付の計算が必要です。

入力フォームでのリセット操作はノートブックと同様です。ただし、入力フォームを非表示にしているパラメータはリセット対象外のため、相対日付は再計算されません。

TIP

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

詳細は署名付き埋め込みを参照してください。

計算基準の日時

相対日付は、ブラウザの現在時刻を基準に計算します。タイムゾーンはブラウザ設定に従うため、同じ瞬間でもタイムゾーン違いにより結果の日付は変わることがあります。