Time and sessions

Read from the bar's opening time. "" means the exchange zone of the symbol (symbol.timezone), or UTC when the feed gives none. Any other zone is an IANA name such as "America/New_York", and clock changes for summer time are handled for you.

Never missing. Every bar has an opening time.

These read the bar's own opening time, so live and historical bars behave the same. A forming bar gives the same answer while it updates and after it closes.

Read from the bar's opening time. "" means the exchange zone of the symbol (symbol.timezone), or UTC when the feed gives none. Any other zone is an IANA name such as "America/New_York", and clock changes for summer time are handled for you.

Never missing. Every bar has an opening time.

These read the bar's own opening time, so live and historical bars behave the same. A forming bar gives the same answer while it updates and after it closes.

Weeks start on Monday, so Monday is 1, Friday is 5 and Sunday is 7. A futures session that opens on Sunday evening has bars with weekday 7 until midnight.

Read from the bar's opening time. "" means the exchange zone of the symbol (symbol.timezone), or UTC when the feed gives none. Any other zone is an IANA name such as "America/New_York", and clock changes for summer time are handled for you.

Never missing. Every bar has an opening time.

These read the bar's own opening time, so live and historical bars behave the same. A forming bar gives the same answer while it updates and after it closes.

Read from the bar's opening time. "" means the exchange zone of the symbol (symbol.timezone), or UTC when the feed gives none. Any other zone is an IANA name such as "America/New_York", and clock changes for summer time are handled for you.

Never missing. Every bar has an opening time.

These read the bar's own opening time, so live and historical bars behave the same. A forming bar gives the same answer while it updates and after it closes.

Read from the bar's opening time. "" means the exchange zone of the symbol (symbol.timezone), or UTC when the feed gives none. Any other zone is an IANA name such as "America/New_York", and clock changes for summer time are handled for you.

Never missing. Every bar has an opening time.

These read the bar's own opening time, so live and historical bars behave the same. A forming bar gives the same answer while it updates and after it closes.

Read from the bar's opening time. "" means the exchange zone of the symbol (symbol.timezone), or UTC when the feed gives none. Any other zone is an IANA name such as "America/New_York", and clock changes for summer time are handled for you.

Never missing. Every bar has an opening time.

These read the bar's own opening time, so live and historical bars behave the same. A forming bar gives the same answer while it updates and after it closes.

On daily and weekly charts it is always false, because one bar covers the whole day.

Read from the bar's opening time. "" means the exchange zone of the symbol (symbol.timezone), or UTC when the feed gives none. Any other zone is an IANA name such as "America/New_York", and clock changes for summer time are handled for you. The window is read on the clock of that zone.

Never missing. Every bar has an opening time.

These read the bar's own opening time, so live and historical bars behave the same. A forming bar gives the same answer while it updates and after it closes.

A window that crosses midnight keeps counting past midnight.

Read from the bar's opening time. "" means the exchange zone of the symbol (symbol.timezone), or UTC when the feed gives none. Any other zone is an IANA name such as "America/New_York", and clock changes for summer time are handled for you. The window is read on the clock of that zone. The result is in minutes.

Gives missing when the bar opens outside the window, and always on daily and weekly charts.

These read the bar's own opening time, so live and historical bars behave the same. A forming bar gives the same answer while it updates and after it closes.

Use it to reset a value at the open, such as the opening range. On daily and weekly charts it is always false.

Read from the bar's opening time. "" means the exchange zone of the symbol (symbol.timezone), or UTC when the feed gives none. Any other zone is an IANA name such as "America/New_York", and clock changes for summer time are handled for you. The window is read on the clock of that zone.

Never missing. Every bar has an opening time.

These read the bar's own opening time, so live and historical bars behave the same. A forming bar gives the same answer while it updates and after it closes.

These are the same boundaries the built-in VWAP and pivots use. For futures, "Session" starts at the evening open, while "Day" starts at midnight.

Always read in the exchange zone of the symbol (symbol.timezone), from the bar's opening time.

Never missing. Every bar has an opening time.

These read the bar's own opening time, so live and historical bars behave the same. A forming bar gives the same answer while it updates and after it closes.

It is read without brackets. Because a closed bar always reads its closing time, a script gives the same history on every run.

A time in milliseconds since 1 January 1970 UTC, the same kind of number as time. A time is one instant everywhere; read its wall clock with clock.wall or clock.format. Zones: "" or "exchange" is the symbol's exchange zone (symbol.timezone, or UTC when the feed gives none); "chart" is the chart's display zone (the exchange zone when the chart does not say); "UTC" and IANA names such as "America/New_York" work too, and clock changes for summer time are handled for you. hour, minute, weekday, day, month and year accept "chart" and "exchange" as well.

Never missing.

The chart clock never changes history. On a closed bar it is the bar's closing time. On the forming (newest, live) bar it is the time the chart gives with each price update, kept between the bar's open and close; when the chart gives no time, and always in a backtest, it is the bar's opening time. A script runs on each price update, so anything it shows from the clock refreshes with each update, not every second.

