# Timestamp Sort (Editor Plugin)

A text editor plugin to sort log messages based on their timestamps.  
Supports multiple timestamp formats, including Unix time.
Works under Sublime 4

## Features

- Sorts log entries by timestamp.
- Handles multi-line log messages.
- Preserves non-timestamped lines at the end.
- Supports a variety of timestamp formats.

## Supported Timestamp Formats

- `YYYY-MM-DD HH:mm:ss.SSS` (e.g. `2025-06-06 08:36:46.827`)
- `YYYY-MM-DD HH:mm:ss` (e.g. `2025-06-06 08:36:46`)
- `YYYY/MM/DD HH:mm:ss` (e.g. `2025/06/06 08:36:46`)
- `HH:mm:ss` (defaults to `2000-01-01` date)
- Unix timestamps in:
  - **seconds**: `1717666606`
  - **milliseconds**: `1717666606827`

## Manual Installation

1. Place your plugin `.py` file in:
  Packages/User/timestamp_sort.py

To open this folder from Sublime Text:  
`Preferences > Browse Packages...`

2. Create or update a Command Palette entry in `Packages/User/Default.sublime-commands`:
```json
[
  {
    "caption": "Sort: By Timestamp",
    "command": "timestamp_sort"
  }
]


3. (Optional) Add a main menu entry in Packages/User/Main.sublime-menu:
  
## Usage

  Open a file with log entries.
  
  Use the Command Palette (Cmd+Shift+P / Ctrl+Shift+P) and search for:
  Sort: By Timestamp
  
  Or use the Tools menu if you added a menu item.
  
## Notes
- processes the currently open file
- Assumes timestamps are at the beginning of log entry: 
**Log entries can have multiple lines but the 1st line of each entry (paragraph) has to start with a timestamp.**
- Lines before any detectable timestamp are moved to the end in their original order.
  
## License
MIT