← Back to Skills Marketplace
xiaoxianceng874-cyber

system-time

by xiaoxianceng874-cyber · GitHub ↗ · v1.0.0 · MIT-0
cross-platform ✓ Security Clean
219
Downloads
0
Stars
1
Active Installs
1
Versions
Install in OpenClaw
/install hengheng-system-time
Description
Get accurate system time in various formats and timezones. Use when the user needs to know the current time, date, timestamp, or wants to convert between tim...
README (SKILL.md)

System Time

Get accurate system time information in multiple formats.

Quick Usage

Current Time (Local)

date                                    # Human readable
date -Iseconds                          # ISO 8601 with seconds
date +%s                                # Unix timestamp

Current Time (UTC)

date -u                                 # UTC human readable
date -u -Iseconds                       # UTC ISO 8601
date -u +%s                             # UTC Unix timestamp (same as local)

Specific Timezone

TZ=Asia/Shanghai date                   # Shanghai time
TZ=America/New_York date                # New York time
TZ=Europe/London date                   # London time

Common Formats

Format Command Example Output
ISO 8601 date -Iseconds 2024-03-11T16:30:00+08:00
Unix timestamp date +%s 1710145800
RFC 2822 date -R Mon, 11 Mar 2024 16:30:00 +0800
Custom date "+%Y-%m-%d %H:%M:%S" 2024-03-11 16:30:00

Timezone Conversion

Convert from one timezone to another:

# Convert specific time from Shanghai to New York
TZ=America/New_York date -d "2024-03-11 16:30:00 CST"

# List available timezones
ls /usr/share/zoneinfo/

Python Alternative (for scripting)

from datetime import datetime, timezone

# Current UTC time
utc_now = datetime.now(timezone.utc)
print(utc_now.isoformat())

# Current local time
local_now = datetime.now()
print(local_now.isoformat())

# Unix timestamp
print(int(utc_now.timestamp()))

Notes

  • Unix timestamp is always UTC (timezone-independent)
  • ISO 8601 format includes timezone offset
  • Use timedatectl on Linux systems for system clock info
Usage Guidance
This is an instruction-only skill that runs local date and simple Python commands to show/convert times and may list your system's zoneinfo directory. It does not request credentials, install software, or make network calls. If you permit the agent to execute shell/Python commands, it will run these local commands; if you prefer no local execution, do not invoke the skill or restrict the agent's execution privileges. Also note timezone data paths may differ on non-Linux systems (e.g., macOS or minimal containers).
Capability Analysis
Type: OpenClaw Skill Name: hengheng-system-time Version: 1.0.0 The skill bundle provides standard documentation and command-line examples for retrieving system time, timestamps, and performing timezone conversions using common utilities like 'date' and Python's 'datetime' library. No malicious code, data exfiltration, or suspicious instructions were found in SKILL.md or _meta.json.
Capability Assessment
Purpose & Capability
The name/description (system time and timezone conversion) matches the instructions: shell date commands, TZ environment usage, listing zoneinfo, and a small Python snippet. No unrelated credentials, binaries, or installs are requested.
Instruction Scope
SKILL.md only instructs running local date commands, setting TZ, listing /usr/share/zoneinfo, and running a short Python snippet for time formats—these stay within the stated purpose and do not ask for unrelated file reads or network exfiltration.
Install Mechanism
No install spec or code files are present; this is instruction-only so nothing will be written to disk by an installer.
Credentials
No environment variables, credentials, or config paths are required beyond using TZ temporarily in commands; requested access is proportional to the task.
Persistence & Privilege
Skill is not always-enabled and does not request persistent presence or modify other skills/system settings. It only instructs transient local commands.
How to Use
  1. Make sure OpenClaw is installed (local or Docker)
  2. Run the install command in chat: /install hengheng-system-time
  3. After installation, invoke the skill by name or use /hengheng-system-time
  4. Provide required inputs per the skill's parameter spec and get structured output
Version History
v1.0.0
Initial release—provides tools for retrieving and converting system time in various formats and timezones. - Supports ISO 8601, Unix timestamp, RFC 2822, and customizable formats. - Easily get current time for any specified timezone. - Explains command-line usage with `date` and timezone options. - Includes Python code examples for programmatic access. - Quick reference table for formats and commands.
Metadata
Slug hengheng-system-time
Version 1.0.0
License MIT-0
All-time Installs 1
Active Installs 1
Total Versions 1
Frequently Asked Questions

What is system-time?

Get accurate system time in various formats and timezones. Use when the user needs to know the current time, date, timestamp, or wants to convert between tim... It is an AI Agent Skill for Claude Code / OpenClaw, with 219 downloads so far.

How do I install system-time?

Run "/install hengheng-system-time" in the OpenClaw or Claude Code chat to install it in one step — no extra setup required.

Is system-time free?

Yes, system-time is completely free, licensed under MIT-0. You can download, install and use it at no cost.

Which platforms does system-time support?

system-time is cross-platform and runs anywhere OpenClaw / Claude Code is available (cross-platform).

Who created system-time?

It is built and maintained by xiaoxianceng874-cyber (@xiaoxianceng874-cyber); the current version is v1.0.0.

💬 Comments