カスタマイズ

特定の日付を取得する

概要

特定の日付を取得して他のアクションから参照できるようにします。

使い方

取得した日付をフィールドに入れたい場合、「セット先フィールド(省略可)」パラメーターにそのフィールドを選択します。

取得した日付をすぐフィールドに入れるのではなく、他のアクションで使いたい場合は数式を利用します。

「特定の日付を取得する」をセットしたアクションを実行すると、アクションの結果としてその日付が内部に保存されます。

保存された日付は、数式を使用して、「=$1」などで取得できます。

保存された日付は、kintone の日付フィールドにそのままセットできる形式になっています。

例)取得した日付を、他のアクション(「レコードを追加する」)で使用する例

  1. 「特定の日付を取得する」を設置します。アクション番号が1番だったとします。
  2. レコードを追加する」の「マッピング」で、セットしたい日付フィールドに対して「=$1」と入れます。 (「特定の日付を取得する」のアクション番号が2番だったら、「=$2」とします)

「今月」「来月」などの指定は、すべてアクション実行時の日付が基準になります。任意の日付を基準にしたい場合は、「基準日から特定の日付を取得する」を使用することができます。

設定するパラメーター

「日付の種類」を設定します。

日付の種類

「今日」や「今月月初」など、取得したい日付を選択します。

以下から選択することができます。

  • 今日
  • 昨日
  • 明日
  • 今月月初
  • 今月末日
  • 先月月初
  • 先月末日
  • 来月月初
  • 来月末日
  • 本年年初(1月1日)
  • 本年年末(12月31日)
  • 昨年年初(1月1日)
  • 昨年年末(12月31日)
  • 来年年初(1月1日)
  • 来年年末(12月31日)
  • 本年度初日(4月1日)
  • 本年度末日(3月31日)
  • 昨年度初日(4月1日)
  • 昨年度末日(3月31日)
  • 来年度初日(4月1日)
  • 来年度末日(3月31日)

他の方法

アクションを使用せずに、式でgetdate関数を使って取得する方法もあります。

フィールドに値をセットする」の「値」パラメーターなどで

=getDate("今月月初")

のように、関数を指定することができます。

セット先フィールド(省略可)

取得した日付を他のフィールドにセットする場合に指定します。直接フィールドにはセットせず、結果を別のアクションで使用したい場合は、省略できます。

テーブル内のフィールドを指定した場合、特別な場合(*1)を除き、テーブル内のすべての行にセットされます。

(*1) 条件側で、「フィールドの値を編集して値が変わった時」のように、テーブル行を限定するように条件が入っている場合は、対象の行にだけセットされます。

選択可能なフィールドタイプは以下の通りです。

  • 文字列(1行)
  • 文字列(複数行)
  • リッチエディター
  • 日付
  • 日時

krewSheet 対応状況

対応しています。

ただし、「セット先フィールド(省略可)」に以下の制限があります。

  • ルックアップでコピーされるフィールドにはセットできません。
  • 以下のフィールドは「レコードを保存する直前(削除時は除く)」のようにレコード保存のタイミングのみでセット可能です。やや専門的になりますが、より詳しく知りたい方は krewSheet のドキュメント も参考にしてください。
    • krewSheet の表示列に含まれていないフィールド
    • krewSheet で読み取り専用に設定されているフィールド
    • リッチエディターフィールド

制限事項

  • 基準となる今日の日付は、kintone にログインしたユーザーのプロフィール設定で、「タイムゾーン」に設定されたタイムゾーン(時差)に基づきます。 特定のタイムゾーン(例えば日本時間)に固定することはできません。

  • この「やること」においては「年度」の範囲は4月~3月で固定です。異なる年度範囲で年度開始日等を取得することはできません。

関連記事