- How to convert timestamps to dates in Bash?
- 18 Answers 18
- Epoch & Unix Timestamp Conversion Tools
- Convert epoch to human-readable date and vice versa
- Epoch dates for the start and end of the year/month/day
- Convert seconds to days, hours and minutes
- What is epoch time?
- How to get the current epoch time in .
- Convert from human-readable date to epoch
- Convert from epoch to human-readable date
How to convert timestamps to dates in Bash?
I need a shell command or script that converts a Unix timestamp to a date. The input can come either from the first parameter or from stdin, allowing for the following usage patterns:
18 Answers 18
On systems with GNU Coreutils >= 5.3.0, e.g. Linux you can use:
@mehaase — the man page notes that the date string is too complex to be documented in the manpage, so it is described in info: info ‘(coreutils) date invocation’
info ‘Date input formats’ gets you straight to date ‘s formatting info node, with the pertinent Robert Grudin quote, and then a menu of format specifiers.
And it’s confusing because it’s not working in that way on most linux systems, because: freddy@hades ~ % date —help | grep — -r -r, —reference=FILE display the last modification time of FILE
while the comments on this answer are true, these are not rafa’s fault, and they don’t diminish his answer.
This version is similar to chiborg’s answer, but it eliminates the need for the external tty and cat . It uses date , but could just as easily use gawk . You can change the shebang and replace the double square brackets with single ones and this will also run in sh .
#!/bin/bash LANG=C if [[ -z "$1" ]] then if [[ -p /dev/stdin ]] # input from a pipe then read -r p else echo "No timestamp given." >&2 exit fi else p=$1 fi date -d "@$p" +%c
@Bruno, @ghostdog74: On my system, gawk is (very roughly) 15% faster than date in a timed for loop consisting only of gawk ‘BEGIN < print strftime("%c", 1256571985); >‘ or date -d ‘@1256571985’ +%c with output redirected to /dev/null .
date is marginally (5%) faster than gawk for me (mac osx 10.9.2, date 8.23, gawk 4.1.1), but the real advantage of (g)awk is to accept a pipe of a column of many timestamps (see my answer below), which makes the script e.g. 250x as fast for 1000 timestamps.
Note that my answer meets the OP’s requirements as stated in the question, but the now accepted answer doesn’t.
You can use GNU date, for example,
$ sec=1267619929 $ date -d "UTC 1970-01-01 $sec secs"
On macOS, you can run brew install coreutils and then use the gdate command, e.g. gdate —date @1660859222 which yields Thu Aug 18 14:47:02 PDT 2022 .
You can get formatted date from timestamp like this
I use this cross-platform one-liner:
date -d @1267619929 2>/dev/null || date -r 1267619929
It should work both in macOS and modern versions of popular Linux distributions.
Since Bash 4.2 you can use printf ‘s %(datefmt)T format:
$ printf '%(%c)T\n' 1267619929 Wed 03 Mar 2010 01:38:49 PM CET
That’s nice, because it’s a shell builtin. The format for datefmt is a string accepted by strftime(3) (see man 3 strftime ). Here %c is:
%c The preferred date and time representation for the current locale.
Now if you want a script that accepts an argument and, if none is provided, reads stdin, you can proceed as:
#!/bin/bash if (($#)); then printf '%(%c)T\n' "$@" else while read -r line; do printf '%(%c)T\n' "$line" done fi
You can use this simple awk script:
$ echo '1098181096' | ./a.awk Tue 19 Oct 2004 03:18:16 AM PDT $
This doesn’t fit the first usage — sometimes I don’t want to echo the TS and use a parameter instead.
On some old busybox version, date -s @ doesn’t work, and awk still does! An example without a stdin would be helpful too.
I use this when converting log files or monitoring them:
In OSX, or BSD, there’s an equivalent -r flag which apparently takes a unix timestamp. Here’s an example that runs date four times: once for the first date, to show what it is; one for the conversion to unix timestamp with %s , and finally, one which, with -r , converts what %s provides back to a string.
$ date; date +%s; date -r `date +%s` Tue Oct 24 16:27:42 CDT 2017 1508880462 Tue Oct 24 16:27:42 CDT 2017
At least, seems to work on my machine.
$ uname -a Darwin XXX-XXXXXXXX 16.7.0 Darwin Kernel Version 16.7.0: Thu Jun 15 17:36:27 PDT 2017; root:xnu-3789.70.16~2/RELEASE_X86_64 x86_64
Epoch & Unix Timestamp Conversion Tools
Convert epoch to human-readable date and vice versa
Also see our dynamic list of dates (1 day ago, next week, etc.)
Press c to clear all forms.
Epoch dates for the start and end of the year/month/day
Convert seconds to days, hours and minutes
What is epoch time?
The Unix epoch (or Unix time or POSIX time or Unix timestamp) is the number of seconds that have elapsed since January 1, 1970 (midnight UTC/GMT), not counting leap seconds (in ISO 8601: 1970-01-01T00:00:00Z). Literally speaking the epoch is Unix time 0 (midnight 1/1/1970), but ‘epoch’ is often used as a synonym for Unix time. Some systems store epoch dates as a signed 32-bit integer, which might cause problems on January 19, 2038 (known as the Year 2038 problem or Y2038). The converter on this page converts timestamps in seconds (10-digit), milliseconds (13-digit) and microseconds (16-digit) to readable dates.
Human-readable time | Seconds |
---|---|
1 hour | 3600 seconds |
1 day | 86400 seconds |
1 week | 604800 seconds |
1 month (30.44 days) | 2629743 seconds |
1 year (365.24 days) | 31556926 seconds |
How to get the current epoch time in .
PHP | time() More PHP |
Python | import time; time.time() Source |
Ruby | Time.now (or Time.new ). To display the epoch: Time.now.to_i |
Perl | time More Perl |
Java | long epoch = System.currentTimeMillis()/1000; Returns epoch in seconds. |
C# | DateTimeOffset.Now.ToUnixTimeSeconds() (.NET Framework 4.6+/.NET Core), older versions: var epoch = (DateTime.UtcNow — new DateTime(1970, 1, 1, 0, 0, 0, DateTimeKind.Utc)).TotalSeconds; |
Objective-C | [[NSDate date] timeIntervalSince1970]; (returns double) or NSString *currentTimestamp = [NSString stringWithFormat:@»%f», [[NSDate date] timeIntervalSince1970]]; |
C++11 | double now = std::chrono::duration_cast(std::chrono::system_clock::now().time_since_epoch()).count(); |
Lua | epoch = os.time([date]) |
VBScript/ASP | See the examples |
AutoIT | _DateDiff(‘s’, «1970/01/01 00:00:00», _NowCalc()) |
Delphi | Epoch := DateTimetoUnix(Now); Tested in Delphi 2010. |
R | as.numeric(Sys.time()) |
Erlang/OTP | erlang:system_time(seconds). (version 18+), older versions: calendar:datetime_to_gregorian_seconds(calendar:universal_time())-719528*24*3600. |
MySQL | SELECT unix_timestamp(now()) More MySQL examples |
PostgreSQL | SELECT extract(epoch FROM now()); |
SQLite | SELECT strftime(‘%s’, ‘now’); |
Oracle PL/SQL | SELECT (CAST(SYS_EXTRACT_UTC(SYSTIMESTAMP) AS DATE) — TO_DATE(’01/01/1970′,’DD/MM/YYYY’)) * 24 * 60 * 60 FROM DUAL; |
SQL Server | SELECT DATEDIFF(s, ‘1970-01-01 00:00:00’, GETUTCDATE()) |
IBM Informix | SELECT dbinfo(‘utc_current’) FROM sysmaster:sysdual; |
JavaScript | Math.floor(new Date().getTime()/1000.0) The getTime method returns the time in milliseconds. |
Visual FoxPro | DATETIME() — Warning: time zones not handled correctly |
Go | time.Now().Unix() More Go |
Adobe ColdFusion | |
Tcl/Tk | clock seconds |
Unix/Linux Shell | date +%s |
Solaris | /usr/bin/nawk ‘BEGIN ‘ Solaris doesn’t support date +%s, but the default seed value for nawk’s random-number generator is the number of seconds since the epoch. |
PowerShell | [int][double]::Parse((Get-Date (get-date).touniversaltime() -UFormat %s)) |
Other OS’s | Command line: perl -e «print time» (If Perl is installed on your system) |
Convert from human-readable date to epoch
PHP | strtotime(«15 November 2018») (converts most English date texts) or: date_create(’11/15/2018′)->format(‘U’) (using DateTime class) More PHP |
Python | import calendar, time; calendar.timegm(time.strptime(‘2000-01-01 12:34:00’, ‘%Y-%m-%d %H:%M:%S’)) |
Ruby | Time.local(year, month, day, hour, minute, second, usec ) (or Time.gm for GMT/UTC input). To display add .to_i |
Perl | Use the Perl Epoch routines |
Java | long epoch = new java.text.SimpleDateFormat(«MM/dd/yyyy HH:mm:ss»).parse(«01/01/1970 01:00:00»).getTime() / 1000; Timestamp in seconds, remove ‘/1000’ for milliseconds. |
VBScript/ASP | DateDiff(«s», «01/01/1970 00:00:00», time field) More ASP |
AutoIT | _DateDiff(‘s’, «1970/01/01 00:00:00», «YYYY/MM/DD HH:MM:SS») |
Delphi | Epoch := DateTimeToUnix(StrToDateTime(myString)); |
C | Use the C Epoch Converter routines |
R | as.numeric(as.POSIXct(«YYYY-MM-dd HH:mm:ss», tz = «GMT», origin=»1970-01-01″)) The origin parameter is optional |
Go | Example code |
Rust | SystemTime::now().duration_since(SystemTime::UNIX_EPOCH) |
Adobe ColdFusion | int(parseDateTime(datetime).getTime()/1000); |
MySQL | SELECT unix_timestamp(time) Time format: YYYY-MM-DD HH:MM:SS or YYMMDD or YYYYMMDD More on using Epoch timestamps with MySQL |
PostgreSQL | SELECT extract(epoch FROM date(‘2000-01-01 12:34’)); With timestamp: SELECT EXTRACT(EPOCH FROM TIMESTAMP WITH TIME ZONE ‘2018-02-16 20:38:40-08’); With interval: SELECT EXTRACT(EPOCH FROM INTERVAL ‘5 days 3 hours’); |
SQLite | SELECT strftime(‘%s’,timestring); |
SQL Server | SELECT DATEDIFF(s, ‘1970-01-01 00:00:00’, time field) |
JavaScript | Use the JavaScript Date object |
Unix/Linux Shell | date +%s -d»Jan 1, 1980 00:00:01″ Replace ‘-d’ with ‘-ud’ to input in GMT/UTC time. |
Convert from epoch to human-readable date
PHP | date(output format, epoch); Output format example: ‘r’ = RFC 2822 date, more PHP examples |
Python | import time; time.strftime(«%a, %d %b %Y %H:%M:%S +0000», time.localtime(epoch)) Replace time.localtime with time.gmtime for GMT time. Or using datetime: import datetime; datetime.datetime.utcfromtimestamp(epoch).replace(tzinfo=datetime.timezone.utc) |
Ruby | Time.at(epoch) |
C# | private string epoch2string(int epoch) return new DateTime(1970, 1, 1, 0, 0, 0, DateTimeKind.Utc).AddSeconds(epoch).ToShortDateString(); > |
Perl | Use the Perl Epoch routines |
Java | String date = new java.text.SimpleDateFormat(«MM/dd/yyyy HH:mm:ss»).format(new java.util.Date (epoch*1000)); Epoch in seconds, remove ‘*1000’ for milliseconds. |
Lua | datestring = os.date([format[,epoch]]) |
VBScript/ASP | DateAdd(«s», epoch, «01/01/1970 00:00:00») More ASP |
AutoIT | _DateAdd(«s», $EpochSeconds , «1970/01/01 00:00:00») |
Delphi | myString := DateTimeToStr(UnixToDateTime(Epoch)); Where Epoch is a signed integer. |
C | Use the C Epoch Converter routines |
Objective-C | NSDate * myDate = [NSDate dateWithTimeIntervalSince1970:epoch]; NSLog(@»%@», date); |
R | as.POSIXct(epoch, origin=»1970-01-01″, tz=»GMT») |
Go | Example code |
Adobe ColdFusion | DateAdd(«s»,epoch,»1/1/1970″); |
MySQL | FROM_UNIXTIME(epoch, optional output format) Default output format is YYY-MM-DD HH:MM:SS. If you need support for negative timestamps: DATE_FORMAT(DATE_ADD(FROM_UNIXTIME(0), interval -315619200 second),»%Y-%m-%d») (replace -315619200 with epoch) More MySQL |
PostgreSQL | PostgreSQL version 8.1 and higher: SELECT to_timestamp(epoch); Source Older versions: SELECT TIMESTAMP WITH TIME ZONE ‘epoch’ + epoch * INTERVAL ‘1 second’; |
SQLite | SELECT datetime(epoch_to_convert, ‘unixepoch’); or local timezone: SELECT datetime(epoch_to_convert, ‘unixepoch’, ‘localtime’); |
Oracle PL/SQL | SELECT to_date(’01-JAN-1970′,’dd-mon-yyyy’)+(1526357743/60/60/24) from dual Replace 1526357743 with epoch. |
SQL Server | DATEADD(s, epoch, ‘1970-01-01 00:00:00’) |
IBM Informix | SELECT dbinfo(‘utc_to_datetime’,epoch) FROM sysmaster:sysdual; |
Microsoft Excel / LibreOffice Calc | =(A1 / 86400) + 25569 Format the result cell for date/time, the result will be in GMT time (A1 is the cell with the epoch number). For other time zones: =((A1 +/- time zone adjustment) / 86400) + 25569. |
Crystal Reports | DateAdd(«s», -14400, #1/1/1970 00:00:00#) -14400 used for Eastern Standard Time. See Time Zones. |
JavaScript | Use the JavaScript Date object |
Tcl/Tk | clock format 1325376000 Documentation |
MATLAB | datestr(719529+TimeInSeconds/86400,’dd-mmm-yyyy HH:MM:SS’) |
IBM PureData System for Analytics | select 996673954::int4::abstime::timestamp; |
Unix/Linux Shell | date -d @1520000000 Replace 1520000000 with your epoch, needs recent version of ‘date’. Replace ‘-d’ with ‘-ud’ for GMT/UTC time. |
Mac OS X | date -j -r 1520000000 |
PowerShell | Function get-epochDate ($epochDate) < [timezone]::CurrentTimeZone.ToLocalTime(([datetime]'1/1/1970').AddSeconds($epochDate)) >, then use: get-epochDate 1520000000 . Works for Windows PowerShell v1 and v2 |
Other OS’s | Command line: perl -e «print scalar(localtime(epoch))» (If Perl is installed) Replace ‘localtime’ with ‘gmtime’ for GMT/UTC time. |
Thanks to everyone who sent me corrections and updates!
Please note: All tools on this page are based on the date & time settings of your computer and use JavaScript to convert times. Some browsers use the current DST (Daylight Saving Time) rules for all dates in history. JavaScript does not support leap seconds.