Metadata-Version: 2.4
Name: tsfmt-core
Version: 0.1.0
Summary: A lightweight command-line utility for parsing and reformatting timestamps.
Author: tsfmt-core contributors
License-Expression: MIT
Keywords: timestamp,datetime,formatting,cli,utility
Classifier: Development Status :: 3 - Alpha
Classifier: Environment :: Console
Classifier: Intended Audience :: Developers
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3.8
Classifier: Programming Language :: Python :: 3.9
Classifier: Programming Language :: Python :: 3.10
Classifier: Programming Language :: Python :: 3.11
Classifier: Programming Language :: Python :: 3.12
Classifier: Topic :: Utilities
Requires-Python: >=3.8
Description-Content-Type: text/markdown

# tsfmt-core

A lightweight command-line utility for parsing and reformatting timestamps.

## Installation

```bash
pip install tsfmt-core
```

## Usage

```bash
# Show current time in all formats
tsfmt-core

# Parse and reformat a specific timestamp
tsfmt-core "2026-04-13T10:00:00"

# Parse a unix epoch value
tsfmt-core 1744538400

# Output in a specific format
tsfmt-core --format iso
tsfmt-core "2026-04-13" --format unix
tsfmt-core --format human
```

## Output Formats

| Format    | Example                          |
|-----------|----------------------------------|
| `iso`     | `2026-04-13T10:00:00Z`           |
| `unix`    | `1744538400`                     |
| `human`   | `April 13, 2026 10:00:00 AM UTC` |
| `date`    | `2026-04-13`                     |
| `time`    | `10:00:00`                       |
| `rfc2822` | `Mon, 13 Apr 2026 10:00:00 +0000`|

## Accepted Input Formats

- ISO 8601 (`2026-04-13T10:00:00`, `2026-04-13T10:00:00Z`)
- Unix epoch (`1744538400`)
- `YYYY-MM-DD HH:MM:SS`
- `YYYY-MM-DD`
- `DD/MM/YYYY`
- `MM/DD/YYYY`

## License

MIT
