MIDAS KnowledgebaseMIDAS Knowledgebase

Specifying a custom timezone

Note: This article applies to MIDAS v4.08 or later

You can configure MIDAS to operate in a certain timezone via MIDAS Admin Options → Manage MIDAS → Appearance → Date/Time Settings → Timezone

As of MIDAS v4.08, 275 world timezones are selectable from a drop down list. In addition, starting with MIDAS v4.08 it's also possible to define your own custom timezone, by selecting the "Custom..." option at the bottom of the drop-down list of timezones.

This advanced article describes how to define a custom timezone, which for most users will never be required.

A custom timezone string in MIDAS v4.08 or later should take the following format:



std, dst are three or more letters that are the designation for the standard (std) or daylight savings (dst) time zone. Only std is required. If dst is omitted, daylight savings (summer) time doesn't apply in this locale. Upper- and lowercase letters are allowed. Any characters except for a leading colon (:), digits, comma (,), minus (-), plus (+), and ASCII NUL (\0) are allowed.

offset indicates the value that must be added to the local time to arrive at Coordinated Universal Time (UTC). The offset has the form:


The minutes (mm) and seconds (ss) are optional. The hour (hh) is required, and may be a single digit.

The offset following std is required. If no offset follows dst, daylight savings time is assumed to be one hour ahead of standard time.

The hour may be between 0 and 24, and minutes/seconds (if specified) between 0 and 59. If preceded by a "-", the time zone is east of the Prime Meridian; otherwise it's west (which may be indicated by an optional preceding "+").

If the optional start/end parameters are included, this indicates when to change to and back from daylight savings time. These parameters have the following form:


where the first date describes when the change from standard to dst occurs, and the second date describes when dst changes back to standard time. Each time field describes when, in current local time, the change to the other time is made.

The format of date may be one of the following:

The Julian day n (1 <= n <= 365). Leap days aren't counted. That is, in all years - including leap years - February 28 is day 59 and March 1 is day 60. It's impossible to refer explicitly to the occasional February 29.

The zero-based Julian day (0 <= n <= 365). Leap years are counted, and it is possible to refer to February 29.

The dth day (0 <= d <= 6) of week n of month m of the year (1 <= n <= 5, 1 <= m <= 12, where week 5 means "the last d day in month m", which may occur in the fourth or fifth week). Week 1 is the first week in which the dth day occurs. Day zero is Sunday.

The time has the same format as offset, except that no leading sign ("+" or "-") is allowed. The default, if time is omitted, is 02:00:00.

Some examples of custom timezone strings are given below.






Alternatively, some servers may support custom timezone strings in the format "Region/[City or Timezone]", some examples include:

This is how timezones were handled in MIDAS v4.07 and earlier, however server support for such timezone formats is not as widespread as for the stdoffset[dst[offset][,start[/time],end[/time]]] notation described above.

Upgrading from MIDAS v4.07 to v4.08 or later will retain your previous timezone setting, but it may appear as a custom timezone setting in v4.08, and you may wish to select a more appropriate timezone from the new list of available timezones in the drop-down.

You might also be interested in...
» » »

← Return to Knowledgebase