Getting Started

Umi‑Time gives you a single, planetary time of day: one shared value everywhere on Earth, interpreted locally through longitude and solar context. This page helps you see it, understand it, and use it within a minute.

What You Can Do Here

  • View Umi‑Time in your browser
  • Understand how it relates to civil time and UTC
  • Use the interactive clock
  • Install the library for your own projects
  • Convert between Umi‑Time, UTC and local civil time

See Umi‑Time in Action

The Umi‑Time analog clock is the reference analog implementation of Umi‑Time and often the simplest way to understand the system.

Open the Clock Demo

Understanding the Basics

Umi‑Time expresses the day as a smooth, uninterrupted 360‑unit cycle derived directly from UTC. Every place on Earth shares the same umi value at the same moment, with local meaning derived from longitude-based interpretation.

Umi‑Time builds on UTC through a layered model

  1. UTC provides the universal time reference.
  2. Umi‑Time expresses the UTC day as a 360‑umi cycle.
  3. Longitude-based local interpretation shows where that universal value falls within the observer's day without using time zones.
  4. Optional solar context layers provide sunrise, sunset, twilight, and other astronomical context related to the observer's location.

These layers never alter the underlying umi value. Everyone on Earth shares the same umi value at the same moment. The layers only provide progressively richer ways to interpret that value locally.

Using Umi‑Time Day to Day

Umi‑Time helps you understand where the world is in the day at a glance. Because everyone shares the same umi value, global coordination becomes simpler, while local interpretation preserves an intuitive sense of morning, afternoon, evening, and night.

Developer Quickstart

If you want to use Umi‑Time programmatically, here is a simple example:

// Get the current Umi‑Time value
import { UmiTime } from "umi-time";
import { UMI_EXTENDED } from "umi-time";

const now = new Date();
const umi = new UmiTime(now);

const text = umi.format(UMI_EXTENDED);
console.log(text);

See the Developer API Reference for full details.

Next Steps

Documentation
Developer
Project