# AD-DA.ca, DateTime MultiLanguage ## Plugin Description --- The Multi-Language DateTime plugin displays the current date and time with support for custom formats and 14 different languages. This plugin is ideal for integrating multi-lingual time displays into Q-SYS systems, conference rooms, and international venues where accurate date/time information in multiple languages is required. --- ## Configuration Overview --- ### Plugin version This document is written for the plugin: * AD-DA.ca, Multi-Language DateTime v1.0.0.0 ### Release note **2026-05 : V1.0.0.0** * Initial release with support for 14 languages ### QDS compatibility This plugin has been developed and tested on: * Q-SYS Designer version `10.2.1` --- ## Properties --- ### License **Type:** `String` **Default value:** `Empty` **Description:** License key activated for the main core. Licenses are issued on a "per core" basis, as in each core needs its own license to run as many instances of the plugin as needed on this particular core and licenses are not transferable from core to core. License keys can be added while in Offline mode, in the Properties pane on the right. To purchase licenses, go to . The plugin can be emulated for free, allowing you to prepare everything without requiring you to have access to a core. ### License Backup **Type:** `String` **Default value:** `Empty` **Description:** License key activated for the backup core. If your main Q-SYS Core fails, the backup Core automatically takes over without needing a license to function as a temporary replacement. However, if the design boots from the backup Core, a valid license is required. Additionally, if the backup Core is restarted (due to power loss or other reasons), the plugin instances cannot initialize without a valid license. --- ## Controls --- ### Control Page ![](https://docs.ad-da.ca/api/files.get?sig=eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJrZXkiOiJ1cGxvYWRzLzM3YmU2MDE2LWVjNzktNDVlYy04YTA1LWY5ZWFmMjk0YjdiMy8xNDllNjI5Zi05ZGFlLTQ2NzAtYWJkMC0yMTNjZWNmMmJjOWMvU2NyZWVuc2hvdC5wbmciLCJ0eXBlIjoiYXR0YWNobWVudCIsImlhdCI6MTc4OTAzMzUwMCwiZXhwIjoxNzg5MTE5OTAwfQ.wBM39gaMToxvueUzdl5TDFAADIik0TTxNMdEFNPPAv8 " =334x215") #### Status **Control name:** `Status` **Type:** `Indicator` **Description:** Displays the current status of the plugin. Shows "OK" when the plugin is operational with a valid license, or "FAULT" with a message if there are any issues. --- #### Format Selection ##### Format **Control name:** `Format` **Type:** `Text ComboBox` **Default Value:** `Friday, 13 Apr 2018 10:41 PM` **Choices:** 13 predefined formats plus "Custom" option **Description:** Select from 13 predefined date/time formats or choose "Custom" to enter a custom format string. Available formats include "04-13-18 22:41", "04/13/2018", "10:41:19 PM", "13 Apr 2018 22:41:19", "13.04.18", ISO 8601, time-only, and various combinations. Changing the format immediately updates both the Example (preview) and Output displays. --- ##### Format String **Control name:** `Format String` **Type:** `Text Input` **Default Value:** `%A, %d %b %Y %I:%M %p` **Description:** Displays the Lua format code for the selected format. When a predefined format is selected, this field is read-only and shows the corresponding format code. When "Custom" is selected in the Format control, this field becomes editable, allowing you to create custom date/time formats using standard Lua date format codes such as `%H` (hour), `%M` (minute), `%d` (day), `%m` (month), `%Y` (year), `%A` (full day name), and `%B` (full month name). Invalid format codes will display "Invalid format" in the Example and Output fields. --- ##### Language **Control name:** `Language` **Type:** `Text ComboBox` **Default Value:** `French` **Choices:** English, French, Spanish, German, Italian, Portuguese, Dutch, Russian, Chinese, Japanese, Korean, Polish, Turkish, Swedish **Description:** Select the language for date and time display. All 14 languages include complete translations for day names and month names. Changing the language immediately updates both the Example (preview) and Output displays with day names and month names in the selected language. --- ##### Output **Control name:** `Output` **Type:** `Indicator Text` **Description:** A read-only text display that shows the current date/time in the selected format and language. This is the primary output of the plugin and updates every second with the current date/time. --- --- ## Predefined Formats The plugin includes 13 predefined date/time formats: | Format Display | Format Code | Example Output (English) | |:---------------|:-----------:|:-------------------------| | 04-13-18 22:41 | `%m-%d-%y %H:%M` | 04-13-18 22:41 | | 04/13/2018 | `%m/%d/%Y` | 04/13/2018 | | 10:41:19 PM | `%I:%M:%S %p` | 10:41:19 PM | | 13 Apr 2018 22:41:19 | `%d %b %Y %H:%M:%S` | 13 Apr 2018 22:41:19 | | 13\.04.18 | `%d.%m.%y` | 13\.04.18 | | 2018-04-13T10:41:19+0000 | `%Y-%m-%dT%H:%M:%S+0000` | 2018-04-13T10:41:19+0000 | | 22:41:00 | `%H:%M:%S` | 22:41:00 | | Apr 13, 10:41 PM | `%b %d, %I:%M %p` | Apr 13, 10:41 PM | | Apr 13, 2018 | `%b %d, %Y` | Apr 13, 2018 | | April 2018 | `%B %Y` | April 2018 | | Fri, 13 Apr 2018 22:41:19 +0000 | `%a, %d %b %Y %H:%M:%S +0000` | Fri, 13 Apr 2018 22:41:19 +0000 | | Friday, 13 Apr 2018 10:41 PM | `%A, %d %b %Y %I:%M %p` | Friday, 13 Apr 2018 10:41 PM | | Friday, Apr 13 | `%A, %b %d` | Friday, Apr 13 | --- ## Custom Format Codes When using the "Custom" format option, use these standard Lua date format codes: ![](https://docs.ad-da.ca/api/files.get?sig=eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJrZXkiOiJ1cGxvYWRzLzM3YmU2MDE2LWVjNzktNDVlYy04YTA1LWY5ZWFmMjk0YjdiMy83ZTRlZjJhYS00ODhiLTQzYWEtYjFlNy1jMDI2ZDY1ZDMxY2QvU2NyZWVuc2hvdDIucG5nIiwidHlwZSI6ImF0dGFjaG1lbnQiLCJpYXQiOjE3ODkwMzM1MDAsImV4cCI6MTc4OTExOTkwMH0.-Savyt_Uvi-oiUv6tTtBDvMicEb4yg1tpJxtmPydwAQ " =334x239") | Code | Description | Example | |:-----|:------------|:--------| | `%a` | Abbreviated weekday name | Mon, Tue, Wed, ... | | `%A` | Full weekday name | Monday, Tuesday, ... | | `%b` | Abbreviated month name | Jan, Feb, Mar, ... | | `%B` | Full month name | January, February, ... | | `%d` | Day of month (01-31) | 01, 13, 31 | | `%H` | Hour 24-hour format (00-23) | 00, 13, 23 | | `%I` | Hour 12-hour format (01-12) | 01, 10, 12 | | `%M` | Minute (00-59) | 00, 41, 59 | | `%S` | Second (00-59) | 00, 19, 59 | | `%p` | AM/PM | AM, PM | | `%m` | Month (01-12) | 01, 04, 12 | | `%y` | Year (2-digit) | 18, 26, 99 | | `%Y` | Year (4-digit) | 2018, 2026, 2099 | | `%%` | Literal % | % | | `[:]` | Blinking colon (alternates every 1 second) | \: / empty | | `[::]` | Fast blinking colon (alternates every 500 ms) | \: / empty | --- ## Supported Languages The plugin includes complete translations for the following 14 languages: * **English (en)** - Default language * **French (fr)** - Français * **Spanish (es)** - Español * **German (de)** - Deutsch * **Italian (it)** - Italiano * **Portuguese (pt)** - Português * **Dutch (nl)** - Nederlands * **Russian (ru)** - Русский * **Chinese (zh)** - 简体中文 * **Japanese (ja)** - 日本語 * **Korean (ko)** - 한국어 * **Polish (pl)** - Polski * **Turkish (tr)** - Türkçe * **Swedish (sv)** - Svenska --- ## Troubleshooting :::warning Invalid Format Error If the Example or Output display shows "Invalid format", the format code contains an error. Verify your custom format code syntax and ensure all format codes are valid Lua date format codes. ::: :::info No Format Selected If the output is empty, ensure a format has been selected from the Format dropdown control. ::: :::success Language Not Translating If day names and month names are not translating, verify the Language control is set to the desired language. The translation applies to the standard English day and month names in your format. ::: --- --- ## Tips and Best Practices * **Predefined Formats** - Use predefined formats for common date/time displays to ensure consistency and avoid format code errors * **ISO 8601** - Use the `2018-04-13T10:41:19+0000` format for system integration and logging applications * **Language Selection** - Select the appropriate language before deploying the plugin to avoid configuration changes in production systems * **Custom Formats** - Test custom format codes in the Example display before deploying to production * **12-hour vs 24-hour** - Use `%I` for 12-hour format with `%p` (AM/PM), or `%H` for 24-hour format --- *** ![](https://docs.ad-da.ca/api/files.get?sig=eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJrZXkiOiJ1cGxvYWRzLzM3YmU2MDE2LWVjNzktNDVlYy04YTA1LWY5ZWFmMjk0YjdiMy8xOWZiZjg5MS1lMmU2LTRmZTEtYmQ1Ny0zMTRlMjVhNjZlNGMvdGVzdDIucG5nIiwidHlwZSI6ImF0dGFjaG1lbnQiLCJpYXQiOjE3ODkwMzM1MDAsImV4cCI6MTc4OTExOTkwMH0.OCTzJKACPC3TSC1ElX8RA8R5VBO9gKmjueMjjNP_dHs "left-50 =241x100") [*support@ad-da.ca*](mailto:support@ad-da.ca) *| Copyright © 2026* [*AD-DA.CA*](http://AD-DA.CA) --- **Documents** - [Frequently Asked Questions](https://docs.ad-da.ca/s/guide/doc/frequently-asked-questions-WYCxRgYzYg) - [Activation Portal](https://docs.ad-da.ca/s/guide/doc/activation-portal-MCuyIlFv42) - [Q-SYS Plugins](https://docs.ad-da.ca/s/guide/doc/q-sys-plugins-1ccQgVxaEF)