Chris Jean

This is a fairly simple plugin used to display the date and time in any widget-enabled location.
There were two goals for this plugin:
<ul>
<li>Provide a means to have the date and time produced match a specific timezone.</li>
<li>Enable complete customization over how the date and time is formatted.</li>
</ul>
I think that I’ve done a fairly good job of meeting those goals. Admittedly, setting either field is fairly user-unfriendly. The timezone specified must match <a href="http://us3.php.net/timezones" rel="nofollow ugc">PHP’s List of Supported Timezones</a>. The date and time format has the same requirements as the format parameter of <a href="http://us.php.net/date" rel="nofollow ugc">PHP’s date() function</a> (for obvious reasons since the defined format is actually passed directly to the date function in the code 🙂 ).
If this plugin gets enough attention and use, I’ll find ways of easing the use. I think a series of drop-downs would make selecting the options easier, so that would be the option used if people are interested. If you happen to be one of those interested people, please send me a message on our <a href="http://realthemes.com/contact-us/" rel="nofollow ugc">contact page</a>.
<h3>Version History</h3>
<ul>
<li>1.0.1 – 2008-06-04 – Basic proof of concept</li>
<li>1.0.2 – 2008-06-12 – Contained plugin code inside a class to prevent namespace collisions. Standardized code with coding style (http://comox.textdrive.com/pipermail/wp-hackers/2006-July/006930.html)</li>
<li>1.0.3 – 2008-07-01 – Added support for PHP 4</li>
</ul>

Current Date & Time Widget

Provides a widget that shows the current date and time given a specified timezone and format.

JB Christy

This WordPress plugin adds the <code>[localize_time]</code> shortcode. The shortcode allows an author 
to enter a date and time in any timezone. The shortcode displays the original time with 
timezone, followed by the same time in the user’s timezone, formatted correctly for the 
user’s locale. This is useful for announcing live events, e.g. a live online streaming 
event, to widely dispersed audiences.
The date and time to be displayed are entered as the shortcode’s content, i.e. between the 
<code>[localize_time]</code> and <code>[/localize_time]</code> tags. The time can be specified in almost 
any format that’s recognizable as a date and time.
The shortcode takes the following options:
<ul>
<li><code>tz</code> – the timezone the shortcode’s content is in. If this option is omitted, it defaults 
to the site’s timezone. Timezones are specified in any format recognized by 
<a href="http://www.php.net/manual/en/timezones.php" rel="nofollow ugc">PHP’s DateTimeZone</a>.</li>
<li><code>fmt</code> – a format string specifying how the original time should be displayed. If omitted, 
it defaults to the site’s date format followed by the site’s time format followed by the 
timezone. To output the original time exactly as entered (with the timezone), specify 
<code>fmt="orig"</code>. Or you can enter a format string using the same codes that are used on 
WordPress’s General Settings tab. See 
<a href="https://codex.wordpress.org/Formatting_Date_and_Time" rel="nofollow ugc">full documentation on date / time format strings here</a>.</li>
<li><code>before_local</code> – the string to precede the local time. Defaults to ‘ (‘</li>
<li><code>after_local</code> – the string to follow the local time. Defaults to ‘)’</li>
</ul>
<h3>Examples</h3>
Below are examples of using the shortcode. For these examples, the site’s timezone is set to America/New_York (EST-5EDT) and the user is in the America/Los_Angeles (PST-8PDT) timezone.
<ul>
<li>
Local time is in a different year and month from original time: 
 [localize_time]1/1/2014 1:00 am[/localize_time] 
outputs: 
January 1, 2014 1:00 am EST (12/31/2013, 10:00:00 PM PST)
</li>
<li>
Specify a time in timezone different from the site’s: 
 [localize_time tz=”Europe/Paris” ]July 14, 2014 19:00[/localize_time] 
outputs: 
July 14, 2014 7:00 pm CEST (7/14/2014, 10:00:00 AM PDT)
</li>
<li>
Specify a format for the original time: 
 [localize_time fmt=”m/d/Y g:i A T”]June 14, 2014 6:30 AM[/localize_time] 
outputs: 
06/14/2014 6:30 AM EDT (6/14/2014, 3:30:00 AM PDT)
</li>
<li>
Specify a time in the same timezone as the user: 
 [localize_time tz=”PST”]3pm Nov. 1, 2014[/localize_time] 
outputs: 
November 1, 2014 3:00 pm PDT
</li>
</ul>
Note that the display of the local time varies by timezone and browser.

Localize Time

Provides a [localize_time] shortcode, which displays times in the user's local timezone.

Current Date & Time Widget vs Localize Time