Timezone Helper for Openclaw

An offline-first global time management tool for seamless conversions, DST tracking, and cross-border meeting scheduling.

tobewin
v1.0.0
Mar 20, 2026
0
928
0

Install & Download

1. ClawHub CLI

The fastest way to install a skill directly from the registry.

npx clawhub@latest install timezone-helper

2. Manual Installation

Copy the skill folder to one of these locations

Global
~/.openclaw/skills/
Workspace
<project>/skills/

Priority: Workspace > Local > Bundled

3. Prompt Installation

Copy this prompt to OpenClaw to install it automatically.

Help me install timezone-helper using Clawhub. If Clawhub is not installed, install it first (npm i -g clawhub).

Prefer to download?

Get the raw skill files in a ZIP archive.

What is Timezone Helper?

Timezone Helper is a robust utility designed for the Openclaw Skills ecosystem, providing instant time zone conversions and world clock functionality without the need for external APIs or internet connectivity. It utilizes built-in IANA timezone data to resolve city-to-timezone mappings for over 200 cities, making it an essential tool for developers and teams working across distributed environments.

This skill goes beyond simple clock checks by offering a sophisticated meeting planner and Daylight Saving Time (DST) calculator. Whether you are coordinating a release across San Francisco and Tokyo or simply checking if a colleague in London has already started their day, Timezone Helper ensures high accuracy by accounting for seasonal transitions and non-standard offsets.

Timezone Helper Use Cases

  • Resolving current local time for major global cities instantly.
  • Converting specific timestamps between multiple international zones (e.g., EST to JST).
  • Planning optimal meeting slots for distributed teams across 3+ time zones.
  • Checking seasonal Daylight Saving Time transition dates for any supported region.
  • Clarifying ambiguous timezone abbreviations like IST, CST, or BST.

How Timezone Helper Works

  1. Resolution: The skill first maps the user's input (city or abbreviation) to a specific IANA timezone using its internal reference database.
  2. Offset Calculation: It determines the current UTC offset for both source and target locations.
  3. DST Verification: The system checks the current date against regional DST rules to adjust offsets by ±1 hour where applicable.
  4. Transformation: The source time is converted using the formula: Target time = Source time + (Target UTC offset) - (Source UTC offset).
  5. Formatting: Results are rendered in clean, structured layouts for world clocks, single conversions, or meeting availability tables.

Timezone Helper Setup

To integrate this into your environment as part of your Openclaw Skills library, follow these steps:

# Navigate to your agent's skill directory
cd skills/timezone-helper

# Ensure references/cities.md is accessible for mapping
ls references/cities.md

# No external dependencies or API keys required

Timezone Helper Data Schema & Taxonomy

The skill organizes its internal logic and reference data to ensure zero-latency responses:

Data Component Format Purpose
cities.md Markdown Table Maps cities to IANA identifiers (e.g., Tokyo -> Asia/Tokyo).
IANA Zones String Metadata Standardized timezone naming (e.g., America/New_York).
DST Rules Logic Trees Logic for Spring Forward/Fall Back transitions per hemisphere.
Meeting Scores Integer 09:00-18:00 (Ideal), 07:00-21:00 (Acceptable).

Timezone Helper Advanced Features

  • Multi-Zone Scoring: Automatically evaluates UTC hours to find the 'Ideal' or 'Workable' overlap for global team syncs.
  • Ambiguity Resolution: Context-aware logic to distinguish between duplicate abbreviations (e.g., US Central vs. China Standard Time).
  • High-Precision Offsets: Full support for non-integer offsets like India (UTC+5:30) and Nepal (UTC+5:45).
  • Static-Logic Offline Mode: Operates entirely without external scripts or Python dependencies, ensuring privacy and speed.

SKILL.md


Loading

Related Openclaw Skills

METADATA

Github Stars: 0
forks: 0

Featured*