Alpha.Community

В разделе Документация вы найдете все для уверенного старта и работы с Альфа платформой: от пошаговых инструкций по установке и конфигурированию до подробного описания работы компонентов и подсистем. Для поиска необходимых тем и вопросов в документации, воспользуйтесь поиском и фильтрацией результатов.

Свойства

Отображаемое имя

Описание объекта (поля объекта). Позволяет указать произвольное (например, русскоязычное) имя для узнаваемости объекта (поля объекта) в проекте. Не мешает использованию базового англоязычного имени объекта (поля объекта) для обращения в коде.

Кардинальное число

Преобразует объект в массив и задает размер массива (количество элементов в массиве).

Значение

1 Одиночный объект.
>1 Массив соответствующей размерности.

Длина

int8 Length

Размер массива (количество элементов в массиве).

Есть только у массивов и доступно только для чтения в режиме рантайма.

Примеры

Записать в текстовое поле длину массива.

TextEdit_1.Text = Str.ToString (SW_1.Length);

Индекс

int8 Index

Индекс элемента в массиве. Позволяет отследить у какого элемента сработало то или иное событие.

Есть только у массивов и доступно только для чтения в режиме рантайма.

Примеры

Записать в текстовое поле индекс элемента массива, у которого сработало событие изменения значения.

TextEdit_2.Text = Str.ToString(Index);

Записать в текстовое поле текущее значение элемента массива, у которого сработало событие изменения значения.

TextEdit_3.Text = Str.ToString(penwidth[Index]);

В зависимости от индекса элемента в массиве вывести в текстовое поле запись о включении соответствующего режима работы задвижки.

if (SW_1.Mode.Index == 0)
ㅤ TextEdit_1.Text = "Включен режим 1";
else
ㅤ TextEdit_1.Text = "Включен режим 2";

Формат даты/времени

string DateTimeFormat

Формат представления метки времени или длительности. Доступны обозначения: dd — дни, MM — месяцы, yyyy — год, H или HH — часы, mm — минуты, ss — секунды.

Внутреннее представление времени использует системные такты — тики (Ticks). Один тик равен 100 наносекундам. В одной секунде содержится 10 000 000 тиков. Если преобразуемое значение поступает на вход в секундах (например, от элемента OPC), для корректного форматирования его необходимо предварительно умножить на 10 000 000.

При обработке абсолютной даты точкой отсчета (0 тиков) является 01.01.0001 00:00:00. Если данные поступают от OPC-сервера в формате Windows FILETIME (OPC UA), точкой отсчета выступает 01.01.1601 00:00:00. При передаче относительного времени (длительности) маска формата преобразует смещение от начальной точки.

Вывод миллисекунд не поддерживается, точность отображения ограничена секундами (ss).

Примеры

Задать маску для вывода значения длительности (80 секунд), полученного от элемента OPC, в формате минут и секунд и вывести результат в текстовое поле.

// Имитируем приход данных (80 секунд от элемента OPC)
opcSeconds: var = 80;
// Переводим секунды в тики и передаем во входное значение компонента
OutputFormatter_1.InValue = opcSeconds * 10000000;
// Задаем маску формата для отображения минут и секунд
FormatDateTime_1.DateTimeFormat = "mm:ss";
// Забираем готовый результат из компонента и выводим в текстовое поле
Text_1.Text = OutputFormatter_1.OutValue;

Локальное время

bool LocalTime

Cледует ли использовать локальное время вместо оригинальной метки времени.

Значение

true Оригинальная метка времени заменяется локальным временем.
false Используется оригинальная метка времени.