TaushkanovKV в 06:37, 27 апреля 2026

2026-04-27T06:37:57Z

TaushkanovKV: Новая страница: «Класс доступен начиная с версии `AS 1.6+`. ==Конструкторы== ===Конструктор по умолчанию===...»

2026-04-27T06:37:04Z

Новая страница: «Класс доступен начиная с версии <code>AS 1.6+</code>. ==Конструкторы== ===Конструктор по умолчанию===...»

Новая страница

Класс доступен начиная с версии <code>AS 1.6+</code>.
==Конструкторы==
===Конструктор по умолчанию===
datetime dt();
Создает объект с текущей датой и временем.
===Конструктор копирования===
datetime dt(other);
Создает копию существующего объекта datetime.
===Конструктор с параметрами===
datetime dt(year, month, day, hour = 0, minute = 0, second = 0);
Создает объект с указанной датой и временем.

=== Пример ===
// Только дата
datetime newYear = datetime(2024, 1, 1);

// Дата и время
datetime meeting = datetime(2024, 12, 25, 14, 30, 0);

// Полная спецификация
datetime exact = datetime(2024, 6, 15, 9, 45, 30);
==Методы==
<code>uint get_year() const</code>

Возвращает год (4 цифры).

<code>uint get_month() const</code>

Возвращает месяц (1-12).

<code>uint get_day() const</code>

Возвращает день месяца (1-31).

<code>uint get_hour() const</code>

Возвращает часы (0-23).

<code>uint get_minute() const</code>

Возвращает минуты (0-59).

<code>uint get_second() const</code>

Возвращает секунды (0-59).

'''Пример:'''
datetime dt = datetime(2024, 12, 25, 14, 30, 45);

uint year = dt.year; // 2024
uint month = dt.month; // 12
uint day = dt.day; // 25
uint hour = dt.hour; // 14
uint minute = dt.minute; // 30
uint second = dt.second; // 45
<code>bool setDate(year, month, day)</code>

Устанавливает дату. Возвращает <code>true</code> при успехе, <code>false</code> при неверной дате.

'''Пример:'''
datetime dt;
bool success = dt.setDate(2024, 2, 29); // true (високосный год)
bool invalid = dt.setDate(2023, 2, 29); // false (не високосный)
<code>bool setTime(hour, minute, second)</code>

Устанавливает время. Возвращает <code>true</code> при успехе, <code>false</code> при неверном времени.

'''Пример:'''

cpp
datetime dt;
bool success = dt.setTime(23, 59, 59); // true
bool invalid = dt.setTime(25, 0, 0); // false (часы > 23)
==Арифметические операции==
Вычитание дат
int64 difference = dt1 - dt2;
Возвращает разницу в секундах.
datetime start = datetime(2024, 1, 1, 0, 0, 0);
datetime end = datetime(2024, 1, 2, 0, 0, 0);
int64 diff = end - start; // 86400 секунд (1 день)
Сложение с секундами
datetime result = dt + seconds;
datetime result = seconds + dt; // обратный порядок
dt += seconds;
'''Пример:'''
datetime dt = datetime(2024, 1, 1, 10, 0, 0);

// Добавить 2 часа
datetime later = dt + 7200;
dt += 7200;

// Обратный порядок
datetime same = 7200 + dt;
Вычитание секунд
datetime result = dt - seconds;
datetime result = seconds - dt; // обратный порядок
dt -= seconds;
'''Пример:'''
datetime dt = datetime(2024, 1, 1, 10, 0, 0);

// Вычесть 30 минут
datetime earlier = dt - 1800;
dt -= 1800;
===Операции сравнения===
<code>bool opEquals(other)</code>

Проверка равенства дат.

<code>bool opLess(other)</code>

Проверка что дата раньше.

<code>int opCmp(other)</code>

Сравнение с возвратом -1 (меньше), 0 (равно), 1 (больше).

'''Пример:'''
datetime dt1 = datetime(2024, 1, 1);
datetime dt2 = datetime(2024, 1, 2);

if (dt1 < dt2) {
// dt1 раньше dt2
}

if (dt1 == dt2) {
// даты равны
}

int result = dt1.opCmp(dt2); // -1
==Практические примеры==
Пример 1: Таймер выполнения
datetime startTime;

// Выполняем некоторую операцию
for (int i = 0; i < 1000000; i++)
{
// какая-то работа
}

datetime endTime;
int64 elapsed = endTime - startTime;
print("Операция заняла: " + elapsed + " секунд");
Пример 2: Расчет дат событий
// Дата начала проекта
datetime projectStart = datetime(2024, 1, 15);

// Напоминание за 3 дня до дедлайна
datetime deadline = datetime(2024, 3, 1);
datetime reminder = deadline - 3 * 86400; // 3 дня в секундах

// Продление срока на 2 недели
datetime extendedDeadline = deadline + 14 * 86400;
Пример 3: Проверка рабочего времени
datetime currentTime;

// Создаем время начала и конца рабочего дня
datetime workStart = datetime(currentTime.year, currentTime.month,
currentTime.day, 9, 0, 0);
datetime workEnd = workStart + 8 * 3600; // 8 часов

if (currentTime >= workStart && currentTime <= workEnd)
{
print("Рабочее время");
}
else
{
print("Вне рабочего времени");
}
Пример 4: Валидация даты
bool createAppointment(uint year, uint month, uint day, uint hour)
{
datetime appointment;

// Проверяем корректность даты
if (!appointment.setDate(year, month, day)) {
print("Неверная дата!");
return false;
}

// Проверяем корректность времени
if (!appointment.setTime(hour, 0, 0)) {
print("Неверное время!");
return false;
}

// Проверяем что дата не в прошлом
datetime now;
if (appointment < now) {
print("Дата не может быть в прошлом!");
return false;
}

print("Встреча создана: " + appointment.year + "-" + appointment.month + "-" + appointment.day);
return true;
}
Пример 5: Разбивка интервала времени
datetime start = datetime(2024, 1, 1, 0, 0, 0);
datetime end = start + 365 * 86400; // +1 год

int64 totalSeconds = end - start;
int64 days = totalSeconds / 86400;
int64 hours = (totalSeconds % 86400) / 3600;
int64 minutes = (totalSeconds % 3600) / 60;
int64 seconds = totalSeconds % 60;

print("Интервал: " + days + " дней, " + hours + " часов, " + minutes + " минут, " + seconds + " секунд");

← Предыдущая		Версия 06:37, 27 апреля 2026
Строка 205:		Строка 205:

	print("Интервал: " + days + " дней, " + hours + " часов, " + minutes + " минут, " + seconds + " секунд");		print("Интервал: " + days + " дней, " + hours + " часов, " + minutes + " минут, " + seconds + " секунд");
		+
		+	[[Категория:AgavaSCADA/AgavaPLC]]

Класс datetime - История изменений

TaushkanovKV в 06:37, 27 апреля 2026

TaushkanovKV: Новая страница: «Класс доступен начиная с версии AS 1.6+. ==Конструкторы== ===Конструктор по умолчанию===...»

TaushkanovKV: Новая страница: «Класс доступен начиная с версии `AS 1.6+`. ==Конструкторы== ===Конструктор по умолчанию===...»