すべてのプロダクト
Search
ドキュメントセンター

Resource Orchestration Service:Fn::Calculate

最終更新日:Jan 16, 2025

組み込み関数 Fn::Calculate は、String 型の式の計算結果を返します。

宣言

  • JSON

    {
      "Fn::Calculate": [
        "expression",
        ndigits,
        [
          <number1>,
          <number2>,
          ...
        ]
      ]
    }
  • YAML

    • 完全な関数名の構文:

      Fn::Calculate:
        - expression
        - ndigits
        - - <number1>
          - <number2>
          - ...
    • 短縮形の構文:

      !Calculate 
      	- expression
        - ndigits
        - - <number1>
          - <number2>
          - ...

パラメーター

  • expression: このパラメーターは、String 型の式を指定します。

  • ndigits: このパラメーターは、表示する小数点以下の桁数を指定します。このパラメーター値は 0 または正の整数である必要があります。このパラメーターは、式に浮動小数点数が含まれている場合にのみ有効になります。

  • [<number0>, <number1>, <number2>, ... ]: オプション。式で {n} を定義できます。 n は数値のインデックスを指定します。式が計算されるとき、{n} は数値に置き換えられます。

戻り値

式の計算結果。戻り値は Number 型です。

!Calculate
  - (2+3)/2*3-1
  - 1
!Calculate
  - (2.0+3)/2*3-1
  - 1
!Calculate
  - ({1}+3)/2*3-1
  - 1
  - - 3
    - 5
    - 6
!Calculate
  - ({0}+{1})%3
  - 0
  - - 5
    - 6

この例では、次の結果が返されます。

5 
6.5
11
2
説明

整数の商には小数点以下の桁数は保持されません。たとえば、5/2 = 2 です。したがって、Fn::Calculate:(2+3)/2*3-1, 1 の戻り値は 5 です。