STAMPER The simple as it gets timestamp converter

How often do you go to the web to type in unix time to date converter or something like that?

Not very often? It's just me? Eh

Well if you do a lot, it's a real pain. I'm just trying to convert a number to my local date and UTC. I don't want 2 megabytes of Javascript fired at my face.

Trying to find a solution in the terminal is a nuisance too. Use date with some formatting specifiers and it'll output a date. But was that in your timezone or UTC? Was it %S or %n again? What if I want to do seconds instead of millis?

Then if you're working on macOS you can throw that all out the window. Crossplatform solutions usually involve invoking Python and writing a one line script to do it for you. Slow to type, and a pain to modify, this is not a solution.

I don't even know about Windows. I don't care much about it either.

What's the solution?

I wrote stamper just for this purpose. I work with timestamps more than I care to admit sometimes. I just want a date from time. Don't make me work for it.

Looking at the timestamps I get, half the time I don't know if it's in nanoseconds, milliseconds, or seconds. Yet again though, why should I have to know? Too much work, just figure it out for me.

And so stamper does that.

Check it out:

$ stamper 1581472087907000000
Wed, 12 Feb 2020 01:48:07 +0000
Tue, 11 Feb 2020 20:48:07 -0500

Is it in Nanoseconds? Milliseconds? Seconds? Do I care? No. But stamper does, and gives me the right date anyway.

If you don't trust the algorithm though, you can force a unit:

$ stamper -s 1581472087907
Wed, 08 Nov 52084 02:11:47 +0000
Tue, 07 Nov 52084 21:11:47 -0500

Congrats, it's 52084 now. Is this really what you wanted?

If you give it crazy input or bad flags, stamper will freak out. This is your problem though. It only works about 50000 years in the future. Make it work.

Stamper supports all sorts of units:

$ stamper -h
stamper 0.0.1
Darrien Glasser <me@darrien.dev>
Converts unix seconds to dates

USAGE:
    stamper [FLAGS] <STAMP>

FLAGS:
    -m, --millis     Assume input is in milliseconds
    -n, --nanos      Assume input is in nanoseconds
    -s, --seconds    Assume input is in seconds
    -h, --help       Prints help information
    -V, --version    Prints version information

ARGS:
    <STAMP>    Timestamp to get the date value of

To download, check out the releases page, or run cargo install stamper