deephaven-plugin-clockface

A live clock for deephaven.ui panels, in seven faces — modern digital, seven-segment retro, analog, split-flap, binary, nixie tube and word clock. Every face is drawn from the Deephaven theme's own colors, so it fits whatever theme is in use.

The clock ticks from the browser, so it keeps time without server round trips and a wall of clocks costs no more than one.

Install

pip install deephaven-plugin-clockface

Then restart the Deephaven server.

Usage

from deephaven import ui

from deephaven_plugin_clockface import clockface


@ui.component
def my_panel():
    return clockface()


my_clock = my_panel()

Pick a face, a time zone and a format:

clockface(face="analog", timezone="Asia/Tokyo", twenty_four_hour=True, show_date=True)

Faces

Options

timezone is read by the browser, so it accepts any zone the viewer's browser knows. An unrecognized name falls back to local time rather than blanking the clock.

A wall of clocks

Each instance keeps its own time, so a trading-desk row is just the component repeated:

from deephaven import ui

from deephaven_plugin_clockface import clockface

DESKS = [
    ("New York", "America/New_York"),
    ("London", "Europe/London"),
    ("Tokyo", "Asia/Tokyo"),
]


@ui.component
def desk_clocks():
    return ui.flex(
        *[
            ui.flex(
                ui.heading(city, level=4),
                clockface(face="flip", timezone=zone, twenty_four_hour=True),
                direction="column",
                align_items="center",
            )
            for city, zone in DESKS
        ],
        gap="size-400",
    )


world_clock = desk_clocks()

Letting the user pick a face

face is an ordinary prop, so anything Python can compute can drive it:

from deephaven import ui

from deephaven_plugin_clockface import FACES, clockface


@ui.component
def face_picker():
    face, set_face = ui.use_state("digital")

    return ui.flex(
        clockface(face=face),
        ui.picker(
            *[ui.item(name, key=name) for name in FACES],
            label="Face",
            selected_key=face,
            on_change=set_face,
        ),
        direction="column",
    )


picker = face_picker()

Examples

Runnable panels live in examples/:

• clockface_demo.py — a face picker and a world-clock row.
• all_faces.py — every face, side by side.

Contributing

See AGENTS.md for the project layout and how to build, run and test it.