Alpha.Community

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

Преобразование форматов данных

Компоненты преобразования форматов данных позволяют отображать числа, логические значения и даты в нужной форме.

Компоненты преобразования форматов данных из юнита Базовые:

Данные компоненты работают в связке с компонентами Входной формат и Выходной формат.

Формат числа с плавающей запятой

Компонент Формат числа с плавающей запятой предназначен для представления чисел с плавающей точкой с определённой точностью. Он полезен в случаях, когда важно сохранить точность числа до конкретного количества знаков после запятой.

Компонент Формат числа с плавающей запятой расположен в юните Базовые Библиотеки компонентов. Экземпляр этого типа не отображается на форме и виден только в области Структура объекта.

Подробнее о свойствах компонента Формат числа с плавающей запятой.

Формат булевского значения

Компонент Формат булевского значения используется для представления логических значений (true/false) в альтернативном текстовом виде. Это удобно для случаев, когда нужно отображать логические значения в более понятной для пользователя форме, например, как «Да» и «Нет».

Компонент Формат булевского значения расположен в юните Базовые Библиотеки компонентов. Экземпляр этого типа не отображается на форме и виден только в области Структура объекта.

Подробнее о свойствах компонента Формат булевского значения.

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

Компонент Формат даты/времени предназначен для преобразования числовых значений (наносекундных интервалов, начиная с 1 января 1601 года) в читаемый формат даты и времени, например, даты в формате dd.MM.yyyy или времени в формате HH:mm:ss.

Компонент Формат даты/времени работает с типом данных Uint8. Это означает, что преобразование начинается только после ввода минимум 8 цифр. Если введено меньше 8 цифр, преобразование не производится. При вводе 8 или более цифр используется вся введённая последовательность для расчёта даты и времени. Например, значение 132556800000000000 будет преобразовано в 21.01.2021 5:20:00.

Компонент Формат даты/времени расположен в юните Базовые Библиотеки компонентов. Экземпляр этого типа не отображается на форме и виден только в области Структура объекта.

Подробнее о свойствах компонента Формат даты/времени.

Конвертация типов данных

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

Конвертация строк в универсальный тип Variant

Чтобы конвертировать строки (значения типа string) в значения универсального типа variant, воспользуйтесь компонентом Входной формат.

Преобразование выполняются в соответствии с форматом, указанным в свойстве Ссылка на формат (указывается один из компонентов типа Формат числа с плавающей запятой, Формат булевского значенияили Формат даты/времени).

Свойство InValue принимает входное значение строкового типа. Свойство OutValue предоставляет сконвертированное значение для чтения.

Компонент Входной формат расположен в юните Базовые Библиотеки компонентов. Экземпляр этого типа не отображается на форме и виден только в области Структура объекта.

Подробнее о свойствах и событиях компонента Входной формат.

Конвертация любых типов в строки

Чтобы конвертировать значения любых типов в строковый тип string, используйте компонент Выходной формат.

Преобразование выполняются в соответствии с форматом, указанным в свойстве Ссылка на формат (указывается один из компонентов типа Формат числа с плавающей запятой, Формат булевского значения или Формат даты/времени).

Свойство InValue принимает входное значение любого типа. Свойство OutValue предоставляет сконвертированное значение для чтения в формате строки.

Компонент Выходной формат расположен в юните Базовые Библиотеки компонентов. Экземпляр этого типа не отображается на форме и виден только в области Структура объекта.

Подробнее о свойствах и событиях компонента Выходной формат.

Как настроить преобразование формата данных (Демо-проект)

Далее кратко описан небольшой пример (скачать его можно здесь) настройки компонентов преобразования форматов данных в проекте Alpha.HMI (проект сделан на языке Alpha.Om).

В примере показано как:

  • Преобразовать временные значения из формата наносекундных интервалов (начиная с 1 января 1601 года) в удобный формат даты и времени.
  • Преобразовать логическое значение 1 или 0 в строковую команду Активировать или Деактивировать.
  • Округлить число с плавающей точкой до заданного количества знаков после запятой.
  • Преобразовать строковую команду Активироватьили Деактивировать обратно в логическое значение true или false.

