Time scale

Time scale (or time axis) is a horizontal scale at the bottom of the chart that displays the time of bars.

Time scale API

You can manage the time scale using the Time scale API. For example, you can set a specific right margin or detect when the chart has been zoomed in/out. Refer to ITimeScaleApi for more information.

Date and time formatting

You can adjust the display format of date and time values using the custom_formatters property of the Widget Constructor. Check out the Widget Constructor tutorial on YouTube for an implementation example.

Time frame toolbar

Time frames are time period buttons displayed at the bottom-left corner of the chart. When users switch a time frame, it causes the following changes to satisfy the selected time frame:

1. The chart resolution changes.
2. The bars scale horizontally to cover the entire requested date/time range.

For example, clicking 1Y makes the chart switch the resolution to 1W and scale it accordingly to display weekly bars for the entire year. Each time frame has its default chart resolution:

Time frame	Chart resolution
5Y	W
1Y	W
6M	120
3M	60
1M	30
5D	5
1D	1

Time frame customization

You can customize displayed time frames using the time_frames property of the Widget Constructor. Note that time frames that require resolutions that are unavailable for a particular symbol will be hidden. You can also check out the Widget Constructor tutorial on YouTube for an implementation example.

Programmatic time frame setting

If you want to programmatically set the time frame for the active chart, use the setTimeFrame method of the IChartWidgetApi. For example, the following code snippet applies the 1Y time frame, which is the same as when users click 1Y at the bottom of the chart:

const widget = new TradingView.widget(/* Widget properties */);

widget.onChartReady(() => {
    const chart = widget.chart();
    chart.setTimeFrame({val: {type: 'period-back', value: '12M'}, res: '1W'});
});

Extended time scale

You can enable indicators to extend the time scale. This allows you to create custom indicators that show bars at a higher resolution than the main series. Refer to Extending the time scale for more information.

Extended sessions

If you want to display extended sessions for some symbols, refer to the Extended sessions article for more information.