Поделиться через

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

  • Статья

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

Замечания

В следующей таблице приведены канонические функции даты и времени Entity SQL . datetime представляет значение типа DateTime.

Функция Описание

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, day, hour, minute, tzoffset: Int32.

second: Double.

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

Объект DateTimeOffset.

CreateTime( hour, minute, second)

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

Аргументы

hour, minute и Int32.

second: Double.

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

Объект Time.

CurrentDateTime()

Возвращает текущую дату и время сервера в часовом поясе сервера как значение типа DateTime.

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

Объект DateTime.

CurrentDateTimeOffset()

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

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

Объект DateTimeOffset.

CurrentUtcDateTime()

Возвращает текущие дату и время сервера по Гринвичу в виде значения типа DateTime.

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

Объект 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

Bb738563.note(ru-ru,VS.100).gifПримечание
startExpression и endExpression должны относиться к одному типу.

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

Int32.

DiffMilliseconds( startExpression, endExpression)

Возвращает разность между startExpression и endExpression в миллисекундах.

Аргументы

startExpression, endExpression, DateTime, DateTimeOffset или Time

Bb738563.note(ru-ru,VS.100).gifПримечание
startExpression и endExpression должны относиться к одному типу.

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

Int32.

DiffMicroseconds( startExpression, endExpression)

Возвращает разность между startExpression и endExpression в микросекундах.

Аргументы

startExpression, endExpression, DateTime, DateTimeOffset или Time

Bb738563.note(ru-ru,VS.100).gifПримечание
startExpression и endExpression должны относиться к одному типу.

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

Int32.

DiffSeconds( startExpression, endExpression)

Возвращает разность между startExpression и endExpression в секундах.

Аргументы

startExpression, endExpression, DateTime, DateTimeOffset или Time

Bb738563.note(ru-ru,VS.100).gifПримечание
startExpression и endExpression должны относиться к одному типу.

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

Int32.

DiffMinutes( startExpression, endExpression)

Возвращает разность между startExpression и endExpression в минутах.

Аргументы

startExpression, endExpression, DateTime, DateTimeOffset или Time

Bb738563.note(ru-ru,VS.100).gifПримечание
startExpression и endExpression должны относиться к одному типу.

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

Int32.

DiffHours( startExpression, endExpression)

Возвращает разность между startExpression и endExpression в часах.

Аргументы

startExpression, endExpression, DateTime, DateTimeOffset или Time

Bb738563.note(ru-ru,VS.100).gifПримечание
startExpression и endExpression должны относиться к одному типу.

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

Int32.

DiffDays( startExpression, endExpression)

Возвращает разность между startExpression и endExpression в днях.

Аргументы

startExpression, endExpression: DateTime или DateTimeOffset.

Bb738563.note(ru-ru,VS.100).gifПримечание
startExpression и endExpression должны относиться к одному типу.

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

Int32.

DiffMonths( startExpression, endExpression)

Возвращает разность между startExpression и endExpression в месяцах.

Аргументы

startExpression, endExpression: DateTime или DateTimeOffset.

Bb738563.note(ru-ru,VS.100).gifПримечание
startExpression и endExpression должны относиться к одному типу.

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

Int32.

DiffYears( startExpression, endExpression)

Возвращает разность между startExpression и endExpression в годах.

Аргументы

startExpression, endExpression: DateTime или DateTimeOffset.

Bb738563.note(ru-ru,VS.100).gifПримечание
startExpression и endExpression должны относиться к одному типу.

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

Int32.

GetTotalOffsetMinutes( datetimeoffset )

Возвращает число минут, на которые datetimeoffset смещено относительно времени по Гринвичу (GMT). Обычно это значение находится в диапазоне от +780 до -780 (плюс или минус 13 часов).

Bb738563.note(ru-ru,VS.100).gifПримечание
Эта функция поддерживается только в 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))

Truncate( 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. Дополнительные сведения см. в разделе Функции поставщика данных .NET Framework для SQL Server (SqlClient) на платформе Entity Framework.

См. также

Основные понятия

Канонические функции (язык Entity SQL)