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.

Sanket Parmar

Enable world clocks for the sites with different timezones, with a custom block for the WordPress block editor (Gutenberg).
<h3>Overview</h3>
World clocks are an essential tool for tracking the current time across different time zones around the globe. They are widely used in various contexts, such as international business, travel, and global communication.
Inspiration: <a href="https://www.commoninja.com/widgets/world-clock/wordpress" rel="nofollow ugc">World Clock for WordPress</a>
<h3>Configuration</h3>
There are two blocks available with this plugin:
<ol>
<li>World Clocks – The parent block consists of different clocks.</li>
<li>Single Clock – The single (child) clock block which can be added inside the World Clocks block.</li>
</ol>
<h3>Block: World Clocks (Parent Block)</h3>
<h3>Insert World Clocks Block</h3>
Try to search for World Clocks block while adding a new block to the block editor.
You can find various methods to insert a block into the block editor using this documentation: <a href="https://wordpress.org/documentation/article/adding-a-new-block/" rel="ugc">Adding a new block</a>.
<h3>Select Layout</h3>
Once a block is inserted, it will ask you to select a layout.
There are four layouts:
<ol>
<li>Digital Row – Default : This will show world clocks as digital clocks in rows.</li>
<li>Digital Column : This will show world clocks as digital clocks in columns.</li>
<li>Clock : This will show world clocks as analog clocks in columns with timezone showing below the clock.</li>
<li>Clock Reverse : This will show world clocks as analog clocks in columns with timezone showing above the clock.</li>
</ol>
You can also skip selecting a layout, and it will be set to default layout: Digital Row
You will be able to change the layout from the block settings even after you have selected one or skipped.
<h3>Block Settings</h3>
The World Clocks block has three settings panel:
<ol>
<li>Visibility Settings</li>
<li>Layout</li>
<li>Marks Format</li>
</ol>
<h3>Visibility Settings</h3>
The Visibility Settings panel has different options based on the selected layout.
<ul>
<li>
Clocks per row
<ul>
<li>When the selected layout is Digital Column, Clock or Clock Reverse, this setting will be shown to manage the number of clocks in a single row. You can show up to 4 in a single row. Default is 2.</li>
</ul>
</li>
<li>
Stack on mobile
<ul>
<li>When the selected layout is Digital Column, Clock or Clock Reverse, this setting will be shown to manage the stacking of the clock cloumns. If enabled, the clock columns will be stacked for below 768px device sizes. Default is enabled.</li>
</ul>
</li>
<li>
Show Clocks AmPm Indicator
<ul>
<li>When the selected layout is Clock or Clock Reverse, this setting will be shown. If enabled, it will show AM/PM indicator inside the clock face. Default is enabled.</li>
</ul>
</li>
<li>
Show Digital Time
<ul>
<li>When the selected layout is Clock or Clock Reverse, this setting will be shown. If enabled, it will show digital clock as well right below/above the analog clock depending on the layout. Default is disabled.</li>
</ul>
</li>
<li>
Time Format
<ul>
<li>When the Show Digital Time setting is enabled or the selected layout is Digital Row or Digital Column, this setting will be shown. It allows to show digital time in allowed time formats. Default is h:i:s A, i.e., 01:01:01 AM.</li>
<li>Reference for the <a href="https://wordpress.org/documentation/article/customize-date-and-time-format/" rel="ugc">time format string</a>.</li>
<li>The date format keys (“d”, “j”, “S”, “l”, “D”, “m”, “n”, “F”, “M”, “Y”, “y”, “c”, “r”, “U”) are not allowed in time format.</li>
</ul>
</li>
<li>
Show Date
<ul>
<li>This setting will be shown with all the layouts. If enabled, it will show the date right below/above the analog/digital clock depending on the layout. Default is disabled.</li>
</ul>
</li>
<li>
Date Format
<ul>
<li>When the Show Date setting is enabled, this setting will be shown with all the layouts. It allows to show the date in allowed date formats. Default is Y-m-d, i.e., 2024-01-01.</li>
<li>Reference for the <a href="https://wordpress.org/documentation/article/customize-date-and-time-format/" rel="ugc">date format string</a>.</li>
<li>The time format keys (“a”, “A”, “g”, “h”, “G”, “H”, “i”, “s”, “T”, “c”, “r”, “U”) are not allowed in date format.</li>
</ul>
</li>
</ul>
<h3>Layout</h3>
There are four available layouts to choose from: 
1. Digital Row – Default : This will show world clocks as digital clocks in rows. 
2. Digital Column : This will show world clocks as digital clocks in columns. 
3. Clock : This will show world clocks as analog clocks in columns with timezone showing below the clock. 
4. Clock Reverse : This will show world clocks as analog clocks in columns with timezone showing above the clock.
<h3>Marks Format</h3>
This setting panel will only appear if the selected layout is Clock or Clock Reverse.
There are three available options to choose from: 
1. Number – Default : This will show the marks as numbers in analog clock. 
2. Combine : This will show the marks as combined in analog clock. The numbers – 3, 6, 9 and 12 – will be shown as numbers, and the rset will be show as a line. 
3. Line : This will show the marks as line in analog clock.
<h3>Block: Single Clock (Child Block)</h3>
You can insert Single Clock block as many as you’d like inside the parent World Clocks block.
<h3>Select Timezone</h3>
You can select any timezone from the available list by just clicking on the timezone textbox and start typing. You can remove existing selected timezone and search for more.
A custom timezone selector with autocomplete is created for this. A custom helper method outputs the available timezones, similarly <a href="https://developer.wordpress.org/reference/functions/wp_timezone_choice/" rel="nofollow ugc">wp_timezone_choice()</a>.
<h3>Timezone Label</h3>
You can override the default timezone label with your own.

World Clocks

Enable world clocks for the sites with different timezones, with a custom block for the WordPress block editor (Gutenberg).

Current Date & Time Widget vs World Clocks