A time in milliseconds since 1 January 1970 UTC, the same kind of number as time. A time is one instant everywhere; read its wall clock with clock.wall or clock.format. Zones: "" or "exchange" is the symbol's exchange zone (symbol.timezone, or UTC when the feed gives none); "chart" is the chart's display zone (the exchange zone when the chart does not say); "UTC" and IANA names such as "America/New_York" work too, and clock changes for summer time are handled for you. hour, minute, weekday, day, month and year accept "chart" and "exchange" as well.

Never missing. When the chart does not say how long a bar is, one minute is used.

The chart clock never changes history. On a closed bar it is the bar's closing time. On the forming (newest, live) bar it is the time the chart gives with each price update, kept between the bar's open and close; when the chart gives no time, and always in a backtest, it is the bar's opening time. A script runs on each price update, so anything it shows from the clock refreshes with each update, not every second.

Milliseconds. Divide by 1000 for seconds or by 60000 for minutes.

Never missing.

The chart clock never changes history. On a closed bar it is the bar's closing time. On the forming (newest, live) bar it is the time the chart gives with each price update, kept between the bar's open and close; when the chart gives no time, and always in a backtest, it is the bar's opening time. A script runs on each price update, so anything it shows from the clock refreshes with each update, not every second.

Text cannot be plotted; show it with table, marker or print. It refreshes with each price update, not every second.

Seconds are rounded up, so 0:00 shows only once the bar has closed.

Empty text when the time left cannot be known.

The chart clock never changes history. On a closed bar it is the bar's closing time. On the forming (newest, live) bar it is the time the chart gives with each price update, kept between the bar's open and close; when the chart gives no time, and always in a backtest, it is the bar's opening time. A script runs on each price update, so anything it shows from the clock refreshes with each update, not every second.

Keep it in a state variable to notice when it changes, or use period.starts("Session") to catch the first bar of each new day.

Read from the bar's opening time, in the exchange zone of the symbol. A futures evening session belongs to the next day: a bar at 18:00 New York time on Thursday 29 October 2026 is on trading day 20261030. When the symbol has no session it is the calendar day.

Never missing.

The chart clock never changes history. On a closed bar it is the bar's closing time. On the forming (newest, live) bar it is the time the chart gives with each price update, kept between the bar's open and close; when the chart gives no time, and always in a backtest, it is the bar's opening time. A script runs on each price update, so anything it shows from the clock refreshes with each update, not every second.

Zones: "" or "exchange" is the symbol's exchange zone (symbol.timezone, or UTC when the feed gives none); "chart" is the chart's display zone (the exchange zone when the chart does not say); "UTC" and IANA names such as "America/New_York" work too, and clock changes for summer time are handled for you. hour, minute, weekday, day, month and year accept "chart" and "exchange" as well.

Fixed for the whole run, so it may be read in setup. Never empty: it falls back to the exchange zone, and that to UTC.

Unlike symbol.timezone, it is never empty: it shows the zone the clock functions really use.

Zones: "" or "exchange" is the symbol's exchange zone (symbol.timezone, or UTC when the feed gives none); "chart" is the chart's display zone (the exchange zone when the chart does not say); "UTC" and IANA names such as "America/New_York" work too, and clock changes for summer time are handled for you. hour, minute, weekday, day, month and year accept "chart" and "exchange" as well.

Fixed for the whole run, so it may be read in setup. Never empty.

Longer tokens are matched first, so MMMM is the month name and not two months. Month and day names are in English.

A time in milliseconds since 1 January 1970 UTC, the same kind of number as time. A time is one instant everywhere; read its wall clock with clock.wall or clock.format. Zones: "" or "exchange" is the symbol's exchange zone (symbol.timezone, or UTC when the feed gives none); "chart" is the chart's display zone (the exchange zone when the chart does not say); "UTC" and IANA names such as "America/New_York" work too, and clock changes for summer time are handled for you. hour, minute, weekday, day, month and year accept "chart" and "exchange" as well.

A missing time gives empty text.

A time in milliseconds since 1 January 1970 UTC, the same kind of number as time. A time is one instant everywhere; read its wall clock with clock.wall or clock.format. Zones: "" or "exchange" is the symbol's exchange zone (symbol.timezone, or UTC when the feed gives none); "chart" is the chart's display zone (the exchange zone when the chart does not say); "UTC" and IANA names such as "America/New_York" work too, and clock changes for summer time are handled for you. hour, minute, weekday, day, month and year accept "chart" and "exchange" as well.

A missing time gives a tuple where every part is missing.

Parts with decimals are cut to whole numbers. A wall time skipped when the clocks go forward (such as 02:30 on the spring change in New York) moves one hour on.

A time in milliseconds since 1 January 1970 UTC, the same kind of number as time. A time is one instant everywhere; read its wall clock with clock.wall or clock.format. Zones: "" or "exchange" is the symbol's exchange zone (symbol.timezone, or UTC when the feed gives none); "chart" is the chart's display zone (the exchange zone when the chart does not say); "UTC" and IANA names such as "America/New_York" work too, and clock changes for summer time are handled for you. hour, minute, weekday, day, month and year accept "chart" and "exchange" as well.

