---
title: "Руководство пользователя Библиотека SysLibTime"
product: "ALTA IDE"
document_number: "№ 1-RU-163193-1.1"
version: "1.1"
language: "ru"
source: "https://docs.owen.ru/product/alta-ide/doc/library_SysLibTime_stable"
pdf: "https://docs.owen.ru/download/pdf/C38Gi.rp_biblioteka+syslibtime_1-ru-163193-1.1.pdf"
generated: "2026-10-13"
---

# Руководство пользователя Библиотека SysLibTime

## Содержание

- [Цель документа](#topic-122791)
- [Установка библиотеки](#topic-122792)
- [Описание библиотеки SysLibTime](#topic-122793)
  - [CurTime](#topic-122794)
  - [CurTimeUs](#topic-122795)

<a id="topic-122791"></a>

## Цель документа

Библиотека SysLibTime предназначена для считывания системного времени ПЛК.

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

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

<a id="topic-122792"></a>

## Установка библиотеки

Чтобы подключить библиотеку к проекту:

1. Откройте редактор **Менеджер библиотек** одним из способов:

- дважды нажмите ЛКМ на системную папку **Менеджер библиотек** в дереве проекта;

- или нажмите ПКМ на системную папку **Менеджер библиотек** в дереве проекта и выберите в контекстном меню пункт **Открыть**:

  ![Менеджер библиотек открыть](https://docs.owen.ru/book_img/2387/163183.png)

- В редакторе **Менеджер библиотек** откройте вкладку **Магазин**.

- Выберите библиотеку **SysLibTime** и нажмите кнопку **Подключить** на карточке библиотеки.

- Библиотека добавится в проект и отобразится на вкладке **Мои библиотеки** в редакторе **Менеджер библиотек**.

<a id="topic-122793"></a>

## Описание библиотеки SysLibTime

Библиотека **SysLibTime** содержит функциональные блоки для считывания времени, прошедшего с момента загрузки ПЛК.

В состав библиотеки входят два идентичных по структуре функциональных блока:

| ФБ | Единица измерения времени |
| --- | --- |
| [CurTime](#topic-122794) | Миллисекунды (мс) |
| [CurTimeUs](#topic-122795) | Микросекунды (мкс) |

Оба блока содержат структуру SysTime64 и различаются только единицей измерения времени, прошедшего с момента загрузки ПЛК.

<a id="topic-122794"></a>

### CurTime

**Функциональный блок CurTime** считывает время в миллисекундах, прошедшее с момента загрузки ПЛК. Содержит в себе структуру SysTime типа SysTime64.

| Имя переменной | Тип данных | Описание |
| --- | --- | --- |
| SysTime | SysTime64 | Структура |

**Содержимое структуры:**

| Имя переменной | Тип данных | Описание |
| --- | --- | --- |
| ulHigh | DWORD | Зарезервировано (всегда 0) |
| ulLow | DWORD | Время с момента загрузки ПЛК в миллисекундах |

Пример:

<div><div><table><tbody><tr><td><?Pub _cellfont Shading="#2E3136"?><code>
<?Pub _font FontColor="#5684DD"?>VAR<?Pub /_font?>
    <?Pub _font FontColor="#5DA35B"?>(* Экземпляр ФБ CurTime из библиотеки SysLibTime *)<?Pub /_font?>
    <?Pub _font FontColor="#988DF7"?>SysTime<?Pub /_font?> <?Pub _font
FontColor="#EF724B"?>:<?Pub /_font?> <?Pub _font FontColor="#E7C24A"
?>SysLibTime<?Pub /_font?><?Pub _font FontColor="#E1E1E1"?>.<?Pub /_font
?><?Pub _font FontColor="#E7C24A"?>CurTime<?Pub /_font?><?Pub _font
FontColor="#E1E1E1"?>;<?Pub /_font?>
    <?Pub _font FontColor="#988DF7"?>UptimeMs<?Pub /_font?> <?Pub _font
FontColor="#EF724B"?>:<?Pub /_font?> <?Pub _font FontColor="#DBB740"
?>DWORD<?Pub /_font?><?Pub _font FontColor="#E1E1E1"?>;<?Pub /_font
?>           <?Pub _font FontColor="#5DA35B"?>(* Время работы в миллисекундах *)<?Pub /_font?>
<?Pub _font FontColor="#5684DD"?>END_VAR<?Pub /_font?>
<?Pub _font FontColor="#5DA35B"?>(* Вызов ФБ CurTime *)<?Pub /_font
?>
<?Pub _font FontColor="#DCDCDC"?>SysTime<?Pub /_font?><?Pub _font
FontColor="#E1E1E1"?>(<?Pub /_font?><?Pub _font FontColor="#E1E1E1"
?>)<?Pub /_font?><?Pub _font FontColor="#E1E1E1"?>;<?Pub /_font?>
<?Pub _font FontColor="#5DA35B"?>(* Чтение времени работы ПЛК *)<?Pub /_font
?>
<?Pub _font FontColor="#DCDCDC"?>UptimeMs<?Pub /_font?> <?Pub _font
FontColor="#EF724B"?>:=<?Pub /_font?> <?Pub _font FontColor="#DCDCDC"
?>SysTime<?Pub /_font?><?Pub _font FontColor="#E1E1E1"?>.<?Pub /_font
?><?Pub _font FontColor="#FFF2C5"?>SysTime<?Pub /_font?><?Pub _font
FontColor="#E1E1E1"?>.<?Pub /_font?><?Pub _font FontColor="#FFF2C5"
?>ulLow<?Pub /_font?><?Pub _font FontColor="#E1E1E1"?>;<?Pub /_font
?>
<?Pub _font FontColor="#5684DD"?>END_PROGRAM<?Pub /_font?></code></td></tr></tbody></table></div></div>

<a id="topic-122795"></a>

### CurTimeUs

**Функциональный блок CurTimeUs** считывает время в микросекундах, прошедшее с момента загрузки ПЛК. Содержит в себе структуру SysTime типа SysTime64.

| Имя переменной | Тип данных | Описание |
| --- | --- | --- |
| SysTime | SysTime64 | Структура |

**Содержимое структуры:**

| Имя переменной | Тип данных | Описание |
| --- | --- | --- |
| ulHigh | DWORD | Зарезервировано (всегда 0) |
| ulLow | DWORD | Время с момента загрузки ПЛК в микросекундах |

Пример:

<div><div><table><tbody><tr><td><?Pub _cellfont Shading="#2E3136"?><code>
<?Pub _font FontColor="#5684DD"?>VAR<?Pub /_font?>
    <?Pub _font FontColor="#5DA35B"?>(* Экземпляр ФБ CurTimeUs из библиотеки SysLibTime *)<?Pub /_font?>
    <?Pub _font FontColor="#988DF7"?>SysTime<?Pub /_font?> <?Pub _font
FontColor="#EF724B"?>:<?Pub /_font?> <?Pub _font FontColor="#E7C24A"
?>SysLibTime<?Pub /_font?><?Pub _font FontColor="#E1E1E1"?>.<?Pub /_font
?><?Pub _font FontColor="#E7C24A"?>CurTimeUs<?Pub /_font?><?Pub _font
FontColor="#E1E1E1"?>;<?Pub /_font?>
    <?Pub _font FontColor="#988DF7"?>UptimeUs<?Pub /_font?> <?Pub _font
FontColor="#EF724B"?>:<?Pub /_font?> <?Pub _font FontColor="#DBB740"
?>DWORD<?Pub /_font?><?Pub _font FontColor="#E1E1E1"?>;<?Pub /_font
?>           <?Pub _font FontColor="#5DA35B"?>(* Время работы в микросекундах *)<?Pub /_font?>
<?Pub _font FontColor="#5684DD"?>END_VAR<?Pub /_font?>
<?Pub _font FontColor="#5DA35B"?>(* Вызов ФБ CurTimeUs *)<?Pub /_font
?>
<?Pub _font FontColor="#DCDCDC"?>SysTime<?Pub /_font?><?Pub _font
FontColor="#E1E1E1"?>(<?Pub /_font?><?Pub _font FontColor="#E1E1E1"
?>)<?Pub /_font?><?Pub _font FontColor="#E1E1E1"?>;<?Pub /_font?>
<?Pub _font FontColor="#5DA35B"?>(* Чтение времени работы ПЛК *)<?Pub /_font
?>
<?Pub _font FontColor="#DCDCDC"?>UptimeUs<?Pub /_font?> <?Pub _font
FontColor="#EF724B"?>:=<?Pub /_font?> <?Pub _font FontColor="#DCDCDC"
?>SysTime<?Pub /_font?><?Pub _font FontColor="#E1E1E1"?>.<?Pub /_font
?><?Pub _font FontColor="#FFF2C5"?>SysTime<?Pub /_font?><?Pub _font
FontColor="#E1E1E1"?>.<?Pub /_font?><?Pub _font FontColor="#FFF2C5"
?>ulLow<?Pub /_font?><?Pub _font FontColor="#E1E1E1"?>;<?Pub /_font
?>
<?Pub _font FontColor="#5684DD"?>END_PROGRAM<?Pub /_font?></code></td></tr></tbody></table></div></div>