翻訳は機械翻訳により提供されています。提供された翻訳内容と英語版の間で齟齬、不一致または矛盾がある場合、英語版が優先します。

# 期間累計計算
<a name="period-to-date-function"></a>

期間累計計算では、指定された期間の現在までの値が評価されます。たとえば、計算を作成して、年初来の売上を確認することができます。

この関数を使用するには、[**Time (時間)**] フィールドウェルに 1 つ以上のディメンションが必要です。

## パラメータ
<a name="period-to-date-function-parameters"></a>

*[名前]*   
割り当てたり変更したりする固有のわかりやすい名前。独自の名前を作成しない場合、名前が割り当てられます。これは後で編集できます。

*日付*   
ランク付けする日付ディメンション。

*値*   
計算の基になっている集計指標。

*時間詳細度*   
計算に使用する日付の細かさ。たとえば、年初来。

## 計算の出力
<a name="period-to-date-computation-outputs"></a>

各関数が出力パラメータのセットを生成します。これらの出力を自動説明文に追加して、表示内容をカスタマイズできます。独自のカスタムテキストを追加することもできます。

出力パラメータを見つけるには、右側の [**Computations (計算)**] タブを開き、使用する計算を探します。計算名は、インサイトを作成するときに指定した名前に基づいて決定されます。1 回のみ出力パラメータをクリックして選択します。2 回クリックすると、同じ出力が 2 回追加されます。**太字**で表示された項目は、説明で使用できます。
+ `timeField` – [**Time (時間)**] フィールドウェルから。
  + `name` – フィールドのフォーマットされた表示名。
  + `timeGranularity` – 時間フィールドの詳細度 (**DAY**、**YEAR** など)。
+ `metricField` – [**Values (値)**] フィールドウェルから。
  + `name` – フィールドのフォーマットされた表示名。
  + `aggregationFunction` – メトリクスに使用された集計 (**SUM**、**AVG** など)。
+ `previousMetricValue` – メトリクスディメンションの以前の値。
  + `value` – 未加工値。
  + `formattedValue` – メトリクスフィールドによってフォーマットされた値。
  + `formattedAbsoluteValue` – メトリクスフィールドによってフォーマットされた絶対値。
+ `previousTimeValue` – 日時ディメンションの以前の値。
  + `value` – 未加工値。
  + `formattedValue` – 日時フィールドでフォーマットされた値。
+ `currentMetricValue` – メトリクスディメンションの現在の値。
  + `value` – 未加工値。
  + `formattedValue` – メトリクスフィールドによってフォーマットされた値。
  + `formattedAbsoluteValue` – メトリクスフィールドによってフォーマットされた絶対値。
+ `currentTimeValue` – 日時ディメンションの現在の値。
  + `value` – 未加工値。
  + `formattedValue` – 日時フィールドでフォーマットされた値。
+ `periodGranularity` – このコンピューティング期間の詳細度 (**MONTH**、**YEAR** など)。
+ `percentDifference` – メトリクスフィールドの現在の値と以前の値のパーセント差。
  + `value` – パーセント差の計算の未加工値。
  + `formattedValue` – パーセント差のフォーマットされた値 (例: -42%)。
  + `formattedAbsoluteValue` – パーセント差のフォーマットされた絶対値 (例: 42%)。
+ `absoluteDifference` – メトリクスフィールドの現在の値と以前の値の絶対差。
  + `value` – 絶対差の計算の 未加工値。
  + `formattedValue` – メトリクスフィールドのフォーマット設定によってフォーマットされた絶対差。
  + `formattedAbsoluteValue` – メトリクスフィールドによってフォーマットされた差の絶対値。

## 例
<a name="period-to-date-computation-example"></a>

**現在までの期間の計算を作成するには**

1. 変更する分析で、[**インサイトの追加**] を選択します。

1. [**計算タイプ**] で、[**現在までの期間の計算**]、[**選択**] の順に選択します。

1. 作成した新しいインサイトに、比較する時間ディメンションフィールドと値ディメンションフィールドを追加します。下のスクリーンショットでは、`Order Date` と `Sales (Sum)`がインサイトに追加されています。これら 2 つのフィールドを選択すると、Quick Sight は過去 1 か月の年初来の売上と、前月との差の割合を表示します。  
![\[alt text not found\]](http://docs.aws.amazon.com/ja_jp/quick/latest/userguide/images/periodOverPeriod1.png)

1. (オプション) インサイトをさらにカスタマイズするには、オンビジュアルメニューを開いて [**説明文のカスタマイズ**] を選択します。表示される [**説明文の編集**] ウィンドウで、必要なフィールドを [**計算**] リストからドラッグアンドドロップし、[**保存**] を選択します。