時間足と取引カレンダー
1 分足を渡せば、チャートは 5 分足、4 時間足、日足、週足などをブラウザ上で合成できます。時間足を切り替えるたびにサーバーへデータを要求する必要はありません。どう合成するかは取引カレンダーに従います。1 日が何時に始まるか、どんな取引セッションがあるか、どの曜日に取引するか、です。
時間足の書き方
数字と単位で書きます。
| 単位 | 意味 | 例 |
|---|---|---|
s |
秒 | '15s' |
m |
分 | '1m'、'5m' |
h |
時間 | '1h'、'4h' |
D |
日 | '1D' |
W |
週 | '1W' |
M |
月 | '1M'、'3M' |
大文字と小文字を区別するのは分の m と月の M だけで、それ以外はどちらで書いてもかまいません('4H'、'1d')。数字が 1 なら省略でき、'D' は '1D' と同じです。{ unit: 'hour', count: 4 } のようにオブジェクトで書くこともできます。
時間足を切り替える
コードを表示コードを隠す
import { createChart } from '@kumo-charts/core';
import { loadBars } from '@docs/data';
const chart = createChart(document.getElementById('chart')!);
chart.data.set(await loadBars(), { interval: '1m' });
chart.data.setTimeframe('4h');set() で渡した interval が元の時間足で、setTimeframe() で設定するのが表示する時間足です。setTimeframe(null) で元の時間足に戻ります。
chart.data.sourceInterval(); // { unit: 'minute', count: 1 }
chart.data.timeframe(); // { unit: 'hour', count: 4 }。元の時間足のときは null合成された足は、時間がその時間足の開始時刻、始値が最初の足の始値、高値と安値がすべての足の中の最高値と最安値、終値が最後の足の終値、出来高がその合計になります。最新の足はリアルタイムデータに合わせて更新されます。
数日で 1 本の時間足('2D' など)は取引日で数えます。1 本はちょうどその数の連続した取引日(カレンダーの weekdays)で、取引のない日は数えず、時間はそのうち最初の取引日です。1970 年 1 月 1 日から順に区切るので、同じカレンダーならいつも同じ区切りになります。
インジケーターもチャートより長い時間足で計算できます。たとえば 5 分足のチャートに 1 時間足の移動平均線を表示できます。インジケーターを参照してください。
合成できる時間足
- 秒・分・時間:元の時間足の整数倍である必要があります。たとえば 1 分足からは 3 分足や 1 時間足を合成できますが、90 秒足は合成できません。
- 日:元の時間足で 1 日を割り切れる必要があります。たとえば元の時間足が 1 分、15 分、4 時間ならどれも合成できますが、7 分では合成できません。
- 週・月:1 日を割り切れる時間足か、1 日足から合成します。2 日足からは合成できません。
- 元の時間足より短い時間足は作れません。
合成できない時間足を指定すると、setTimeframe() はエラーになり、その理由を示します。時間足のメニューを作るときは、先に canBuildTimeframe() でどれを選べるかを判定できます。
import { canBuildTimeframe } from '@kumo-charts/core';
canBuildTimeframe('4h', '1h'); // true
canBuildTimeframe('1W', '2D'); // false秒・分・時間の周期は長さが決まっていて、intervalDuration() がそのミリ秒数を返します。日・週・月の長さは取引カレンダーで決まるため、null を返します。
import { intervalDuration } from '@kumo-charts/core';
intervalDuration('15m'); // 900000
intervalDuration('1D'); // nullタイムゾーン
タイムゾーンの設定は 2 つあります。
timeZone:軸とクロスヘアの時間を、どのタイムゾーンで表示するか。設定しなければユーザーのパソコンのローカルタイムゾーンです。calendar.timeZone:足の日足や週足をどのタイムゾーンで区切るか、また時間単位の足が何時から始まるか。デフォルトはUTCです。
暗号資産取引所の足は UTC で区切られ、日足は UTC 0 時に始まるので、デフォルトのままで合います。表示される時間はユーザーのローカル時間のままです。株式や先物など、取引所の時間で足を渡す場合は、取引所のタイムゾーンを設定します。
createChart(container, {
timeZone: 'Asia/Shanghai', // 時間を北京時間で表示
calendar: { timeZone: 'America/New_York' } // 米国株:日足はニューヨークの 0 時から
});カレンダーはデータと合っている必要があります。分足と時間足は、カレンダーの足の始まりに時間がなければなりません。たとえば UTC の正時に始まる時間足を、30 分ずれたインド時間のカレンダーに渡すと、set() はエラーを出してどう設定すればよいかを伝えます。足を黙って別の時間に動かすことはしません。日足・週足・月足は取引日で決まるので、時間がその日の 0 時でも、始値や終値の時刻でもかまいません。
タイムゾーンは IANA の名前で指定します。たとえば Asia/Shanghai、America/New_York、UTC です。
取引セッション
24 時間取引の市場では設定は不要です。取引時間が決まっている市場では、calendar に書いておきます。
| オプション | 意味 | デフォルト |
|---|---|---|
sessions |
1 日の中の取引セッション。'HH:MM-HH:MM' で書き、終了が開始より早いときは午前 0 時をまたぐことを表す。セッション外の時間は捨てられる |
[](終日) |
dayStart |
取引日が何時に始まるか。この時刻以降は翌取引日として扱う | '00:00' |
weekdays |
どの曜日が取引日か。0 は日曜日 | 毎日 |
weekStart |
週足が何曜日から始まるか。0 は日曜日 | 1(月曜日) |
いくつかの例です。
// 中国 A 株:午前と午後の 2 つのセッション、月曜から金曜まで
createChart(container, {
calendar: {
timeZone: 'Asia/Shanghai',
sessions: ['09:30-11:30', '13:00-15:00'],
weekdays: [1, 2, 3, 4, 5]
}
});
// 夜間取引のある中国の先物:21 時に始まる夜間取引は翌取引日に含め、金曜の夜間取引は月曜の取引日に含める
createChart(container, {
calendar: {
timeZone: 'Asia/Shanghai',
sessions: ['21:00-02:30', '09:00-10:15', '10:30-11:30', '13:30-15:00'],
dayStart: '21:00',
weekdays: [1, 2, 3, 4, 5]
}
});
// FX:ニューヨーク時間の午後 5 時に日付が変わる
createChart(container, {
calendar: {
timeZone: 'America/New_York',
dayStart: '17:00',
weekdays: [1, 2, 3, 4, 5]
}
});取引セッションがあるときは、時間単位の足は各セッションの開始から数えます。たとえば A 株の 1 時間足は 9:30、10:30、13:00、14:00 に始まります。
祝日と特別なルール
決まったルールでは表せないもの、たとえば祝日の休場や特定の日の短縮取引は、calendar.bucket を使って、各時刻がどの足に属するかを自分で決めます。
const holidays = new Set(['2026-10-01', '2026-10-02']);
createChart(container, {
calendar: {
timeZone: 'Asia/Shanghai',
sessions: ['09:30-11:30', '13:00-15:00'],
bucket: (time, interval, fallback) => {
const date = new Date(time + 8 * 3_600_000).toISOString().slice(0, 10);
return holidays.has(date) ? null : fallback(time);
}
}
});その足の開始時刻を返します。null を返すと、その時刻は捨てられます。fallback は、ほかのカレンダー設定に従って計算した結果です。時刻が進むにつれて、返す時刻が過去に戻ってはいけません。
このカレンダーを自分で使う
自分のコードでチャートと同じルールで時間をそろえたいとき、たとえばサーバーでローソク足を合成したり、ある時刻がどの足に属するかを判定したりするときは、createCalendar() を使います。
import { createCalendar } from '@kumo-charts/core';
const calendar = createCalendar({
timeZone: 'Asia/Shanghai',
sessions: ['09:30-11:30', '13:00-15:00']
});
calendar.bucket('2026-05-06T02:15:00Z', '1h'); // 北京時間 10:15 は 9:30 に始まる足に属するので、9:30 のタイムスタンプを返すチャートがなくても使え、Node.js でも動きます。
チャートがあるときは、chart.data.calendar() がチャートの使っているカレンダー(calendar オプションにチャートのタイムゾーンを加えたもの)です。たとえばプラグインで足を取引日ごとにまとめるときに使います。オプションを変えると新しいものに替わるので、使うときに取得してください。