dayofweek() - PineScript Function

dayofweek()

Overview

Calculates the day number of the week, in a specified time zone, from a UNIX timestamp.

Syntax

dayofweek(time, timezone) → series int

Parameters

Name	Type	Description
time	series int	UNIX timestamp (ms) to evaluate.
timezone	const string	Optional IANA timezone. Defaults to the exchange timezone.

Returns

The calculated day number, expressed in the specified time zone.

Remarks

• Day numbers follow TradingView’s enum constants (dayofweek.monday, …, dayofweek.sunday).
• Pass syminfo.timezone to align with the instrument’s exchange.

Examples

//@version=5
indicator("Weekday shading", overlay=true)

dow = dayofweek(time, syminfo.timezone)

isWeekend = dow == dayofweek.saturday or dow == dayofweek.sunday

bgcolor(isWeekend ? color.new(color.gray, 90) : na)
plot(close, "Close")

See Also

• dayofweek()
• dayofmonth()
• weekofyear()
• time()
• year()
• month()
• hour()
• minute()
• second()