This WordPress plugin adds the
[localize_time] 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
[/localize_time] tags. The time can be specified in almost
any format that’s recognizable as a date and time.
The shortcode takes the following options:
tz– 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
fmt– 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
fmt="orig". Or you can enter a format string using the same codes that are used on
WordPress’s General Settings tab. See
full documentation on date / time format strings here.
before_local– the string to precede the local time. Defaults to ‘ (‘
after_local– the string to follow the local time. Defaults to ‘)’
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.
Local time is in a different year and month from original time:
[localize_time]1/1/2014 1:00 am[/localize_time]
January 1, 2014 1:00 am EST (12/31/2013, 10:00:00 PM PST)
Specify a time in timezone different from the site’s:
[localize_time tz=”Europe/Paris” ]July 14, 2014 19:00[/localize_time]
July 14, 2014 7:00 pm CEST (7/14/2014, 10:00:00 AM PDT)
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]
06/14/2014 6:30 AM EDT (6/14/2014, 3:30:00 AM PDT)
Specify a time in the same timezone as the user:
[localize_time tz=”PST”]3pm Nov. 1, 2014[/localize_time]
November 1, 2014 3:00 pm PDT
Note that the display of the local time varies by timezone and browser.
- Upload the
localize-timedirectory to the
- Activate the plugin through the ‘Plugins’ menu in WordPress
- Can I change the way the local time is formatted?
No. The local time is displayed by the user’s browser in a format appropriate for her locale.
You can not change the format.
- What if the user is in the same timezone as the original time?
If the user is in the same timezone as the original time, she will see only the original time;
the local time will not be displayed, as it would be repetitious. See the last example above.
- Can I style the times?
Yes. In your theme’s CSS target
.localize_time_origto style the original times
.localize_time_localto style the local times.
Contributors & Developers
“Localize Time” is open source software. The following people have contributed to this plugin.Contributors
Translate “Localize Time” into your language.
Interested in development?
Browse the code, check out the SVN repository, or subscribe to the development log by RSS.
- Initial release