Дата и время

Группа функций, обеспечивающих работу с данными типа datetime (целое число, представляющее собой количество секунд, прошедших с 0 часов 1 января 1970 года).

Day

int Day()

Возвращает текущий день месяца, т.е день месяца последнего известного времени сервера.
Замечание: при тестировании последнее известное время сервера моделируется.

Пример:

if(Day()<5)
  return(0);

 

DayOfWeek

int DayOfWeek()

Возвращает порядковый номер дня недели (воскресенье-0,1,2,3,4,5,6) последнего известного времени сервера.
Замечание: при тестировании последнее известное время сервера моделируется.

Пример:

// не работает в выходные дни.
if(DayOfWeek()==0 || DayOfWeek()==6)
  return(0);

 

DayOfYear

int DayOfYear()

Возвращает текущий день года (1-1 января,..,365(6) — 31 декабря), т.е день года последнего известного времени сервера.
Замечание: при тестировании последнее известное время сервера моделируется.

Пример:

if(DayOfYear()==245)
  return(true);

 

Hour

int Hour()

Возвращает текущий час (0,1,2,..23) последнего известного серверного времени на момент старта программы (в процессе выполнения программы это значение не меняется).
Замечание: при тестировании последнее известное время сервера моделируется.

Пример:

bool is_siesta=false;
if(Hour()>=12 || Hour()<17)
  is_siesta=true;

 

Minute

int Minute()

Возвращает текущую минуту (0,1,2,..59) последнего известного серверного времени на момент старта программы (в процессе выполнения программы это значение не меняется).
Замечание: при тестировании последнее известное время сервера моделируется.

Пример:

if(Minute()<=15)
 return("first quarter");

 

Month

int Month()

Возвращает номер текущего месяца (1-Январь,2,3,4,5,6,7,8,9,10,11,12), т.е. номер месяца последнего известного времени сервера.
Замечание: при тестировании последнее известное время сервера моделируется.

Пример:

if(Month()<=5)
  return("первое полугодие");

 

Seconds

int Seconds()
Возвращает количество секунд, прошедших с начала текущей минуты последнего известного серверного времени на момент старта программы (в процессе выполнения программы это значение не меняется).
Замечание: при тестировании последнее известное время сервера моделируется.

Пример:

if(Seconds()<=15)
  return(0);

 

TimeCurrent

datetime TimeCurrent()

Возвращает последнее известное время сервера (время прихода последней котировки) в виде количества секунд, прошедших после 00:00 1 января 1970 года.

Замечание: при тестировании последнее известное время сервера моделируется.

Пример:

if(TimeCurrent()-OrderOpenTime()<360)
  return(0);

 

TimeDay

int TimeDay(datetime date)

Возвращает день месяца (1 — 31) для указанной даты.

Параметры:

date — Дата, представленная в виде количества секунд, прошедших после 00:00 1 января 1970 года.

Пример:

int day=TimeDay(D'2017.12.31');
// день 31

 

TimeDayOfWeek

int TimeDayOfWeek(datetime date)

Возвращает день недели (0-Воскресенье,1,2,3,4,5,6) для указанной даты.

Параметры:

date — Дата, представленная в виде количества секунд, прошедших после 00:00 1 января 1970 года.

Пример:

int weekday=TimeDayOfWeek(D'2004.11.2');
// день 2 - вторник

 

TimeDayOfYear

int TimeDayOfYear(datetime date)

Возвращает день (1 — 1 января,..,365(6) — 31 декабря) года для указанной даты.

Параметры:

date — Дата, представленная в виде количества секунд, прошедших после 00:00 1 января 1970 года.

Пример:

int day=TimeDayOfYear(TimeCurrent());

 

TimeHour

int TimeHour(datetime time)

Возвращает час для указанного времени.

Параметры:

time — Дата, представленная в виде количества секунд, прошедших после 00:00 1 января 1970 года.

Пример:

int h = TimeHour(TimeCurrent());

 

TimeLocal

datetime TimeLocal()

Возвращает локальное компьютерное время в виде количества секунд, прошедших после 00:00 1 января 1970 года.
Замечание: при тестировании локальное время моделируется и совпадает с моделированным последним известным временем сервера.

Пример:

if(TimeLocal()-OrderOpenTime()<360)
   return(0);

 

TimeMinute

int TimeMinute(datetime time)

Возвращает минуты для указанного времени.

Параметры:

time — Дата, представленная в виде количества секунд, прошедших после 00:00 1 января 1970 года.

Пример:

int m = TimeMinute(TimeCurrent());

 

TimeMonth

int TimeMonth(datetime time)

Возвращает номер месяца для указанного времени (1-Январь,2,3,4,5,6,7,8,9,10,11,12).

Параметры:

time — Дата, представленная в виде количества секунд, прошедших после 00:00 1 января 1970 года.

Пример:

int m=TimeMonth(TimeCurrent());

 

TimeSeconds

int TimeSeconds(datetime time)

Возвращает количество секунд, прошедших с начала минуты для указанного времени.

Параметры:

time — Дата, представленная в виде количества секунд, прошедших после 00:00 1 января 1970 года.

Пример:

int m = TimeSeconds(TimeCurrent());

 

TimeYear

int TimeYear(datetime time)

Возвращает год для указанной даты. Возвращаемая величина может быть в диапазоне 1970-2037.

Параметры:

time — Дата, представленная в виде количества секунд, прошедших после 00:00 1 января 1970 года.

Пример:

int y=TimeYear(TimeCurrent());

 

Year

int Year()

Возвращает текущий год, т.е. год последнего известного времени сервера.
Замечание: при тестировании последнее известное время сервера моделируется.

Пример:

// возврат, если дата находится в диапазоне от 1 января до 30 апреля 2016 года.
if(Year()==2016 && Month()<5)
  return(0);