Admin: 1 revision imported

2021-02-07T06:51:14Z

1 revision imported

Admin: /* Синтаксис */

2019-06-26T15:47:15Z

‎Синтаксис

New page

{{infobox function
|name=GetPeriod
|caption=Функции работы с датами
|type=1
|status=2
|db=0
|exception=Невозможно превратить в дату, число
|visual=0}}
{{HeadLinks|
* [[Main_Page|Начальная страница]]
* [[Общее_описание_языка|Общее описание]]
* [[Функции работы с датами]]}}
Функция получает величину времени, прошедшего с даты первого аргумента до даты второго аргумента, выраженную в указанных единицах. Функция может использоваться для определения времени, которое заняла определенная операция, либо цикл ожидания, однако, нужно понимать, что период времени вычисляется на основе системных часов, что приведет к некорректному результату функции, если системное время было изменено после получения начальной даты периода (<Дата 1>). Кроме того, данная функция обеспечивает точность не более десятков миллисекунд, так как точность системных часов компьютера обычно невелика. Чтобы получить большую точность при измерении периода и избавиться от зависимости от системных часов, можно использовать функцию [[dbgHRPCGetPeriod]], однако, последняя подразумевает, что компьютер имеет таймер высокой точности, и оный переведен в рабочее состояние (обычно включение такого таймера происходит в BIOSе компьютера).

== Синтаксис ==
<code>
'''GetPeriod'''(''<Дата 1>'',''<Дата 2>''{{Optional|,<Режим (INT)>{{Default|{{Eq}}0}}}}):''<Результат (NUMBER)>''
</code>
==== Аргументы ====
* <code>''<Дата 1>''</code> - Дата и время начала периода
* <code>''<Дата 2>''</code> - Дата и время окончания периода (обычно текущая дата)
* <code>''<Режим (INT)>''</code> - Единицы измерения, в которых будет получен период. Возможны следующие значения:
** '''0''' (по умолчанию) -- вещественное число, целая часть которого показывает количество прошедших дней, дробная же часть отвечает за единицы измерения меньше дня. К примеру <code>Trunc(<Результат GetPeriod>)</code> будет отдавать число прошедших дней, <code>Trunc(<Результат GetPeriod>*24)</code> будет отдавать число прошедших часов и т.д.
** '''1''' -- разница между двумя датами в днях (целое число)
** '''2''' -- разница между двумя датами в часах (целое число)
** '''3''' -- разница между двумя датами в минутах (целое число)
** '''4''' -- разница между двумя датами в секундах (целое число)
** '''5''' -- разница между двумя датами в миллисекундах (целое число). Нужно заметить, что максимальное разрешение системных часов обычно не превышает десятков миллисекунд.
==== Возвращаемое значение ====
Возвращает значение типа число (целое или вещественное в зависимости от режима).

== Примеры ==
<pre>
Message(GetPeriod('31.01.2012','31.01.2024',1));
//Будет выведено 4383 (прошло дней)

Дата1:=Date();
Sleep(1250);
Message(GetPeriod(Дата1,Date(),5));
//Будет выведено число около 1260 (прошло миллисекунд, число не будет равно 1250, так как остальные инструкции также занимают некоторое время)
</pre>

← Older revision	Revision as of 06:51, 7 February 2021
(No difference)

GetPeriod - Revision history

Admin: 1 revision imported

Admin: /* Синтаксис */