PINE LIBRARY
TimezoneFormatIANAUTC

Library "TimezoneFormatIANAUTC"
Provides either the full IANA timezone identifier or the corresponding UTC offset for TradingView’s built-in variables and functions.
tz(_tzname, _format)
Parameters:
_tzname (string): "London", "New York", "Istanbul", "+1:00", "-03:00" etc.
_format (string): "IANA" or "UTC"
Returns: "Europe/London", "America/New York", "UTC+1:00"
Example Code
Pine Script®
Parameter Format Guide
This section explains how to properly format the parameters for thePine Script® function.
_tzname (string) must be either;
examples;
_tztype (string) must be either;
Provides either the full IANA timezone identifier or the corresponding UTC offset for TradingView’s built-in variables and functions.
tz(_tzname, _format)
Parameters:
_tzname (string): "London", "New York", "Istanbul", "+1:00", "-03:00" etc.
_format (string): "IANA" or "UTC"
Returns: "Europe/London", "America/New York", "UTC+1:00"
Example Code
import ARrowofTime/TimezoneFormatIANAUTC/1 as libtz
sesTZInput = input.string(defval = "Singapore", title = "Timezone")
example1 = libtz.tz("London", "IANA") // Return Europe/London
example2 = libtz.tz("London", "UTC") // Return UTC+1:00
example3 = libtz.tz("UTC+5", "IANA") // Return UTC+5:00
example4 = libtz.tz("UTC+4:30", "UTC") // Return UTC+4:30
example5 = libtz.tz(sesTZInput, "IANA") // Return Asia/Singapore
example6 = libtz.tz(sesTZInput, "UTC") // Return UTC+8:00
sesTime1 = time("","1300-1700", example1) // returns the UNIX time of the current bar in session time or na
sesTime2 = time("","1300-1700", example2) // returns the UNIX time of the current bar in session time or na
sesTime3 = time("","1300-1700", example3) // returns the UNIX time of the current bar in session time or na
sesTime4 = time("","1300-1700", example4) // returns the UNIX time of the current bar in session time or na
sesTime5 = time("","1300-1700", example5) // returns the UNIX time of the current bar in session time or na
sesTime6 = time("","1300-1700", example6) // returns the UNIX time of the current bar in session time or na
Parameter Format Guide
This section explains how to properly format the parameters for the
tz(_tzname, _format)
_tzname (string) must be either;
- A valid timezone name exactly as it appears in the chart’s lower-right corner (e.g. New York, London).
- A valid UTC offset in ±H:MM or ±HH:MM format. Hours: 0–14 (zero-padded or not, e.g. +1:30, +01:30, -0:00). Minutes: Must be 00, 15, 30, or 45
examples;
- "New York" → ✅ Valid chart label
- "London" → ✅ Valid chart label
- "Berlin" → ✅ Valid chart label
- "America/New York" → ❌ Invalid chart label. (Use "New York" instead)
- "+1:30" → ✅ Valid offset with single-digit hour
- "+01:30" → ✅ Valid offset with zero-padded hour
- "-05:00" → ✅ Valid negative offset
- "-0:00" → ✅ Valid zero offset
- "+1:1" → ❌ Invalid (minute must be 00, 15, 30, or 45)
- "+2:50" → ❌ Invalid (minute must be 00, 15, 30, or 45)
- "+15:00" → ❌ Invalid (hour must be 14 or below)
_tztype (string) must be either;
- "IANA" → returns full IANA timezone identifier (e.g. "Europe/London"). When a time function call uses an IANA time zone identifier for its timezone argument, its calculations adjust automatically for historical and future changes to the specified region’s observed time, such as daylight saving time (DST) and updates to time zone boundaries, instead of using a fixed offset from UTC.
- "UTC" → returns UTC offset string (e.g. "UTC+01:00")
Pine腳本庫
秉持 TradingView 一貫的共享精神,作者將此 Pine 程式碼發佈為開源庫,讓社群中的其他 Pine 程式設計師能夠重複使用。向作者致敬!您可以在私人專案或其他開源發佈中使用此庫,但在公開發佈中重複使用該程式碼需遵守社群規範。
All content shared by ARTech serves educational and informational purposes only. Historical results do not guarantee future outcomes.
免責聲明
這些資訊和出版物並不意味著也不構成TradingView提供或認可的金融、投資、交易或其他類型的意見或建議。請在使用條款閱讀更多資訊。
Pine腳本庫
秉持 TradingView 一貫的共享精神,作者將此 Pine 程式碼發佈為開源庫,讓社群中的其他 Pine 程式設計師能夠重複使用。向作者致敬!您可以在私人專案或其他開源發佈中使用此庫,但在公開發佈中重複使用該程式碼需遵守社群規範。
All content shared by ARTech serves educational and informational purposes only. Historical results do not guarantee future outcomes.
免責聲明
這些資訊和出版物並不意味著也不構成TradingView提供或認可的金融、投資、交易或其他類型的意見或建議。請在使用條款閱讀更多資訊。