Канонические функции даты и времени
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 35Minute(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 5Second(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.