Возвращает текущие дату и время в виде значения типа "дата-время" (DateTime) или создаёт значение типа DateTime, совместимое с принятым для решения проблемы 2000-го года (year 2000-compliant).

DATETIME([nYear, nMonth, nDay [, nHours [, nMinutes [, nSeconds]]]])

Параметры

nYear

Задает год, возвращаемый в значении типа DateTime, совместимом с принятым для решения проблемы 2000-го года. nYear может быть числом от 100 до 9999.
nMonth

Задает номер месяца в году, возвращаемом в значении типа DateTime, совместимом с принятым для решения проблемы 2000-го года. nMonth может быть числом от 1 до 12.
nDay

Задает номер дня в месяце, возвращаемом в значении типа DateTime, совместимом с принятым для решения проблемы 2000-го года. nDay может быть числом от 1 до 31.
nHours

Задает номер часа в дне, возвращаемом в значении типа DateTime, совместимом с принятым для решения проблемы 2000-го года. nHours может иметь значение от 0 (полночь) to 23 (11 P.M). Если параметр опущен, его значение принимается равным 0.
nMinutes

Задает номер минуты в часе, возвращаемом в значении типа DateTime, совместимом с принятым для решения проблемы 2000-го года. nMinutes может иметь значение от 0 до 59. Если параметр опущен, его значение принимается равным 0.
nSeconds

Задает номер секунды в минуте, возвращаемой в значении типа DateTime, совместимом с принятым для решения проблемы 2000-го года. nSeconds может иметь значение от 0 до 59. Если параметр опущен, его значение принимается равным 0.

Возвращаемое значение

DateTime

Замечания

Функция DATETIME( ) возвращает значение системных даты и времени, если её вызвать без указания аргументов. Любые параметры NULL, составляющие дату, замещаются текущими системными значениями. Параметры NULL, задающие время, вызовут замещение указанного времени значением 12:00:00.

Прим.переводчика: По крайней мере при региональных установках "Use system settings" для России, параметры NULL в элементах, задающих время, замещаются нулевыми значениями, в том числе и для часов. Так, вызов DATETIME(null,null,null,null,null,5) возвращает системную дату и время 0:0:05

Включите опциональные аргументы для возврата значения, совместимого с принятым для решения проблемы 2000-го года в формате, указанном в Regional tab диалогового блока Options.

Пример

В первом примерер значение типа Datetime с датой Нового года заносится в переменную tNewyear, а текущее значение системной даты и времени заносится в переменную tToday. Затем отображается число секунд, находящихся во временном интервале между этими двумя значениями.

Во втором примере используется функция DATETIME( ) для создания значения типа DateTime в формате, совместимом с принятым для решения проблемы 2000-го года.

  Скопировать код
tNewyear = DATETIME(YEAR(DATE( ) ) + 1, 1, 1) && Next New Year
tToday = DATETIME( )
nSecondstonewyear = tNewyear - tToday
CLEAR
? "There are " + ALLTRIM (STR(nSecondstonewyear)) ;
 + " seconds to the next New Year."

CLEAR
SET CENTURY ON
SET DATE TO AMERICAN
? DATETIME(1998, 02, 16, 12, 34, 56) && Displays 02/16/1998 12:34:56 PM

См.также