Theerawat Patthawee

<p>Intl DateTime Calendar transforms how dates and times are displayed on your WordPress site by leveraging the ECMAScript Internationalization API (Intl). This plugin allows you to switch between different calendar systems like Buddhist, Islamic, Hebrew, and more, without affecting your database or SEO.</p>
<h4>Key Features</h4>
<ul>
<li><strong>Multiple Calendar Systems</strong> – Support for Gregorian, Buddhist, Chinese, Hebrew, Islamic, Japanese, Persian and more</li>
<li><strong>WordPress Integration</strong> – Automatically uses your WordPress date/time format and locale settings</li>
<li><strong>Block Editor Compatible</strong> – Works with all WordPress core blocks, including custom date formats</li>
<li><strong>SEO Friendly</strong> – Maintains proper HTML datetime attributes for search engines</li>
<li><strong>Multilingual Support</strong> – Works with any locale WordPress supports</li>
<li><strong>Site Performance</strong> – Client-side formatting with minimal impact on page load time</li>
<li><strong>Thai Language Support</strong> – Special handling for Thai date formats including Buddhist calendar years</li>
</ul>
<h4>Supported Calendar Systems</h4>
<ul>
<li>Gregorian (Western)</li>
<li>Buddhist</li>
<li>Chinese</li>
<li>Coptic</li>
<li>Dangi (Korean)</li>
<li>Ethiopic</li>
<li>Ethiopic (Amete Alem)</li>
<li>Hebrew</li>
<li>Indian</li>
<li>Islamic</li>
<li>Islamic (Civil)</li>
<li>Islamic (Saudi Arabia)</li>
<li>Islamic (Tabular)</li>
<li>Islamic (Umm al-Qura)</li>
<li>ISO 8601</li>
<li>Japanese</li>
<li>Persian</li>
<li>Republic of China</li>
</ul>
<h4>Use Cases</h4>
<ul>
<li>Buddhist websites in Thailand that need Buddhist Era years (BE)</li>
<li>Islamic websites that need Hijri calendar dates</li>
<li>Multilingual websites that want dates in native calendar systems</li>
<li>Any website that needs specialized date formatting without affecting SEO</li>
</ul>
<h3>Additional Information</h3>
<h4>Technical Details</h4>
<p>This plugin uses the ECMAScript Internationalization API (Intl) for client-side date formatting. The Intl API provides robust support for various calendar systems and locales. For older browsers that may not fully support all features, the plugin includes fallback formatting options.</p>
<h4>Browser Compatibility</h4>
<p>Modern browsers (last 2-3 years) fully support the plugin’s functionality. For older browsers, basic date formatting will still work, but some advanced calendar systems might fall back to Gregorian.</p>
<h4>Privacy</h4>
<p>This plugin does not collect or share any personal data, and all date formatting is done client-side in the user’s browser.</p>


Intl DateTime Calendar

Display dates and times in various calendar systems (Buddhist, Islamic, etc.) while respecting WordPress settings and maintaining SEO friendliness.

Scott Reilly

