Дата и время
Дата и время в системе представляют собой один формат, который включает даты (начиная от '01.01.1601') и время с точностью до миллисекунды. При получении текущей даты, результат также будет включать в себя текущее время. Стандартная запись даты и времени в системе имеет вид: DD.MM.YYYY [HH:MM[:SS[.PPP]]], при этом используется 24-часовой формат. При указании константы даты и времени в тексте программы, оная должна быть заключена в апострофы ('), для указания на разницу в формате данных, в данной документации все даты тоже заключены в апострофы, строки в двойные кавычки, а цифры не имеют дополнительных указателей на формат данных. При превращении даты и времени из строки (к примеру, функцией Date, либо при указании даты в виде константы в исходном тесте программы) может использоваться несколько форматов, показанных ниже. Система может использовать только указанные форматы для создания даты и времени из строки или при компиляции текста программы:
[Д]Д.[М]М.ГГ[ГГ][ [Ч]Ч:[М]М[:[С]С]]-- Стандартный формат записи. Примеры:'10.12.2012','31.01.2020 12:00','3.6.25 4:12:11'[М]М/[Д]Д/ГГ[ГГ][ [Ч]Ч:[М]М[:[С]С]]-- Американский формат, разделителем является знак /. Время по-прежнему задается в 24-х часовом формате. Примеры:'12/10/2012','01/31/2020 12:00','6/3/25 4:12:11'[Д]Д-[М]М-ГГ[ГГ][ [Ч]Ч:[М]М[:[С]С]]-- Стандартный формат с разделителем -. Примеры:'10-12-2012','31-01-2020 12:00','3-6-25 4:12:11'
Увеличение или уменьшение даты на определенное количество дней можно осуществлять простым прибавлением к ней целого числа, равного необходимому количеству дней (к примеру, '01.01.2020'+12 будет давать дату '13.01.2020'), также можно использовать функцию AddDay.
Пустой датой называется любая дата равная или меньше '01.01.1601'. Функция isEmpty может использоваться для проверки, является ли дата пустой. Пустые даты могут применяться в разных функциях, связанных с базой данных (при установке периодических значений и пр.) для указания на дату начала времен (или отсутствие аргумента), также как и в некоторых общих функциях системы.
При простом превращении даты и времени в строку (к примеру, прибавляя дату к строке или используя функции Str, Message и пр.), время обычно не будет отражено в результате. Для форматирования даты вместе со временем, можно использовать функцию FormatDate.
Ниже показаны примеры некоторых функций, для работы датой и временем и прямыми и обратными пребразованиями в формат даты:
- Функции получения текущей даты и времени Date, CurTime, CurHour, CurMinute, CurSecond и пр.
- Функции для преобразования объекта в дату и время из текстового формата и обратно в текстовый формат: Str, Date, FormatDate , GetTime и пр.
- Функции для преобразования (изменения) даты и времени переменной: AddYear, AddMonth, AddDay, AddHour, AddMinute, BegOfDay, BegOfMonth, BegOfQuarter, BegOfYear, BegOfWeek, SetTime и пр.
