変数

set

変数にリテラル値をセットします。

- set:
    name: greeting
    value: "Hello!"

- set:
    name: count
    value: 0

ある変数の値を別の変数にコピーします。

- copy_var:
    from: source_var
    to: destination_var

現在の日時をフォーマットされた文字列として取得します。

- get_datetime:
    format: "%Y%m%d"      # → "20241215"
    save_as: today

- get_datetime:
    format: "%Y-%m-%d %H:%M:%S"
    save_as: timestamp

フォーマットは chrono strftime に従います。

現在の OS ユーザー名を取得します。

- get_username:
    save_as: user

算術式を評価します。

- calc:
    expr: "price * quantity"
    save_as: total

- calc:
    expr: "index + 1"
    save_as: next_index

数値変数を 1 (またはカスタムステップ値) だけインクリメントします。

- increment:
    name: counter

- increment:
    name: counter
    by: 5

全角文字と半角文字を相互変換します (日本語テキストの処理)。

- to_fullwidth:
    value: "{{ text }}"
    save_as: full

- to_halfwidth:
    value: "{{ text }}"
    save_as: half

CSV または Excel ファイルの行を変数として読み込みます。

- import_vars:
    file: data.xlsx
    sheet: Sheet1         # 省略可、デフォルト: 最初のシート
    row: 0                # 0 始まりの行インデックス

各列の値は __rows__ にリストとして格納されます。最初の行がヘッダーの場合は名前付き変数としても格納されます。

変数を JSON ファイルに保存または復元します。

- save_vars:
    file: state.json

- load_vars:
    file: state.json