TK Timestamp to Human Readable Date

Given a timestamp (assumed in UTC), convert to a human-readable date format using PHP named time zones.

Author:TourKick LLC (Clifford P) (profile at wordpress.org)
WordPress version required:4.5
WordPress version tested:5.3.8
Plugin version:1.0.1
Added to WordPress repository:22-01-2020
Last updated:22-01-2020
Warning! This plugin has not been updated in over 2 years. It may no longer be maintained or supported and may have compatibility issues when used with more recent versions of WordPress.
Rating, %:0
Rated by:0
Plugin URI:https://github.com/cliffordp/tk-timestamp-to-...
Total downloads:567
Active installs:10+
plugin download
Click to start download

All Available Shortcode Arguments

'timestamp'  => '', // or use the 'post_id' and 'field_timestamp' arguments
'format'     => 'c', // see https://www.php.net/manual/en/function.date.php
'time_zone'  => '', // defaults to WP's General Settings time zone (if valid PHP time zone), else UTC. Only supports a PHP named time zone -- see https://www.php.net/manual/en/timezones.php
'field_name' => '', // the raw name (including the `wpcf-` prefix if a Types field) or a custom field that should have a UTC timestamp as its value
'post_id'    => '', // applicable if using the 'field_timestamp' argument - defaults to current post if empty

Shortcode Examples

1)
Shortcode: [tk_timestamp_human timestamp="1608299220"]

(Assuming your WordPress General Settings time zone is set to ‘Europe/Amsterdam’)
Expected Result: 2020-12-18T14:47:00+01:00

2)
Shortcode: [tk_timestamp_human timestamp="1608299220" time_zone="America/Chicago"]

Expected Result: 2020-12-18T07:47:00-06:00

3)
Shortcode: [tk_timestamp_human timestamp="1608299220" time_zone="UTC"]

Expected Result: 2020-12-18T13:47:00+00:00

4)
Shortcode: [tk_timestamp_human timestamp="1608299220" time_zone="America/Chicago" format="j F, Y"]

Expected Result: 18 December, 2020

Global Function

The tk_timestamp_to_human_wp_all_export() global function is available as a wrapper for the shortcode, using all its defaults except requiring the Timestamp argument and optionally passing the Format and Time Zone parameters.

This can be handy for using with WP All Export (http://www.wpallimport.com/tour/export-developer-friendly/), such as to export a custom field that’s a UTC timestamp value to a human-readable format, such as if the system you’re moving the data to requires a specific format.


Screenshots
ChangeLog