В результате будет подготовлена форма, при открытии которой можно вводить данные в различных форматах и видеть результаты преобразований в реальном времени.

Конвертация времени

  1. Добавьте на форму поле для ввода временного значения в формате наносекундных интервалов.

  2. Добавьте на форму компонент Формат даты/времени.

  3. Настройте свойство Формат даты/времени, чтобы компонент преобразовывал входные значения в формат dd.MM.yyyy H:mm:ss

  4. На форму добавьте компонент Выходной формат и установите ссылку на добавленный ранее компонент Формат даты/времени. Для этого нажмите правой кнопкой мыши по свойству Ссылка на формат→ Сослаться → FormatDateTime_1.

  5. Настройте свойство Входное значение, указав вычисляемое значение, основанное на содержимом поля ввода LineEdit_1.

    String.ToUint8(LineEdit_1.Text, 0) // Преобразует строку из поля ввода в тип Uint8
  6. Добавьте на форму текстовое поле для отображения результата конвертации.

  7. Для вывода результата настройте свойство Текст текстового поля, которое должно содержать вычисляемое значение по свойству OutValue компонента Выходной формат.

Конвертация логического значения

  1. Добавьте на форму поле для ввода логического значения (1 или 0).

  2. Добавьте на форму компонент Формат булевского значения.

  3. Настройте свойства компонента Формат булевского значения, чтобы значение 1 преобразовывалось в строку Активировать, а значение 0 — в строку Деактивировать. Для этого:

    1. Задайте значение Активировать в свойстве Значение "Истина", чтобы логическое значение 1 отображалось как Активировать.
    2. Задайте значение Деактивировать в свойстве Свойство Значение "Ложь", чтобы логическое значение 0 отображалось как Деактивировать

  4. На форму добавьте компонент Выходной формат и установите ссылку на добавленный ранее компонент Формат булевского значения. Для этого нажмите правой кнопкой мыши по свойству Ссылка на формат→ Сослаться → FormatBool_1.

  5. Настройте свойство Входное значение компонента Выходной формат, указав вычисляемое значение, основанное на содержимом поля ввода LineEdit_2.

  6. Добавьте на форму текстовое поле для отображения результата конвертации.

  7. Для вывода результата настройте свойство Текст текстового поля, которое должно содержать вычисляемое значение по свойству OutValue компонента Выходной формат.

Округление числа с плавающей точкой до нужной точности

  1. Добавьте на форму поле для ввода числа с плавающей точкой.

  2. Добавьте на форму компонент Формат числа с плавающей запятой.

  3. Настройте свойство Число знаков после запятой, чтобы компонент округлял число до нужного количества знаков после запятой, например, до двух знаков.

  4. На форму добавьте компонент Выходной формат и установите ссылку на добавленный ранее компонент Формат числа с плавающей запятой. Для этого нажмите правой кнопкой мыши по свойству Ссылка на формат→ Сослаться → FormatFloat_1.

  5. Настройте свойство Входное значение компонента Выходной формат, указав вычисляемое значение, основанное на содержимом поля ввода LineEdit_3.

  6. Добавьте на форму текстовое поле для отображения результата округления

  7. Для вывода результата настройте свойство Текст текстового поля, которое должно содержать вычисляемое значение по свойству OutValue компонента Выходной формат.

Обратная конвертация строковой команды в логическое выражение

  1. Добавьте на форму поле для ввода строковой команды (Активировать или Деактивировать).

  2. Добавьте на форму компонент Входной формат и установите ссылку на добавленный ранее компонент Формат булевского значения. Для этого нажмите правой кнопкой мыши по свойству Ссылка на формат→ Сослаться → FormatBool_1.

  3. Настройте свойство Входное значение компонента Входной формат, указав вычисляемое значение, основанное на содержимом поля ввода LineEdit_4. Компонент Входной формат будет преобразовывать вводимую пользователем строку Активировать в значение true, а строку Деактивировать — в значение false.

  4. Добавьте на форму текстовое поле для отображения результата конвертации.

  5. Для вывода результата настройте свойство Текст текстового поля, которое должно содержать вычисляемое значение по свойству OutValue компонента Входной формат.