Appearance
相対日付
日付入力や日付範囲のデフォルト値に、相対日付を設定できます。「今日」「昨日」「先週」など、基準日からのオフセットで値を定義します。
オフセットの単位は、パラメータ設定の 単位(日 / 週 / 月 / 年)に従います。例えば 単位 が 日 のときオフセット 0 は今日、-1 は昨日です。単位 が 週 のときオフセット 0 は今週、-1 は先週です。
相対日付は、値の展開とデフォルト値のとおり、リセット時に具体的な日付へ計算されて現在値へ書き込まれます。実行のたびに自動再計算されるわけではありません。
設定方法
- パラメータの入力フォーム右上のメニューを開きます
- デフォルト値 で 相対日付 または 相対日付範囲 を選ぶ
- オフセット(日付範囲では 下限オフセット / 上限オフセット)を指定します
相対日付が計算されるタイミング
パラメータ値をデフォルト値へ戻すタイミングで、相対日付が計算されます。機能ごとの適用タイミングは次のとおりです。
ノートブック
次の操作をしたときに適用されます。
- フォーム全体の パラメータの値をデフォルト値にリセット
- パラメータ個別の デフォルト値にリセット
TIP
ノートブックでは、パラメータ変更を他のユーザーとリアルタイム共有します。デフォルト値へ戻すには明示的な操作が必要です。ノートブックを開いただけでは、相対日付を再計算しません。
パブリックリンク
パラメータを変更できないため、相対日付は利用できません。詳細はパブリックリンクを参照してください。
レポート
次の公開設定にすると、レポートを開いたときに相対日付を適用できます。
- レポートタイプで インタラクティブレポート を選ぶ
- 自動実行を有効化 し、あわせて パラメータのデフォルト値を使用 を有効にします
パラメータのデフォルト値を使用 を無効にした場合、パラメータ値はレポート公開時点の値になります。入力フォームでのリセット操作は、ノートブックと同様です。
TIP
レポートのパラメータ変更は、他のユーザーとは共有されません。
詳細はレポートを参照してください。
署名付き埋め込み
次の条件で、署名付き埋め込みを開いたときに相対日付を適用できます。
- パラメータをクライアントサイドパラメータに指定する(サーバーサイドパラメータにしない)
- クライアントサイドパラメータで、パラメータのデフォルト値を初期値として利用する設定にします
この設定を無効にした場合、パラメータ値は公開時点の値になります。サーバーサイドパラメータでは相対日付は利用できません。サーバー側で日付を指定する場合は、別途相対日付の計算が必要です。
入力フォームでのリセット操作はノートブックと同様です。ただし、入力フォームを非表示にしているパラメータはリセット対象外のため、相対日付は再計算されません。
TIP
署名付き埋め込みのパラメータ変更は、他のユーザーとは共有されません。
詳細は署名付き埋め込みを参照してください。
計算基準の日時
相対日付は、ブラウザの現在時刻を基準に計算します。タイムゾーンはブラウザ設定に従うため、同じ瞬間でもタイムゾーン違いにより結果の日付は変わることがあります。