Канонические функции даты и времени

Entity SQL включает канонические функции даты и времени.

Замечания

В следующей таблице показаны канонические функции Сущности SQL даты и времени. datetimeDateTime— это значение.

Function	Description
AddNanoseconds(expression,number)	Добавляет указанное количество number наносекунд к значению expression. Аргументы expression: DateTime, DateTimeOffset или Time. number: Int32. Возвращаемое значение Тип параметра expression.
AddMicroseconds(expression,number)	Добавляет указанное количество number микросекунд к значению expression. Аргументы expression: DateTime, DateTimeOffset или Time. number: Int32. Возвращаемое значение Тип параметра expression.
AddMilliseconds(expression,number)	Добавляет указанное количество number миллисекунд к значению expression. Аргументы expression: DateTime, DateTimeOffset или Time. number: Int32. Возвращаемое значение Тип параметра expression.
AddSeconds(expression,number)	Добавляет указанное количество number секунд к значению expression. Аргументы expression: DateTime, DateTimeOffset или Time. number: Int32. Возвращаемое значение Тип параметра expression.
AddMinutes(expression,number)	Добавляет указанное количество number минут к значению expression. Аргументы expression: DateTime, DateTimeOffset или Time. number: Int32. Возвращаемое значение Тип параметра expression.
AddHours(expression,number)	Добавляет указанное количество number часов к значению expression. Аргументы expression: DateTime, DateTimeOffset или Time. number: Int32. Возвращаемое значение Тип параметра expression.
AddDays(expression,number)	Добавляет указанное количество number дней к значению expression. Аргументы expression: DateTime или DateTimeOffset. number: Int32. Возвращаемое значение Тип параметра expression.
AddMonths(expression,number)	Добавляет указанное количество number месяцев к значению expression. Аргументы expression: DateTime или DateTimeOffset. number: Int32. Возвращаемое значение Тип параметра expression.
AddYears(expression,number)	Добавляет указанное количество number лет к значению expression. Аргументы expression: DateTime или DateTimeOffset. number: Int32. Возвращаемое значение Тип параметра expression.
CreateDateTime(year,month,day,hour,minute,second)	Возвращает текущие дату и время сервера в часовом поясе сервера в виде нового значения DateTime. Аргументы year, month, day, hour, minute, Int16 и Int32. second: Double. Возвращаемое значение DateTime.
CreateDateTimeOffset(year,month,day,hour,minute,second,tzoffset)	Возвращает текущие дату и время сервера относительно времени в формате UTC в виде нового значения DateTimeOffset. Аргументы year, month, daytzoffsethourminuteInt32: . second: Double. Возвращаемое значение DateTimeOffset.
CreateTime(hour,minute,second)	Возвращает текущее время в виде нового значения Time. Аргументы hour, minute и Int32. second: Double. Возвращаемое значение Time.
CurrentDateTime()	Возвращает текущую дату и время сервера в часовом поясе сервера как значение типа DateTime. Возвращаемое значение DateTime.
CurrentDateTimeOffset()	Возвращает текущие дату, время и смещение в виде значения DateTimeOffset. Возвращаемое значение DateTimeOffset.
CurrentUtcDateTime()	DateTime Возвращает значение в качестве текущей даты и времени сервера в часовом поясе UTC. Возвращаемое значение DateTime.
Day(expression)	Возвращает относящуюся к числу месяца часть значения expression в качестве значения типа Int32 от 1 до 31. Аргументы Значение типа DateTime и DateTimeOffset. Возвращаемое значение Объект Int32. Пример -- The following example returns 12. Day(cast('03/12/1998' as DateTime))
DayOfYear(expression)	Возвращает относящуюся к дню года часть значения expression в виде значения типа Int32 от 1 до 366, где значение 366 возвращается для последнего дня високосного года. Аргументы DateTime или DateTimeOffset. Возвращаемое значение Объект Int32.
DiffNanoseconds(startExpression,endExpression)	Возвращает разность между startExpression и endExpression в наносекундах. Аргументы startExpression, endExpression, DateTime, DateTimeOffset или Time Примечание. startExpression И endExpression должен иметь один и тот же тип. Возвращаемое значение Объект Int32.
DiffMilliseconds(startExpression,endExpression)	Возвращает разность между startExpression и endExpression в миллисекундах. Аргументы startExpression, endExpression, DateTime, DateTimeOffset или Time Примечание. startExpression И endExpression должен иметь один и тот же тип. Возвращаемое значение Объект Int32.
DiffMicroseconds(startExpression,endExpression)	Возвращает разность между startExpression и endExpression в микросекундах. Аргументы startExpression, endExpression, DateTime, DateTimeOffset или Time Примечание. startExpression И endExpression должен иметь один и тот же тип. Возвращаемое значение Объект Int32.
DiffSeconds(startExpression,endExpression)	Возвращает разность между startExpression и endExpression в секундах. Аргументы startExpression, endExpression, DateTime, DateTimeOffset или Time Примечание. startExpression И endExpression должен иметь один и тот же тип. Возвращаемое значение Объект Int32.
DiffMinutes(startExpression,endExpression)	Возвращает разность между startExpression и endExpression в минутах. Аргументы startExpression, endExpression, DateTime, DateTimeOffset или Time Примечание. startExpression И endExpression должен иметь один и тот же тип. Возвращаемое значение Объект Int32.
DiffHours(startExpression,endExpression)	Возвращает разность между startExpression и endExpression в часах. Аргументы startExpression, endExpression, DateTime, DateTimeOffset или Time Примечание. startExpression И endExpression должен иметь один и тот же тип. Возвращаемое значение Объект Int32.
DiffDays(startExpression,endExpression)	Возвращает разность между startExpression и endExpression в днях. Аргументы startExpression, endExpression: DateTime или DateTimeOffset. Примечание. startExpression И endExpression должен иметь один и тот же тип. Возвращаемое значение Объект Int32.
DiffMonths(startExpression,endExpression)	Возвращает разность между startExpression и endExpression в месяцах. Аргументы startExpression, endExpression: DateTime или DateTimeOffset. Примечание. startExpression И endExpression должен иметь один и тот же тип. Возвращаемое значение Объект Int32.
DiffYears(startExpression,endExpression)	Возвращает разность между startExpression и endExpression в годах. Аргументы startExpression, endExpression: DateTime или DateTimeOffset. Примечание. startExpression И endExpression должен иметь один и тот же тип. Возвращаемое значение Объект Int32.
GetTotalOffsetMinutes(datetimeoffset)	Возвращает число минут, на которые datetimeoffset смещено относительно времени по Гринвичу (GMT). Обычно это значение находится в диапазоне от +780 до -780 (плюс-минус 13 ч). Примечание. Эта функция поддерживается только в SQL Server 2008. Аргументы DateTimeOffset. Возвращаемое значение Объект Int32.
Hour(expression)	Возвращает для expression значение часа типа Int32 от 0 до 23. Аргументы Значение типа DateTime, Time и DateTimeOffset. Пример -- The following example returns 22. Hour(cast('22:35:5' as DateTime))
Millisecond(expression)	Возвращает для expression значение миллисекунд типа Int32 от 0 до 999. Аргументы Значение типа DateTime, Time и DateTimeOffset. Возвращаемое значение Объект Int32.
Minute(expression)	Возвращает для expression значение минут типа Int32 от 0 до 59. Аргументы DateTime, Time или DateTimeOffset. Возвращаемое значение Объект Int32. Пример -- The following example returns 35 Minute(cast('22:35:5' as DateTime))
Month(expression)	Возвращает для expression значение месяца типа Int32 от 1 до 12. Аргументы DateTime или DateTimeOffset. Возвращаемое значение Объект Int32. Пример -- The following example returns 3. Month(cast('03/12/1998' as DateTime))
Second(expression)	Возвращает для expression значение секунд типа Int32 от 0 до 59. Аргументы Значение типа DateTime, Time и DateTimeOffset. Возвращаемое значение Объект Int32. Пример -- The following example returns 5 Second(cast('22:35:5' as DateTime))
TruncateTime(expression)	Возвращает значение expression с усеченным значением времени. Аргументы DateTime или DateTimeOffset. Возвращаемое значение Тип параметра expression.
Year(expression)	Возвращает часть expression года в виде Int32 YYYY. Аргументы Значение типа DateTime и DateTimeOffset. Возвращаемое значение Объект Int32. Пример -- The following example returns 1998. Year(cast('03/12/1998' as DateTime))

Эти функции возвращают null при получении на входе null.

Эквивалентную функциональность предоставляет управляемый поставщик клиента Microsoft SQL. Дополнительные сведения см. в разделе SqlClient для функций Entity Framework.

См. также

• Канонические функции