Any missing part gives missing.

The time is in milliseconds since 1 January 1970 UTC; the answer is in minutes. Zones: "" or "exchange" is the symbol's exchange zone (symbol.timezone, or UTC when the feed gives none); "chart" is the chart's display zone (the exchange zone when the chart does not say); "UTC" and IANA names such as "America/New_York" work too, and clock changes for summer time are handled for you. hour, minute, weekday, day, month and year accept "chart" and "exchange" as well.

A missing time gives missing.

The session comes from symbol.session, on Monday to Friday, in the exchange zone. A perpetual (symbol.asset_class is "perps") and a symbol with no session text trade all the time, so the session is always open. Holidays and early closes are not known to the script.

Read at clock.now, on the session's hours in the exchange zone (clock.exchange_zone).

Never missing.

The chart clock never changes history. On a closed bar it is the bar's closing time. On the forming (newest, live) bar it is the time the chart gives with each price update, kept between the bar's open and close; when the chart gives no time, and always in a backtest, it is the bar's opening time. A script runs on each price update, so anything it shows from the clock refreshes with each update, not every second. Sessions are read at that clock, so on a closed bar they describe the moment the bar closed.

The session comes from symbol.session, on Monday to Friday, in the exchange zone. A perpetual (symbol.asset_class is "perps") and a symbol with no session text trade all the time, so the session is always open. Holidays and early closes are not known to the script.

A time in milliseconds since 1 January 1970 UTC, the same kind of number as time. A time is one instant everywhere; read its wall clock with clock.wall or clock.format. Zones: "" or "exchange" is the symbol's exchange zone (symbol.timezone, or UTC when the feed gives none); "chart" is the chart's display zone (the exchange zone when the chart does not say); "UTC" and IANA names such as "America/New_York" work too, and clock changes for summer time are handled for you. hour, minute, weekday, day, month and year accept "chart" and "exchange" as well.

missing when the symbol has no session text.

The chart clock never changes history. On a closed bar it is the bar's closing time. On the forming (newest, live) bar it is the time the chart gives with each price update, kept between the bar's open and close; when the chart gives no time, and always in a backtest, it is the bar's opening time. A script runs on each price update, so anything it shows from the clock refreshes with each update, not every second. Sessions are read at that clock, so on a closed bar they describe the moment the bar closed.

The session comes from symbol.session, on Monday to Friday, in the exchange zone. A perpetual (symbol.asset_class is "perps") and a symbol with no session text trade all the time, so the session is always open. Holidays and early closes are not known to the script.

A time in milliseconds since 1 January 1970 UTC, the same kind of number as time. A time is one instant everywhere; read its wall clock with clock.wall or clock.format. Zones: "" or "exchange" is the symbol's exchange zone (symbol.timezone, or UTC when the feed gives none); "chart" is the chart's display zone (the exchange zone when the chart does not say); "UTC" and IANA names such as "America/New_York" work too, and clock changes for summer time are handled for you. hour, minute, weekday, day, month and year accept "chart" and "exchange" as well.

missing when the symbol has no session text.

The chart clock never changes history. On a closed bar it is the bar's closing time. On the forming (newest, live) bar it is the time the chart gives with each price update, kept between the bar's open and close; when the chart gives no time, and always in a backtest, it is the bar's opening time. A script runs on each price update, so anything it shows from the clock refreshes with each update, not every second. Sessions are read at that clock, so on a closed bar they describe the moment the bar closed.

The session comes from symbol.session, on Monday to Friday, in the exchange zone. A perpetual (symbol.asset_class is "perps") and a symbol with no session text trade all the time, so the session is always open. Holidays and early closes are not known to the script.

Milliseconds. Divide by 1000 for seconds or by 60000 for minutes.

Never missing: 0 while open, and 0 when the symbol has no session text.

The chart clock never changes history. On a closed bar it is the bar's closing time. On the forming (newest, live) bar it is the time the chart gives with each price update, kept between the bar's open and close; when the chart gives no time, and always in a backtest, it is the bar's opening time. A script runs on each price update, so anything it shows from the clock refreshes with each update, not every second. Sessions are read at that clock, so on a closed bar they describe the moment the bar closed.

The session comes from symbol.session, on Monday to Friday, in the exchange zone. A perpetual (symbol.asset_class is "perps") and a symbol with no session text trade all the time, so the session is always open. Holidays and early closes are not known to the script.

Milliseconds. Divide by 1000 for seconds or by 60000 for minutes.

missing while the session is closed, and when the symbol has no session text.

The chart clock never changes history. On a closed bar it is the bar's closing time. On the forming (newest, live) bar it is the time the chart gives with each price update, kept between the bar's open and close; when the chart gives no time, and always in a backtest, it is the bar's opening time. A script runs on each price update, so anything it shows from the clock refreshes with each update, not every second. Sessions are read at that clock, so on a closed bar they describe the moment the bar closed.