ABOUT DATE AND TIME (TARIH_SAAT)

TARIH_SAAT is a user control that keeps time information continuously visible on the operator screen. Although visually simple, it can be adapted to different use cases. Since UpdateInterval=1000 is defined in the source code, the control's basic update interval is 1000 milliseconds.


Basic concept: SCADA screen β†’ time information β†’ selected display type β†’ line/alignment layout β†’ readable date and time.
TARIH_SAAT LIVE DISPLAY
TUESDAY β€’ SEPTEMBER 29, 2026
08:42:17
DATE + TIME / CENTER-ALIGNED DISPLAY

The six options below constitute the complete TSBagliDegerTuru enumeration in the source code. Each option is therefore explained under a separate heading, with particular emphasis on the information layout it represents.

Important structure:
TSBagliDegerTuru β†’ Date / Time / Singlelinedatetime / Ledtime / Doublelinedatetime

TSBagliDegerTuru β€” Six Display Types

The DataType property is defined in the source code with TSBagliDegerTuru.Ledtime as its default value. The six options below determine how the control presents date and time information.

Date

1. DATE

Used to display only the date. It provides a simple date field on operator screens where displaying the time is unnecessary.

29.09.2026
Time

2. TIME

Displays only the time. It is suitable for areas where the current time needs to take precedence over the date.

08:42:17
Singlelinedatetime

3. SINGLE-LINE DATE AND TIME

Combines the date and time on a single line. It provides a compact time display for narrow or single-line information fields.

29.09.2026 08:42:17
Ledtime

5. LED CLOCK

Presents the time in a format intended for an LED clock display. Since Ledtime is the default DataType value in the source code, this is the initial display type.

08:42:17
Doublelinedatetime

6. TWO-LINE DATE AND TIME

Displays the date and time on two separate lines. It can be used in screen layouts where the date and time need to be visually distinguished from each other.

29.09.2026
08:42:17

Why Are Display Types Important?

The six options do not simply repeat the same information under different names. They provide different presentation formats in terms of screen information density, available width, and visual hierarchy. Therefore, the choices of Date, Time, Singlelinedatetime, Ledtime, and Doublelinedatetime should be considered part of the screen design.

Top and Bottom Line Settings

The TARIH_SAAT source code contains independent color, font, and text-alignment properties for two separate lines. This structure makes it possible to visually distinguish the date from the time, especially in the two-line date and time display mode.

Top Line

TopLineBackColor β€’ Top Line Background Color

TopLineForeColor β€’ Top Line Foreground Color

TopLineFont β€’ Top Line Font

TopLineTextAlignment β€’ Top Line Text Alignment

29.09.2026

Bottom Line

BottomLineBackColor β€’ Bottom Line Background Color

BottomLineForeColor β€’ Bottom Line Foreground Color

BottomLineFont β€’ Bottom Line Font

BottomLineTextAlignment β€’ Bottom Line Text Alignment

08:42:17
Defaults in the source code: The background for both the top and bottom lines is Transparent, the foreground color is Lime, the font is Arial Narrow 9.75f Bold, and text alignment is set to Middlecenter.

GNKonum β€” Available Options

The TopLineTextAlignment and BottomLineTextAlignment properties use the GNKonum type. The source code defines a total of nine alignment options. These are used to determine the position of text on the screen.

Technical Value Description Position
Topleft Top Left Upper left
Topcenter Top Center Top center
Topright Top Right Upper right
Middleleft Middle Left Center left
Middlecenter Middle Center Center
Middleright Middle Right Center right
Bottomleft Bottom Left Lower left
Bottomcenter Bottom Center Bottom center
Bottomright Bottom Right Lower right

GNCerceveTuru β€” Available Options

The BorderStyle property uses the GNCerceveTuru type to determine the control's border style. Three options are defined in the source code.

Technical Value Description Explanation
None None No border is used for the control.
Fixedsingle Fixed Single A fixed single-line border style is used.
Fixed3d Fixed 3D A fixed three-dimensional border style is used.
Since the default value in the source code is BorderStyle = None, TARIH_SAAT initially uses a borderless display.

General Properties

The following table brings together the general and visual properties explicitly defined in the provided TARIH_SAAT source code. The terminology in the Turkish descriptions is based on the TΓΌrkΓ§e_set2(3).txt dictionary.

Technical Property Description Default Explanation
UCType Control Type TARIH_SAAT Defines the type of the user control.
UpdateInterval Update Interval 1000 ms Defines the control's basic update interval.
DecimalPoint Decimal Places 0 The general numeric display setting defined in the source code.
UCBackColor Control Background Color Transparent Defines the control's general background color.
UCForeColor Control Foreground Color Lime Defines the control's general text/foreground color.
UCFont Control Font Arial Narrow 9.75f Bold Defines the control's primary font and style.
TopLineBackColor Top Line Background Color Transparent Defines the top line's background color.
TopLineForeColor Top Line Foreground Color Lime Defines the foreground color of the top line's text.
TopLineFont Top Line Font Arial Narrow 9.75f Bold Defines the font and style used on the top line.
TopLineTextAlignment Top Line Text Alignment Middlecenter Defines the position of the top line's text.
BottomLineBackColor Bottom Line Background Color Transparent Defines the bottom line's background color.
BottomLineForeColor Bottom Line Foreground Color Lime Defines the foreground color of the bottom line's text.
BottomLineFont Bottom Line Font Arial Narrow 9.75f Bold Defines the font and style used on the bottom line.
BottomLineTextAlignment Bottom Line Text Alignment Middlecenter Defines the position of the bottom line's text.
BorderStyle Border Style None Defines the control's border style.
TopMargin Top Margin 1 The top margin value defined in the source code.
DataType Data Type Ledtime Determines the display format used for date and time information.

Applications in SCADA Screens

Rather than controlling specific process equipment, TARIH_SAAT is a display control that organizes time information on the screen. Its applications therefore depend on the areas of the screen where operators need access to the date and time.

Operator Screen Header

Can be used to keep the current date continuously visible in the upper section of the screen.

Live Clock Display

Can be used to let operators monitor the current time without leaving the process screen.

Two-Line Information Field

Can be used where the date and time need to be separated into two lines for improved readability.

LED Display

Can be used in screen designs where an LED clock appearance is preferred.

Note: These use cases are examples for screen design based on the control's definition in the source code. The source code does not require the control to be used with any specific process equipment.

Recommended Configuration Sequence

When adding TARIH_SAAT to a screen, the control produces a more organized and readable result if you first decide which time information to display and then determine how it should be laid out.

1. Add the TARIH_SAAT user control.
2. Select the display type using DataType.
3. Configure the top and bottom line text settings if needed.
4. Set text alignment using GNKonum.
5. Set the border style using BorderStyle.
6. Check the colors, font, and screen layout.

Design Check

In particular, the screen area's width and line height should be considered when using Singlelinedatetime and Doublelinedatetime. In LED clock or panel-style displays, font, color, and background contrast directly affect readability.

CONCLUSION

TARIH_SAAT is a user control designed to display date and time information easily and conveniently on SCADA screens. It can be adapted to different screen layouts. Its most distinctive feature is the six different display formats defined in TSBagliDegerTuru.

Five Core Display Types:
Date β†’ Time β†’ Single-Line Date and Time β†’ LED Clock β†’ Two-Line Date and Time

In addition, independent color, font, and alignment properties for the top and bottom lines, together with the GNKonum and GNCerceveTuru options, make it easier to adapt the control to SCADA screen designs.