Date/Time
Use the Date/Time component to insert a date/time text box into your design. This is especially useful for adding the local date and time to a user control interface (UCI).
- Drag the Date/Time component into your schematic and double-click it to open the control panel.
- Copy the Output text box into your UCI design.
- Press F5 to save your design to the Core and run it. (Or, press F6 to emulate your design.)
- In the Date/Time component's control panel, select a Format. You can select from a list of common date/time formats, or select Custom to specify your own using date/time specifiers. See Controls.
The Core's date/time is now shown in your UCI using the selected format.
Inputs and Outputs
Control components do not have traditional input and output pins. If a Control Pin is available for the component, an input or output will appear.
Control Pins represent the controls available in the component's Control Panel. Control Pins are used to link controls between Schematic Elements, and link to / from Control Scripts. Control Pin signal pins are represented by a square, and the wiring is represented by a thick blue / white line.
Date/Time Properties
There are no configurable properties for this component.
Graphic Properties
Label
Use the Label property to change the name of the component in the schematic. The Label property defaults to the component name. To learn more about renaming schematic elements, see Organizing Your Design.
Position
The coordinates reference a specific place in the schematic - for example,"100,100" (horizontal, vertical). 0,0 is the upper left corner of the schematic.
Fill
Sets the fill color of the component in the schematic.
Script Access Properties
Code Name
Displays the currently assign name for control access. You can use the auto-assigned name or customize it. Q-SYS will automatically check all Code Names in the design to ensure name is unique.
Script Access
Defines whether the component will be accessible by script and/or externally, or not at all. Choices include All, External, None (default), and Script.
- None (default) - Not accessible by any script, plugin, or by Q-SYS Remote Control Protocol (QRC).
- Script - Can be accessed by scripts, such as Text Controller, Block Controllers, and plugins only.
- External - Can only be accessed by 3rd party controls systems using component commands from the Q-SYS Remote Control Protocol (QRC).
- All - No restrictions, can be accessed by 3rd party control systems via Q-SYS Remote Control Protocol (QRC), or script objects or plugin objects.
Tip: Use Script Programmer Mode to quickly view the Script Access setting directly on the component in the design schematic without the need to disconnect from the Q-SYS Core processor.
Format
Select from a list of common date/time formats, or select Custom to specify your own date/time Format String.
Format String
Shows the date/time format of a selected Format string. Select Format > Custom (or modify a preformatted string) to specify your own date/time format. See Date/Time Specifiers.
Output
Displays the output of the selected date/time format within a text box.
Specifier |
Definition |
---|---|
%A |
Full day of the week |
%a |
Abbreviated day of the week |
%B |
Full month name |
%b |
Abbreviated month name (same as %h) |
%C |
Two-digit century number |
%c |
Locale's preferred date and time stamp |
%D |
Equivalent to "%m/%d/%y" |
%d |
Two-digit day of the month with leading zeros |
%e |
Day of month with space preceding single digits |
%F |
Equivalent to "%Y-%m-%d" |
%G |
Four-digit version of %g |
%g |
Two-digit year (ISO-8601:1988). See %V. |
%h |
Abbreviated month name (same as %b) |
%j |
Three-digit numeric day of the year with leading zeros |
%m |
Two-digit month |
%U |
Week number of the year (starting with the first Sunday as the first week) |
%u |
Numeric representation of the day of the week (ISO-8601), with Monday as '1' |
%V |
Week number of the given year, starting with the first week of the year with at least four weekdays, with Monday being the start of the week (ISO-8601:1988) |
%W |
Numeric representation of the week of the year, starting with the first Monday as the first week |
%w |
Numeric representation of the day of the week, with Sunday as '0' |
%x |
Locale's preferred date representation without time |
%Y |
Four-digit year |
%y |
Two-digit year |
Specifier |
Definition |
---|---|
%H |
Two-digit hour in 24-hour format |
%I |
Two-digit hour in 12-hour format |
%k |
Hour in 24-hour format with space preceding single digits |
%l (lower-case 'L') |
Hour in 12-hour format, with space preceding single digits. |
%M |
Two-digit minute |
%P |
Lower-case 'am' or 'pm' |
%p |
Upper-case 'AM' or 'PM' |
%R |
Equivalent to "%H:%M" |
%r |
Equivalent to "%I:%M:%S %p" |
%S |
Two-digit second |
%s |
Unix Epoch Time timestamp |
%T |
Equivalent to "%H:%M:%S" |
%X |
Locale's preferred time representation without date |
%Z |
Time zone abbreviation |
%z |
Time zone offset |
Specifier |
Definition |
---|---|
%n |
Newline character ("\n") |
%t |
Tab character ("\t") |
%% |
Percentage character |