[日時] の [取得] アクション

[日時] パッケージの [取得] アクションは、指定された日時値から年、月、時、分、秒などの情報を取得し、結果を変数に格納します。

日時変数から値を取得するには、次の手順に従います。
  1. [アクション] パレットの [日時] パッケージから [取得] アクションをダブルクリックまたはドラッグします。
  2. [選択した値を取得する日時変数] フィールドから [日時] または [変数] タブを選択します。
    • 日時: ドロップダウンから日付、時刻、およびタイムゾーンの値を選択します。
    • 変数: 日時変数を選択します。
  3. [取得する日時値] フィールドで、次のオプションから選択して、指定した日時値を取得します。
    • 月の日付: 月の特定の日付を取得
    • 曜日: 曜日を取得
    • 年間通算日: 年間通算日を取得
    • 月の長さ: 1か月の日数
    • 年の長さ: 1 年の日数 (365 日またはうるう年で 366 日)
    • 時間: 時間を取得
    • 分: 分を取得
    • 月: 月を取得
    • 秒: 秒を取得
    • 年: 年を取得
  4. [変数に出力を代入] フィールドから、出力の代入先の数値変数を選択します。

オートメーションでの [取得] アクションの使用例

この例では、指定された日時値を日時変数から取得し、出力を変数に格納するオートメーションを作成します。

手順

  1. Bot を作成します。
    1. 左側のペインで [オートメーション] をクリックします。
      使用可能な Bots とフォームのリストが表示されます。
    2. [Bot を作成] をクリックします。
    3. Bot の名前として次を入力します。Datetime_Get。
    4. [作成と編集] をクリックします。
  2. [変数] メニュー上部の [変数を作成] (+) アイコンを使用して、以下のユーザー定義変数を作成します。
    変数名 変数型 値
    invoiceDate 日時 値 4/12/2023 10:45 AM GMT (UTC+0:00) GMT
    結果 数字 0
  3. [アクション] パレットの [日時] パッケージから [取得] アクションをダブルクリックまたはドラッグします。
  4. [選択した値を取得する日時変数] フィールドで、invoiceDate 変数を選択します。
  5. [取得する日時値] フィールドから [月の日付] オプションを選択します。
  6. [出力を変数に代入] フィールドで、result を選択します。
  7. 値を表示するには、[メッセージ ボックス] アクションをダブルクリックまたはドラッグします。[表示するメッセージを入力] フィールドに、「DAYOFMONTH: $result.Number:toString$」と入力します。

    出力値を表示するには、数値変数を文字列変数に変換します。

  8. [保存]、[実行] をクリックします。
    出力は次のように表示されます。

    月の特定の日付を取得

  9. [メッセージ ボックス] アクションをダブルクリックまたはドラッグします。[表示するメッセージを入力] フィールドに、次の式を入力します。
    注: [表示するメッセージを入力] フィールドに式を入力する場合は、Get("") 式パラメーターを大文字で入力してください。
    

DAYOFYEAR: $invoiceDate.Datetime:get("DAYOFYEAR").Number:toString$
DAYOFWEEK: $invoiceDate.Datetime:get("DAYOFWEEK").Number:toString$

DAYOFMONTH: $invoiceDate.Datetime:get("DAYOFMONTH").Number:toString$
MONTH: $invoiceDate.Datetime:get("MONTH").Number:toString$
YEAR: $invoiceDate.Datetime:get("YEAR").Number:toString$

HOUR: $invoiceDate.Datetime:get("HOUR").Number:toString$
MINUTE: $invoiceDate.Datetime:get("MINUTE").Number:toString$

LENGTHOFMONTH: $invoiceDate.Datetime:get("LENGTHOFMONTH").Number:toString$
LENGTHOFYEAR: $invoiceDate.Datetime:get("LENGTHOFYEAR").Number:toString$
  10. [保存]、[実行] をクリックします。
    出力は次のように表示されます。

    メッセージボックスに出力された日時を取得します。