Convert Epoch To Date

Installation

Install Sublime Text Package Control. Ignore if installed already
Tools > Command Palette > Input/select Package Control: Install Package
Enter ConvertEpochToDate

Documentation

Sublime Text package to convert Epoch timestamps to human date.

This package converts Epoch timestamp to human date in your local time zone. It works on the selection or the word under caret (not mouse pointer). The replacement is done in-place & can be undone using Undo (ctrl+z) command. In-place replacement can be disabled if desired (refer Customization section below).

If the view/file is readonly or in-place replacement can't be made then only the status bar message is shown. A message box is displayed in this case which can be disabled.

10-13 digits are expected as Epoch timestamp. Anything else is ignored.

Default output date format is %a %d %b %Y %I:%M:%S %p + XXXms e.g. Tue 01 Jan 2019 01:02:34 AM + 123ms. It can be customized to the format you want (refer Customization section below).

Any output/messages/errors are always displayed in Status bar.

How to use

There are 4 ways you can invoke the command:

Tools > "Convert Epoch to Date"
Context menu (Right click) > "Convert Epoch to Date"
Command Palette (Ctrl + Shift + P on Windows or Cmd + Shift + P on Mac) > Input "Convert Epoch To Date"
Use following keyboard shortcuts:
- ctrl+alt+, (Windows)
- super+alt+, (macOS/OSX)
- ctrl+alt+, (Linux)

You can also override the default binding in your User Key Binding file e.g.

{ "keys": ["ctrl+alt+t"], "command": "convert_epoch_to_date" }

Customization

Following parameters can be overridden in User Settings file (Preferences > Package Settings > ConvertEpochToDate > Settings - User) to the value desired:

{
    // in-place replacement to date
    "in_place_replacement": true,

    // defines custom output date format. visit strftime.org for possible format directives
    "output_date_format": "%a %d %b %Y %I:%M:%S %p",

    // if set to true, appends milliseconds at the end of output date
    "show_milliseconds": true,

    // shows message box for output date
    "show_message_box": false,

    // shows message box only for readonly views. not used if show_message_box set to true
    "show_message_box_for_readonly": true
}

License

GNU General Public License v3.0

Issues

Please report any bugs/issues here

nexional / ConvertEpochToDate