<p>This plugin adds a dynamic, functional clock to the admin bar (at top of all admin pages) to show the server time for the blog. The clock automatically updates as time passes, as you would expect of a digital clock.</p>
<p>This plugin also supports a static mode which puts a timestamp string at the top of all admin pages instead of the dynamic clock. This static admin time widget can be clicked to update the time in-place (without a page reload) to show the new current server time.</p>
<p>Also provided is a “Blog Time” widget providing the same functionality as the admin widget, but for your sidebars. You may also utilize the plugin’s functionality directly within a theme template via use of the template tag <code>c2c_blog_time()</code>.</p>
<p>NOTE: For the front-end widget, if the “Use dynamic clock?” configuration option is unchecked, this plugin generates a timestamp and NOT a clock. The time being displayed is the time of the page load, or if clicked, the time when the widget last retrieved the time. It won’t actively increment time on the display. By default the widget displays a dynamic clock that does increment time.</p>
<p>This is most useful to see the server/blog time to judge when a time sensitive post, comment, or action would be dated by the blog (i.e. such as monitoring for when to close comments on a contest post, or just accounting for the server being hosted in a different timezone). Or, when used statically as a timestamp and not a clock, it can indicate/preserve when the page was loaded.</p>
<p>Thanks to <a href="https://momentjs.com/" rel="nofollow ugc">Moment.js</a> for the JavaScript date handling library.</p>
<p>Links: <a href="https://coffee2code.com/wp-plugins/blog-time/" rel="nofollow ugc">Plugin Homepage</a> | <a href="https://wordpress.org/plugins/blog-time/" rel="ugc">Plugin Directory Page</a> | <a href="https://github.com/coffee2code/blog-time/" rel="nofollow ugc">GitHub</a> | <a href="https://coffee2code.com" rel="nofollow ugc">Author Homepage</a></p>
<h3>Template Tags</h3>
<p>The plugin provides one template tag for use in your theme templates, functions.php, or plugins.</p>
<h4>Functions</h4>
<ul>
<li><code><?php function c2c_blog_time( $time_format = '', $echo = true ) ?></code><br />
Returns and/or displays the formatted time for the site.</li>
</ul>
<h4>Arguments</h4>
<ul>
<li>
<p><code>$time_format</code> (string)<br />
Optional. PHP-style time format string. See https://www.php.net/manual/en/datetime.format.php for more info. Default is ” (which, unless otherwise modified, uses the default time forat: ‘g:i A’).</p>
</li>
<li>
<p><code>$echo</code> (bool)<br />
Optional. Echo the template info? Default is true.</p>
</li>
</ul>
<h4>Examples</h4>
<ul>
<li>
<p><code><?php // Output the site's current time.<br />
c2c_blog_time();<br />
?></code></p>
</li>
<li>
<p><code><?php // Retrieve the value for use in code, so don't display/echo it.<br />
$site_date = c2c_blog_time( 'M d, Y', false );<br />
?></code></p>
</li>
</ul>
<h3>Hooks</h3>
<p>The plugin exposes four filters for hooking. Code using these filters should ideally be put into a mu-plugin or site-specific plugin (which is beyond the scope of this readme to explain). Less ideally, you could put them in your active theme’s functions.php file.</p>
<p><strong>c2c_blog_time (filter)</strong></p>
<p>The <code>'c2c_blog_time'</code> hook allows you to use an alternative approach to safely invoke <code>c2c_blog_time()</code> in such a way that if the plugin were deactivated or deleted, then your calls to the function won’t cause errors in your site.</p>
<p>Arguments:</p>
<ul>
<li>same as for <code>c2c_blog_time()</code></li>
</ul>
<p>Example:</p>
<p>Instead of:</p>
<pre><code><?php c2c_blog_time(); ?>
</code></pre>
<p>Do:</p>
<pre><code><?php echo apply_filters( 'c2c_blog_time', '' ); ?>
</code></pre>
<p><strong>c2c_blog_time_format (filter)</strong></p>
<p>The <code>'c2c_blog_time_format'</code> hook allows you to customize the default format for the blog time. By default this is ‘g:i A’ (though this may be different if modified by localization).</p>
<p>Arguments:</p>
<ul>
<li>$format (string): The default format for the blog time.</li>
</ul>
<p>Example:</p>
<pre><code>/**
 * Change the default blog time string
 *
 * @param string $format The default time format.
 * @return string
 */
function change_blog_time_format( $format ) {
    return 'b, g:i A';
}
add_filter( 'c2c_blog_time_format', 'change_blog_time_format' );
</code></pre>
<p><strong>c2c_blog_time_toolbar_widget_for_user (filter)</strong></p>
<p>The <code>c2c_blog_time_toolbar_widget_for_user</code> hook allows you to control if the admin toolbar clock widget should be shown, on a per-user basis. By default the admin toolbar clock is shown to everyone who can see the admin toolbar.</p>
<p>Arguments:</p>
<ul>
<li>$shown (boolean): Whether the admin toolbar clock widget should be shown. Default of true.</li>
</ul>
<p>Example:</p>
<pre><code>/**
 * Only show the admin toolbar clock for the 'boss' user.
 *
 * @param $show bool Status of whether the admin toolbar clock should be shown.
 * @return bool
 */
function restrict_blog_time_widget_appearance( $show ) {
    return 'boss' === get_current_user()->user_login;
}
add_filter( 'c2c_blog_time_toolbar_widget_for_user', 'restrict_blog_time_widget_appearance' );
</code></pre>
<p><strong>c2c_blog_time_active_clock (filter)</strong></p>
<p>The <code>'c2c_blog_time_active_clock'</code> hook returns the boolean value indicating if the Javascript-powered dynamic clock introduced in v2.0 should be enabled or if instead the v1.x era behavior of a static timestamp that can be clicked to update the timestamp via AJAX should be enabled. By default the dynamic clock is enabled.</p>
<p>Arguments:</p>
<ul>
<li>$allow (boolean): Boolean indicating if the admin widget should be a dynamic clock. Default is true.</li>
</ul>
<p>Example:</p>
<pre><code>// Disable the dynamic clock and use the static timestamp (whcih can be clicked to update the time via AJAX) instead.
add_filter( 'c2c_blog_time_active_clock', '__return_false' );
</code></pre>


Blog Time

Display the time according to your blog via an admin toolbar widget, a sidebar widget, and/or a template tag.

Intl DateTime Calendar vs Blog Time