#時間デカルト軸

タイムスケールは時刻と日付を表示するために使用されます。データは、データ ポイント間の時間量に応じて分散されます。ティックを構築する際、スケールのサイズに基づいて最も快適な単位を自動的に計算します。

#日付アダプター

時間スケール必要日付ライブラリと対応するアダプターの両方が存在する必要があります。からお選びください利用可能なアダプター (新しいウィンドウが開きます)

#データセット

#入力データ

見るデータ構造

#日付形式

タイム スケールのデータを提供する場合、Chart.js は内部的にエポック (UTC 1970 年 1 月 1 日午前 0 時) からのミリ秒として定義されたタイムスタンプを使用します。ただし、Chart.js は、選択した日付アダプターが受け入れるすべての形式もサポートします。設定したい場合はタイムスタンプを使用する必要があります。parsing: falseより良いパフォーマンスのために。

#構成オプション

#時間軸固有のオプション

名前空間:options.scales[scaleId]

名前 タイプ デフォルト 説明
min number|string 表示する最低限の項目。もっと...
max number|string 表示する最大項目。もっと...
suggestedMin number|string 前にデータポイントがない場合に表示される最小項目。もっと...
suggestedMax number|string 背後にデータポイントがない場合に表示する最大項目。もっと...
adapters.date 45b5846d-53e8-4c86-89d2-621bbfae717f {} 外部日付ライブラリのアダプターのオプション (アダプターがオプションを必要とするかサポートする場合)
bounds string 'data' スケールの境界を決定します。もっと...
offsetAfterAutoskip boolean false true の場合、棒グラフのオフセットは自動スキップされた目盛りを使用して計算されます。
ticks.source string 'auto' ダニが生成される仕組み。もっと...
time.displayFormats object さまざまな時間単位をどのように表示するかを設定します。もっと...
time.isoWeekday boolean|number false もしもbooleantrue で単位が「週」に設定されている場合、週の最初の日は月曜日になります。そうでなければ日曜日になります。もしもnumber、週の最初の曜日のインデックス (0 - 日曜日、6 - 土曜日)
time.parser string|function 日付のカスタムパーサー。もっと...
time.round string false 定義されている場合、日付はこの単位の先頭に丸められます。見る時間単位許可される単位については以下を参照してください。
time.tooltipFormat string ツールチップに使用するフォーマット文字列。
time.unit string false 定義されている場合、ユニットは強制的に特定のタイプになります。見る時間単位詳細については、以下のセクションを参照してください。
time.minUnit string 'millisecond' 時間単位に使用される最小の表示形式。

#すべてのデカルト軸に共通のオプション

名前空間:options.scales[scaleId]

名前 タイプ デフォルト 説明
bounds string 'ticks' スケールの境界を決定します。もっと...
position string|object 軸の位置。もっと...
stack 4b08ca89-顔-4b1b-a99f-4d05c93eb70e スタックグループ。同じ軸position同じようにstack積み重ねられています。
stackWeight number 1 スタックグループ内のスケールの重量。グループ内のスケールに割り当てられたスペースの量を決定するために使用されます。
axis string これはどのタイプの軸ですか。可能な値は次のとおりです。'x''y'。設定されていない場合、これは ID の最初の文字から推測されます。'x'また'y'
offset boolean false true の場合、余分なスペースが両端に追加され、グラフ領域に収まるように軸が拡大縮小されます。これは次のように設定されていますtrueデフォルトで棒グラフの場合。
title object スケールタイトル構成。もっと...

#全軸共通オプション

名前空間:options.scales[scaleId]

