Hello there đź‘‹

Thanks for stopping by! We use cookies to help us understand how you interact with our website.

By clicking “Accept all”, you consent to our use of cookies. For more information, please see our privacy policy.

  1. Contents
  2. st.context
  3. context.cookies
  4. context.headers
  5. context.timezone
  6. context.timezone_offset

st.context

An interface to access user session context.

st.context provides a read-only interface to access headers and cookies for the current user session.

Each property (st.context.headers and st.context.cookies) returns a dictionary of named values.

Class description[source]

st.context()

Attributes

A read-only, dict-like object containing cookies sent in the initial request.

A read-only, dict-like object containing headers sent in the initial request.

The read-only timezone of the user's browser.

The read-only timezone offset of the user's browser.

context.cookies

A read-only, dict-like object containing cookies sent in the initial request.

Function signature[source]

context.cookies

Examples

Example 1: Access all available cookies

Show a dictionary of cookies:

import streamlit as st

st.context.cookies

Example 2: Access a specific cookie

Show the value of a specific cookie:

import streamlit as st

st.context.cookies["_ga"]

context.headers

A read-only, dict-like object containing headers sent in the initial request.

Keys are case-insensitive and may be repeated. When keys are repeated, dict-like methods will only return the last instance of each key. Use .get_all(key="your_repeated_key") to see all values if the same header is set multiple times.

Function signature[source]

context.headers

Examples

Example 1: Access all available headers

Show a dictionary of headers (with only the last instance of any repeated key):

import streamlit as st

st.context.headers

Example 2: Access a specific header

Show the value of a specific header (or the last instance if it's repeated):

import streamlit as st

st.context.headers["host"]

Show of list of all headers for a given key:

import streamlit as st

st.context.headers.get_all("pragma")

context.timezone

The read-only timezone of the user's browser.

Function signature[source]

context.timezone

Example

Access the user's timezone, and format a datetime to display locally:

import streamlit as st
from datetime import datetime, timezone
import pytz

tz = st.context.timezone
tz_obj = pytz.timezone(tz)

now = datetime.now(timezone.utc)

f"The user's timezone is {tz}."
f"The UTC time is {now}."
f"The user's local time is {now.astimezone(tz_obj)}"

context.timezone_offset

The read-only timezone offset of the user's browser.

Function signature[source]

context.timezone_offset

Example

Access the user's timezone offset, and format a datetime to display locally:

import streamlit as st
from datetime import datetime, timezone, timedelta

tzoff = st.context.timezone_offset
tz_obj = timezone(-timedelta(minutes=tzoff))

now = datetime.now(timezone.utc)

f"The user's timezone is {tz}."
f"The UTC time is {now}."
f"The user's local time is {now.astimezone(tz_obj)}"
Previous: st.session_stateNext: st.query_params
forum

Still have questions?

Our forums are full of helpful information and Streamlit experts.