Skip to main content
All CollectionsFields
Importing and Using the Hours field
Importing and Using the Hours field

Information on MetaLocator's dynamic hours fields

Bryan Nye avatar
Written by Bryan Nye
Updated over a week ago

MetaLocator allows you to import a specially formatted field that is interpreted as a location's hours of operation.  This information must be provided in the following format within your import file:

This information can also be provided as a single hours column in the following compact format:

{<dow>|<open>-<closed>}

An example of this format is as follows:

{Mon|9:00-13:00}{Tue|15:00-16:15}{Wed|15:00-16:15}{Sat|C}

This example indicates that this location's hours of operation are

To use import multiple hours fields, the compact format must be used.

Times provided in your import file must use a 24 hour clock.

To indicate a location is open 24 hours a day, use 0:00-23:59

To indicate a closing time into the next day, such as opening at 6AM and closing at 2:30AM use this notation:
{Sat|6:00-2:30} 

Multiple Hours Ranges Per Day

When a location has multiple open ranges to include, for example, a brief closure for lunch, additional ranges can be specified as shown below. The ranges are separated by a comma and should be provided in chronological order.

{Mon|9:00-12:00,13:00-18:00}

During bulk import, multiple hours ranges can be specified as above, or as repeated weekday columns as shown below:

Holiday Hours

To provide special hours for certain holidays, MetaLocator supports hours for specific days, or specific days of every year.  For example, we support holiday hours that appear every year as shown below:

{12-31|6:00-19:30}

The above will show the location as open from 6 am to 7:30 pm on December 31st (New Year's Eve) every year, regardless of the day of week it falls upon.  Holiday hours will always override the regular weekday hours. A more complete example might be as shown below:

{Mon|9:00-13:00}{Tue|15:00-16:15}{Wed|15:00-16:15}{Thu|15:00-16:15}{Fri|15:00-16:15}{Sat|C}{Sun|C}{12-31|C}{10-31-2019|9:00-17:00}


The above example includes normal weekday hours and also indicates that the location is closed every year for New Year's Eve and this year will also be closed on Halloween (10-31).  Since the hours specification includes the year, this same location would not show as closed on 10-31-2020.  This allows our users to specify holiday hours once and not require updates every year for recurring holidays.

Displaying Hours

The Interface Builder can be used to add Hours display to your locator. Click Results, then expand the List group then click Add Field, choose Hours from the list of fields. The hours field has a series of Templates that control how it is displayed. The example below shows the "Collapse" template, which shows a summary of the location's hours today, (or next time open if closed) and current status, but also allows the user to expand and collapse to show the full location hours. Change the template to choose from other display options. Users with Pro and higher plans can access the template editor to completely customize location hours display.

Open, Closed and Closing Soon

The locationstatus field indicates the location's current "open" or "closed" status. When within 1 hour of closing, the system displays "closing soon". The open or closed status is based on the end user's local time zone as compared to the location's time zone. It will interpret the hours as local to the location, and the time as local to the user's browser.

The time zone is automatically populated during the geocoding process. If latitude and longitude are manually imported, the time zone should also be imported in the time_zone field. Valid values are maintained by the IANA.

Time Format

Time display formats are controlled automatically by the user's browser locale. This allows automatic logic to control the use of 24-hour clocks (E.g. 17:00 hours, v.s. 5:00 p.m.), RTL-displays and handles other time display nuances.

There are two modes for time display, Automatic and Manual. The default is Automatic. In automatic mode, you can control whether the system displays minutes or not. This is helpful when you want locale-specific displays but want to conserve space by hiding the minutes.

Manual Time Format

In manual time formatting the format is fixed, but follows a formatting string that allows very specific control over how time is displayed, shown as g:i a below. That corresponds to a time format as 9:00 am and is the default format.

Translation

If you want to provide alternative labelling or translations for the the weekday column headings, import your content using constants, such as

{LOCATOR_MON|9:00-13:00}{LOCATOR_TUE|15:00-16:15}{LOCATOR_WED|15:00-16:15}{LOCATOR_SAT|C} 

Then provide translations in the appropriate language file for LOCATOR_MON  and similar constants.

To translate "Open" and "Closed", provide translations  for LOCATOR_OPEN  and LOCATOR_CLOSED .  To provide a translation for the "Closed" label used in the weekday column, use LOCATOR_HOURS_CLOSED .

The language constant displayed for 24 hours locations is LOCATOR_HOURS_ALL_DAY

The dash between the open and closing hours is controlled by LOCATOR_HOURS_DELIMITER.

Did this answer your question?