名前 タイプ デフォルト 説明
type string 使用されているスケールの種類。カスタム スケールを作成し、文字列キーを使用して登録できます。これにより、グラフの軸のタイプを変更できます。
alignToPixels boolean false ピクセル値をデバイスのピクセルに合わせます。
backgroundColor Color スケール領域の背景色。
border object 境界線の構成。もっと...
display boolean|string true 軸のグローバル可視性を制御します (次の場合に表示されます)。true、いつ隠されるかfalse)。いつdisplay: 'auto'、軸は、少なくとも 1 つの関連データセットが表示されている場合にのみ表示されます。
grid object グリッドラインの構成。もっと...
min number ユーザー定義のスケールの最小値。データの最小値をオーバーライドします。もっと...
max number ユーザー定義のスケールの最大値。データの最大値をオーバーライドします。もっと...
reverse boolean false スケールを逆にします。
stacked boolean|string false データをスタックする必要があります。もっと...
suggestedMax number データの最大値を計算するときに使用される調整。もっと...
suggestedMin number 最小データ値を計算するときに使用される調整。もっと...
ticks object 設定にチェックマークを付けます。もっと...
weight number 0 軸のソートに使用される重み。重みが大きいほど、チャート領域から遠くなります。

#時間単位

次の時間測定がサポートされています。名前は文字列として渡すことができます。time.unit特定のユニットを強制するための設定オプション。

  • 'millisecond'
  • 'second'
  • 'minute'
  • 'hour'
  • 'day'
  • 'week'
  • 'month'
  • 'quarter'
  • 'year'

たとえば、常に月ごとの単位を表示する時間スケールを持つグラフを作成するには、次の構成を使用できます。

const chart = new Chart(ctx, {
    type: 'line',
    data: data,
    options: {
        scales: {
            x: {
                type: 'time',
                time: {
                    unit: 'month'
                }
            }
        }
    }
});

#表示形式

各単位のキーを使用して表示形式のマップを指定できます。

  • millisecond
  • second
  • minute
  • hour
  • day
  • week
  • month
  • quarter
  • year

値として使用される形式文字列は、使用することを選択した日付アダプターによって異なります。

たとえば、quarter月と年を表示するユニットを使用するには、次の構成をチャート コンストラクターに渡すことができます。

const chart = new Chart(ctx, {
    type: 'line',
    data: data,
    options: {
        scales: {
            x: {
                type: 'time',
                time: {
                    displayFormats: {
                        quarter: 'MMM YYYY'
                    }
                }
            }
        }
    }
});

#ティックソース

ticks.sourceプロパティはティックの生成を制御します。

  • 'auto': スケール サイズと時間オプションに基づいて「最適な」ティックを生成します
  • 'data': データからティックを生成します (データからのラベルを含む){x|y}オブジェクト)
  • 'labels': ユーザーが指定した値からティックを生成しますlabelsそれだけ

#パーサー

このプロパティが文字列として定義されている場合、日付アダプターが日付を解析するために使用するカスタム形式として解釈されます。

これが関数の場合、日付アダプターで処理できる型を返す必要があります。parse方法。

#最小最大構成

どちらにとっても、minmaxプロパティの場合、値は次のようにする必要がありますstringこれは、日付アダプターで解析できるもの、または UNIX エポックから経過したミリ秒数の数値です。 以下の例では、x 軸は 2021 年 11 月 7 日に始まります。

let chart = new Chart(ctx, {
    type: 'line',
    data: {
        datasets: [{
            data: [{
                x: '2021-11-06 23:39:30',
                y: 50
            }, {
                x: '2021-11-07 01:00:28',
                y: 60
            }, {
                x: '2021-11-07 09:00:28',
                y: 20
            }]
        }],
    },
    options: {
        scales: {
            x: {
                min: '2021-11-07 00:00:00',
            }
        }
    }
});

#スケール タイプをタイム スケールから対数/リニア スケールに変更します。

スケール タイプをタイム スケールから対数/線形スケールに変更する場合は、以下を追加する必要があります。bounds: 'ticks'スケールオプションに。変更するboundsパラメータのデフォルト値は'data'タイムスケールの場合。

初期設定:

const chart = new Chart(ctx, {
    type: 'line',
    data: data,
    options: {
        scales: {
            x: {
                type: 'time',
            }
        }
    }
});

スケールの更新:

chart.options.scales.x = {
    type: 'logarithmic',
    bounds: 'ticks'
};

#内部データ形式

内部的な時間スケールはエポックからのミリ秒を使用します

最終更新: 2023 年 4 月 28 日、午前 5 時 18 分 20 秒