{"id":1896585,"date":"2019-10-18T13:19:32","date_gmt":"2019-10-18T17:19:32","guid":{"rendered":"https:\/\/staging.theeventscalendar.com\/knowledgebase\/working-with-time-zones\/"},"modified":"2024-11-23T05:05:57","modified_gmt":"2024-11-23T10:05:57","slug":"working-with-time-zones","status":"publish","type":"post","link":"https:\/\/staging.theeventscalendar.com\/knowledgebase\/working-with-time-zones\/","title":{"rendered":"Working With Timezones"},"content":{"rendered":"\n<p>The Events Calendar provides simple but robust timezone capabilities, allowing you to have events in many different timezones. Use this article to get familiar with all of the controls available to you, and to learn what kinds of output to expect from certain timezone configurations.<\/p>\n\n\n\n<h3 class=\"wp-block-heading\" id=\"types-of-time-zones\">Two types of timezones<\/h3>\n\n\n\n<p>There are two primary types of time zone in WordPress: locations (a.k.a. &#8220;named timezones&#8221;), and UTC offsets.<\/p>\n\n\n\n<ul class=\"wp-block-list\">\n<li><strong>Location timezones<\/strong> are usually in the format of <code>{Region}\/{City}<\/code>, like <code>America\/New_York<\/code>, or <code>Europe\/Zurich<\/code>. These are often the recommended time zones to use, as <span style=\"text-decoration: underline;\">they accommodate daylight saving time<\/span>.<\/li>\n\n\n\n<li><strong>UTC offsets<\/strong>, meanwhile, are usually in the format of <code>UTC\u00b1X, like <code>UTC-5<\/code> or <code>UTC+4:30<\/code>. <span style=\"text-decoration: underline;\">UTC offsets do not accommodate daylight saving time.<\/span><\/code><\/li>\n<\/ul>\n\n\n\n<p>Location timezones are <em>contextual<\/em>, and say, &#8220;this is the time in this location.&#8221;<\/p>\n\n\n\n<p>UTC offsets are <em>absolute<\/em>, meanwhile, and simply add or subtract hours from <a href=\"https:\/\/en.wikipedia.org\/wiki\/Coordinated_Universal_Time\" target=\"_blank\" rel=\"noopener noreferrer\">Coordinated Universal Time<\/a>; no matter where the event is taking place, or whether daylight saving time is in effect, a timezone of <code>UTC-5<\/code> simply says, &#8220;get the UTC value and subtract five hours from it.&#8221;<\/p>\n\n\n\n<p><strong>In order for The Events Calendar to work properly, you must use a location-based timezone and avoid using UTC offsets.<\/strong> Using UTC offsets <a href=\"https:\/\/staging.theeventscalendar.com\/knowledgebase\/k\/how-daylight-saving-time-affects-events\/\">can cause problems<\/a> with Daylight Saving Time, event imports, and event data handling.<\/p>\n\n\n\n<p>If you don&#8217;t see your specific city in the dropdown list, just choose a different city in the same time zone and you&#8217;re set.<\/p>\n\n\n\n<h3 class=\"wp-block-heading\" id=\"time-zone-mode\">Choosing a timezone mode<\/h3>\n\n\n\n<p>If you go to Events \u2192 Settings \u2192 Display in your wp-admin and scroll down to the Date Format Settings section, you&#8217;ll see that there are two settings for the Time Zone Mode option: &#8220;use site-wide time zone everywhere&#8221;, and &#8220;use manual time zones for each event&#8221;.<\/p>\n\n\n\n<p>The Time Zone Mode tells The Events Calendar what time zone to display the event times in.<\/p>\n\n\n\n<figure class=\"wp-block-image size-full\"><img loading=\"lazy\" decoding=\"async\" width=\"1594\" height=\"288\" src=\"https:\/\/images.theeventscalendar.com\/kb\/uploads\/2022\/11\/Screen-Shot-2022-11-29-at-3.14.48-PM.png\" alt=\"\" class=\"wp-image-1954613\" srcset=\"https:\/\/images.theeventscalendar.com\/kb\/uploads\/2022\/11\/Screen-Shot-2022-11-29-at-3.14.48-PM.png 1594w, https:\/\/images.theeventscalendar.com\/kb\/uploads\/2022\/11\/Screen-Shot-2022-11-29-at-3.14.48-PM-300x54.png 300w, https:\/\/images.theeventscalendar.com\/kb\/uploads\/2022\/11\/Screen-Shot-2022-11-29-at-3.14.48-PM-1024x185.png 1024w, https:\/\/images.theeventscalendar.com\/kb\/uploads\/2022\/11\/Screen-Shot-2022-11-29-at-3.14.48-PM-768x139.png 768w, https:\/\/images.theeventscalendar.com\/kb\/uploads\/2022\/11\/Screen-Shot-2022-11-29-at-3.14.48-PM-1536x278.png 1536w\" sizes=\"auto, (max-width: 1594px) 100vw, 1594px\" \/><\/figure>\n\n\n\n<p> The Events Calendar&#8217;s Time Zone Settings<\/p>\n\n\n\n<ul class=\"wp-block-list\">\n<li><strong>In the &#8220;Use manual time zones for each event&#8221; mode<\/strong>, event times will be displayed in whatever timezone is selected for the event. Every event can use a different timezone (which we&#8217;ll cover in the next section), and will have their time displayed in terms of that timezone.&nbsp;You don&#8217;t have to manually set a timezone for every event. The default timezone will be whatever time zone you set in your <a rel=\"noopener noreferrer\" href=\"https:\/\/codex.wordpress.org\/Settings_General_Screen\" target=\"_blank\">WordPress general settings<\/a>&nbsp;. Then, if you <em>want<\/em> to change that on any given event, you can.<\/li>\n\n\n\n<li><strong>In the &#8220;Use site-wide time zone everywhere&#8221; mode<\/strong>, all event times will be displayed in terms of whatever time zone you set in your <a rel=\"noopener noreferrer\" href=\"https:\/\/codex.wordpress.org\/Settings_General_Screen\" target=\"_blank\">WordPress general settings<\/a>. For example, if your site timezone is set to Los Angeles (PST) and you create an event at 3:00pm and set the timezone in the event editor to New York (EST), that event will show on the calendar at 12:00pm PST because it is adjusted to be in the site time zone.<\/li>\n<\/ul>\n\n\n\n<p>If you&#8217;re not sure which option is best for you, we generally recommend &#8220;Use manual time zones for each event&#8221; mode. In this mode, you don&#8217;t <em>have<\/em> to specify event time zones \u2014 set your site time zone in your <a href=\"https:\/\/codex.wordpress.org\/Settings_General_Screen\" target=\"_blank\" rel=\"noopener noreferrer\">WordPress general settings<\/a>. But then if you ever <em>want<\/em> to adjust the time zone for an individual event, the ability to do so is there.<\/p>\n\n\n\n<h3 class=\"wp-block-heading\" id=\"event-time-zone\">Setting the timezone for an individual event<\/h3>\n\n\n\n<p>If you&#8217;d like to change an event&#8217;s time zone, view the &#8220;edit&#8221; screen for the event and locate the time and date fields \u2014 you should notice a link that labels the event&#8217;s time zone, as shown in the following screenshot.<\/p>\n\n\n<div class=\"wp-block-image\">\n<figure class=\"aligncenter\"><a href=\"https:\/\/images.theeventscalendar.com\/kb\/uploads\/2015\/09\/Screen-Shot-2018-03-10-at-8.00.55-PM.png\"><img decoding=\"async\" src=\"https:\/\/images.theeventscalendar.com\/kb\/uploads\/2015\/09\/Screen-Shot-2018-03-10-at-8.00.55-PM-665x328.png\" alt=\"An Event's Time Zone\"\/><\/a><figcaption class=\"wp-element-caption\">Classic Editor: The input field for event&#8217;s time zone.<\/figcaption><\/figure><\/div>\n\n\n<p>Click that link to reveal a drop-down menu of all of the available timezones; choose one for the event, then save the event for the new time zone to take effect.<\/p>\n\n\n<div class=\"wp-block-image\">\n<figure class=\"aligncenter\"><img decoding=\"async\" src=\"https:\/\/images.theeventscalendar.com\/kb\/uploads\/2015\/09\/Screen-Shot-2018-03-10-at-8.01.34-PM-665x382.png\" alt=\"Expanded Event Time Zone Menu\"\/><figcaption class=\"wp-element-caption\">The expanded drop-down menu of available time zones for an event.<\/figcaption><\/figure><\/div>\n\n\n<p>If you are using the Block Editor, the drop-down menu of time zones will appear at the right when editing the time zone.<\/p>\n\n\n<div class=\"wp-block-image wp-image-1944037 size-full\">\n<figure class=\"aligncenter\"><img loading=\"lazy\" decoding=\"async\" width=\"2680\" height=\"1202\" src=\"https:\/\/images.theeventscalendar.com\/kb\/uploads\/2019\/10\/block-editor-time-zone-1.png\" alt=\"Block editor with time zone settings on the right panel\" class=\"wp-image-1944037\" srcset=\"https:\/\/images.theeventscalendar.com\/kb\/uploads\/2019\/10\/block-editor-time-zone-1.png 2680w, https:\/\/images.theeventscalendar.com\/kb\/uploads\/2019\/10\/block-editor-time-zone-1-300x135.png 300w, https:\/\/images.theeventscalendar.com\/kb\/uploads\/2019\/10\/block-editor-time-zone-1-1024x459.png 1024w, https:\/\/images.theeventscalendar.com\/kb\/uploads\/2019\/10\/block-editor-time-zone-1-768x344.png 768w, https:\/\/images.theeventscalendar.com\/kb\/uploads\/2019\/10\/block-editor-time-zone-1-1536x689.png 1536w, https:\/\/images.theeventscalendar.com\/kb\/uploads\/2019\/10\/block-editor-time-zone-1-2048x919.png 2048w, https:\/\/images.theeventscalendar.com\/kb\/uploads\/2019\/10\/block-editor-time-zone-1-1568x703.png 1568w\" sizes=\"auto, (max-width: 2680px) 100vw, 2680px\" \/><figcaption class=\"wp-element-caption\">Block Editor: The input field for the event&#8217;s time with the time zone appearing at right.<\/figcaption><\/figure><\/div>\n\n\n<blockquote class=\"wp-block-quote is-layout-flow wp-block-quote-is-layout-flow\">\n<p>\ud83d\udc4b If your site is in the \u201cUse site-wide time zone everywhere\u201d mode, changing an individual event&#8217;s time zone will make no difference in how the time displays on the front end; you&#8217;ll have to <a href=\"#time-zone-mode\">change the time zone mode<\/a> to &#8220;Use manual time zones for each event.&#8221;<\/p>\n<\/blockquote>\n\n\n\n<h3 class=\"wp-block-heading\" id=\"updating-time-zone-data\">Updating timezone data<\/h3>\n\n\n\n<p>In some cases, like if you&#8217;ve just updated your version of The Events Calendar after a long time of not updating it, it will be necessary to update your time zone data before you can fully take advantage of The Events Calendar&#8217;s time zone features.<\/p>\n\n\n\n<p>Don&#8217;t worry if that sounds complicated! It&#8217;s a one-click process:<\/p>\n\n\n\n<ul class=\"wp-block-list\">\n<li>Simply return to the &#8220;Date Format Settings&#8221; section at the bottom of Events \u2192 Settings \u2192 Display in your wp-admin<\/li>\n\n\n\n<li>Look for the &#8220;Update Time Zone Data&#8221; button there<\/li>\n\n\n\n<li>If it&#8217;s not visible, your time zone data is up-to-date and no action is required<\/li>\n\n\n\n<li>If it <em>is visible<\/em>, you can click the button to perform the update<\/li>\n<\/ul>\n\n\n\n<figure class=\"wp-block-image\"><img decoding=\"async\" src=\"https:\/\/images.theeventscalendar.com\/kb\/uploads\/2015\/08\/timezone-update-button.png\" alt=\"Screenshot showing the time zone data update tool\"\/><\/figure>\n\n\n\n<h3 class=\"wp-block-heading\" id=\"what-configuration-is-right-for-me\">How Daylight Saving Time Affects Events<\/h3>\n\n\n\n<p>If you&#8217;re curious about how Daylight Saving Time affects your events and the display of event times, please check out <a aria-label=\" (opens in a new tab)\" href=\"https:\/\/staging.theeventscalendar.com\/knowledgebase\/k\/how-daylight-saving-time-affects-events\/\" target=\"_blank\" rel=\"noreferrer noopener\">this article<\/a>.<\/p>\n\n\n\n<h3 class=\"wp-block-heading\" id=\"h-timezones-and-caching\">Timezones and Caching<\/h3>\n\n\n\n<p>If you&#8217;re experiencing timezone issues and haven&#8217;t been able to get to the bottom of it, it&#8217;s worth noting that sometimes we see issues related to caching. This can include seeing a wrong timezone than your indicated settings, despite setting the timezone display to <em>site-wide<\/em>. <\/p>\n\n\n\n<p>If that is the case, we&#8217;d recommend temporarily disabling your caching plugin to see if that makes a difference. If it does, you can likely tweak your caching plugin&#8217;s settings and exclusions in order to keep the plugin working with The Events Calendar.<\/p>\n\n\n\n<p>For more information, take a look at the <a href=\"https:\/\/staging.theeventscalendar.com\/knowledgebase\/?s=caching&amp;post_type%5B%5D=post&amp;submit=\" target=\"_blank\" rel=\"noreferrer noopener\">recommended settings<\/a> in some popular caching plugins.<\/p>\n\n\n\n<h3 class=\"wp-block-heading\" id=\"updating-time-zone-data\">Advance topic: Bulk-update timezone data via database query<\/h3>\n\n\n\n<p>If you happen to find the need to update the timezone of your events in bulk, the SQL query below might just be what you need.<\/p>\n\n\n<div class=\"wp-block-syntaxhighlighter-code \"><pre class=\"brush: sql; title: ; notranslate\" title=\"\">\nUPDATE wp_postmeta SET meta_value=&quot;America\/New_York&quot; WHERE meta_key=&quot;_EventTimezone&quot;;\n<\/pre><\/div>\n\n\n<p><\/p>\n","protected":false},"excerpt":{"rendered":"<p>The Events Calendar provides simple but robust timezone capabilities, allowing you to have events in many different timezones. Use this article to get familiar with all of the controls available to you, and to learn what kinds of output to expect from certain timezone configurations. Two types of timezones There are two primary types of&#8230;<\/p>\n","protected":false},"author":3,"featured_media":1955565,"comment_status":"closed","ping_status":"closed","sticky":false,"template":"","format":"standard","meta":{"_acf_changed":false,"_kad_blocks_custom_css":"","_kad_blocks_head_custom_js":"","_kad_blocks_body_custom_js":"","_kad_blocks_footer_custom_js":"","_swpsp_post_exclude":false,"_kad_post_transparent":"","_kad_post_title":"","_kad_post_layout":"","_kad_post_sidebar_id":"","_kad_post_content_style":"","_kad_post_vertical_padding":"","_kad_post_feature":"","_kad_post_feature_position":"","_kad_post_header":false,"_kad_post_footer":false,"ep_exclude_from_search":false,"footnotes":""},"categories":[130],"tags":[90],"stellar-product-taxonomy":[161],"class_list":["post-1896585","post","type-post","status-publish","format-standard","has-post-thumbnail","hentry","category-advanced-post-manager","tag-time-zone","stellar-product-taxonomy-the-events-calendar"],"acf":[],"taxonomy_info":{"category":[{"value":130,"label":"Managing Events"}],"post_tag":[{"value":90,"label":"time zone"}],"stellar-product-taxonomy":[{"value":161,"label":"The Events Calendar"}]},"featured_image_src_large":["https:\/\/images.theeventscalendar.com\/kb\/uploads\/2023\/02\/social-share-1024x538.png",1024,538,true],"author_info":{"display_name":"Jaime Marchwinski","author_link":"https:\/\/staging.theeventscalendar.com\/knowledgebase\/author\/jaimetri-be\/"},"comment_info":0,"category_info":[{"term_id":130,"name":"Managing Events","slug":"advanced-post-manager","term_group":0,"term_taxonomy_id":130,"taxonomy":"category","description":"","parent":61,"count":44,"filter":"raw","term_order":"0","cat_ID":130,"category_count":44,"category_description":"","cat_name":"Managing Events","category_nicename":"advanced-post-manager","category_parent":61}],"tag_info":[{"term_id":90,"name":"time zone","slug":"time-zone","term_group":0,"term_taxonomy_id":90,"taxonomy":"post_tag","description":"","parent":0,"count":5,"filter":"raw","term_order":"0"}],"_links":{"self":[{"href":"https:\/\/staging.theeventscalendar.com\/knowledgebase\/wp-json\/wp\/v2\/posts\/1896585","targetHints":{"allow":["GET"]}}],"collection":[{"href":"https:\/\/staging.theeventscalendar.com\/knowledgebase\/wp-json\/wp\/v2\/posts"}],"about":[{"href":"https:\/\/staging.theeventscalendar.com\/knowledgebase\/wp-json\/wp\/v2\/types\/post"}],"author":[{"embeddable":true,"href":"https:\/\/staging.theeventscalendar.com\/knowledgebase\/wp-json\/wp\/v2\/users\/3"}],"replies":[{"embeddable":true,"href":"https:\/\/staging.theeventscalendar.com\/knowledgebase\/wp-json\/wp\/v2\/comments?post=1896585"}],"version-history":[{"count":5,"href":"https:\/\/staging.theeventscalendar.com\/knowledgebase\/wp-json\/wp\/v2\/posts\/1896585\/revisions"}],"predecessor-version":[{"id":1963476,"href":"https:\/\/staging.theeventscalendar.com\/knowledgebase\/wp-json\/wp\/v2\/posts\/1896585\/revisions\/1963476"}],"wp:featuredmedia":[{"embeddable":true,"href":"https:\/\/staging.theeventscalendar.com\/knowledgebase\/wp-json\/wp\/v2\/media\/1955565"}],"wp:attachment":[{"href":"https:\/\/staging.theeventscalendar.com\/knowledgebase\/wp-json\/wp\/v2\/media?parent=1896585"}],"wp:term":[{"taxonomy":"category","embeddable":true,"href":"https:\/\/staging.theeventscalendar.com\/knowledgebase\/wp-json\/wp\/v2\/categories?post=1896585"},{"taxonomy":"post_tag","embeddable":true,"href":"https:\/\/staging.theeventscalendar.com\/knowledgebase\/wp-json\/wp\/v2\/tags?post=1896585"},{"taxonomy":"stellar-product-taxonomy","embeddable":true,"href":"https:\/\/staging.theeventscalendar.com\/knowledgebase\/wp-json\/wp\/v2\/stellar-product-taxonomy?post=1896585"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}