Metadata-Version: 2.4
Name: jej-when
Version: 1.1.0
Summary: A stupidly simple CLI to tell time across timezones.
Author: Jej111
Requires-Python: >=3.7
Description-Content-Type: text/markdown

# Jej-WHEN ⏱️

Because remembering `Asia/Shanghai` is a pain.

A stupidly simple CLI to tell time across timezones. With multi-language support.

## Installation

Run this command in your terminal:

    pip install jej-when

*(If you are using a strict environment like Alpine Linux, use `pip install jej-when --break-system-packages`)*

## Usage

Pass the UTC offset as a parameter:

    $ when +8
    🌍 UTC+8 | 2026-10-18 23:59:59

    $ when -5
    🌍 UTC-5 | 2026-10-18 10:59:59

    $ when 0
    🌍 UTC+0 | 2026-10-18 15:59:59

## Features

- **Multi-language Support**: Automatically detects your system language or manually switch between Chinese, English, French, Russian, and Spanish.
- **Help Page**: Typing `when -h` shows a beautifully formatted help page.
- **No Dependencies**: Built with pure Python standard libraries. No external packages needed.

### Language Examples

Force the output to a specific language using `--lang`:

    $ when --lang fr
    🇫🇷 (French interface)

    $ when --lang ru
    🇷🇺 (Russian interface)

    $ when --lang es
    🇪🇸 (Spanish interface)

## Why?

Because `date -u` only gives you UTC, and `TZ='Asia/Shanghai' date` is too long to type. 
Just type `when +8`. Simple as that.
