Dela via


Kanoniska funktioner för datum och tid

Entitets-SQL innehåller kanoniska funktioner för datum och tid.

Kommentarer

I följande tabell visas datum och tid för entitets-SQL-kanoniska funktioner. datetime är ett DateTime värde.

Function beskrivning
AddNanoseconds(expression,number) Lägger till angivet number nanosekunder till expression.

Argument

expression: DateTime, DateTimeOffset, eller Time.

number: Int32.

Returvärde

Typen av expression.
AddMicroseconds(expression,number) Lägger till den angivna number mikrosekunderna i expression.

Argument

expression: DateTime, DateTimeOffset, eller Time.

number: Int32.

Returvärde

Typen av expression.
AddMilliseconds(expression,number) Lägger till angivet number millisekunder i expression.

Argument

expression: DateTime, DateTimeOffset, eller Time.

number: Int32.

Returvärde

Typen av expression.
AddSeconds(expression,number) Lägger till den angivna number sekunden i expression.

Argument

expression: DateTime, DateTimeOffset, eller Time.

number: Int32.

Returvärde

Typen av expression.
AddMinutes(expression,number) Lägger till det angivna number antalet minuter i expression.

Argument

expression: DateTime, DateTimeOffset, eller Time.

number: Int32.

Returvärde

Typen av expression.
AddHours(expression,number) Lägger till det angivna number antalet timmar i expression.

Argument

expression: DateTime, DateTimeOffset, eller Time.

number: Int32.

Returvärde

Typen av expression.
AddDays(expression,number) Lägger till det angivna number antalet dagar i expression.

Argument

expression: DateTime eller DateTimeOffset.

number: Int32.

Returvärde

Typen av expression.
AddMonths(expression,number) Lägger till de angivna number månaderna i expression.

Argument

expression: DateTime eller DateTimeOffset.

number: Int32.

Returvärde

Typen av expression.
AddYears(expression,number) Lägger till angivna number år i expression.

Argument

expression: DateTime eller DateTimeOffset.

number: Int32.

Returvärde

Typen av expression.
CreateDateTime(year,month,day,hour,minute,second) Returnerar ett nytt DateTime värde som aktuellt datum och tid för servern i serverns tidszon.

Argument

year, month, day, hour, minute: Int16 och Int32.

second: Double.

Returvärde

En DateTime.
CreateDateTimeOffset(year,month,day,hour,minute,second,tzoffset) Returnerar ett nytt DateTimeOffset värde som aktuellt datum och tid för servern i förhållande till UTC (Coordinated Universal Time).

Argument

year, month, day, hour, minute, tzoffset: Int32.

second: Double.

Returvärde

En DateTimeOffset.
CreateTime(hour,minute,second) Returnerar ett nytt Time värde som aktuell tid.

Argument

hour och minute: Int32.

second: Double.

Returvärde

En Time.
CurrentDateTime() Returnerar ett DateTime värde som aktuellt datum och tid för servern i serverns tidszon.

Returvärde

En DateTime.
CurrentDateTimeOffset() Returnerar aktuellt datum, tid och förskjutning som en DateTimeOffset.

Returvärde

En DateTimeOffset.
CurrentUtcDateTime() Returnerar ett DateTime värde som aktuellt datum och tid för servern i UTC-tidszonen.

Returvärde

En DateTime.
Day(expression) Returnerar dagsdelen av expression som mellan Int32 1 och 31.

Argument

A DateTime och DateTimeOffset.

Returvärde

En Int32.

Exempel

-- The following example returns 12.

Day(cast('03/12/1998' as DateTime))
DayOfYear(expression) Returnerar dagsdelen av expression som mellan Int32 1 och 366, där 366 returneras för den sista dagen i ett skottår.

Argument

A DateTime eller DateTimeOffset.

Returvärde

En Int32.
DiffNanoseconds(startExpression,endExpression) Returnerar skillnaden, i nanosekunder, mellan startExpression och endExpression.

Argument

startExpression, endExpression: DateTime, DateTimeOffseteller Time. startExpression Obs! och endExpression måste vara av samma typ.

Returvärde

En Int32.
DiffMilliseconds(startExpression,endExpression) Returnerar skillnaden, i millisekunder, mellan startExpression och endExpression.

Argument

startExpression, endExpression: DateTime, DateTimeOffseteller Time. startExpression Obs! och endExpression måste vara av samma typ.

Returvärde

En Int32.
DiffMicroseconds(startExpression,endExpression) Returnerar skillnaden i mikrosekunder mellan startExpression och endExpression.

Argument

startExpression, endExpression: DateTime, DateTimeOffseteller Time. startExpression Obs! och endExpression måste vara av samma typ.

Returvärde

En Int32.
DiffSeconds(startExpression,endExpression) Returnerar skillnaden, i sekunder, mellan startExpression och endExpression.

Argument

startExpression, endExpression: DateTime, DateTimeOffseteller Time. startExpression Obs! och endExpression måste vara av samma typ.

Returvärde

En Int32.
DiffMinutes(startExpression,endExpression) Returnerar skillnaden, i minuter, mellan startExpression och endExpression.

Argument

startExpression, endExpression: DateTime, DateTimeOffseteller Time. startExpression Obs! och endExpression måste vara av samma typ.

Returvärde

En Int32.
DiffHours(startExpression,endExpression) Returnerar skillnaden i timmar mellan startExpression och endExpression.

Argument

startExpression, endExpression: DateTime, DateTimeOffseteller Time. startExpression Obs! och endExpression måste vara av samma typ.

Returvärde

En Int32.
DiffDays(startExpression,endExpression) Returnerar skillnaden, i dagar, mellan startExpression och endExpression.

Argument

startExpression, endExpression: DateTime eller DateTimeOffset. startExpression Obs! och endExpression måste vara av samma typ.

Returvärde

En Int32.
DiffMonths(startExpression,endExpression) Returnerar skillnaden, i månader, mellan startExpression och endExpression.

Argument

startExpression, endExpression: DateTime eller DateTimeOffset. startExpression Obs! och endExpression måste vara av samma typ.

Returvärde

En Int32.
DiffYears(startExpression,endExpression) Returnerar skillnaden, i år, mellan startExpression och endExpression.

Argument

startExpression, endExpression: DateTime eller DateTimeOffset. startExpression Obs! och endExpression måste vara av samma typ.

Returvärde

En Int32.
GetTotalOffsetMinutes(datetimeoffset) Returnerar antalet minuter som är förskjutet datetimeoffset från GMT. Detta är vanligtvis mellan +780 och -780 (+ eller - 13 timmar). Obs! Den här funktionen stöds endast i SQL Server 2008.

Argument

En DateTimeOffset.

Returvärde

En Int32.
Hour(expression) Returnerar timdelen av expression som mellan Int32 0 och 23.

Argument

A DateTime, Time och DateTimeOffset.

Exempel

-- The following example returns 22.

Hour(cast('22:35:5' as DateTime))
Millisecond(expression) Returnerar millisekundersdelen av expression som mellan Int32 0 och 999.

Argument

A DateTime, Time och DateTimeOffset.

Returvärde

En Int32.
Minute(expression) Returnerar minutdelen av expression som mellan Int32 0 och 59.

Argument

A DateTime, Time eller DateTimeOffset.

Returvärde

En Int32.

Exempel

-- The following example returns 35

Minute(cast('22:35:5' as DateTime))
Month(expression) Returnerar månadsdelen av expression som mellan Int32 1 och 12.

Argument

A DateTime eller DateTimeOffset.

Returvärde

En Int32.

Exempel

-- The following example returns 3.

Month(cast('03/12/1998' as DateTime))
Second(expression) Returnerar sekunddelen av expression som mellan Int32 0 och 59.

Argument

A DateTime, Time och DateTimeOffset.

Returvärde

En Int32.

Exempel

-- The following example returns 5

Second(cast('22:35:5' as DateTime))
TruncateTime(expression) expressionReturnerar , med tidsvärdena trunkerade.

Argument

A DateTime eller DateTimeOffset.

Returvärde

Typen av expression.
Year(expression) Returnerar årsdelen av expression som en Int32 YYYY.

Argument

A DateTime och DateTimeOffset.

Returvärde

En Int32.

Exempel

-- The following example returns 1998.

Year(cast('03/12/1998' as DateTime))

Dessa funktioner returneras null om de ges null indata.

Motsvarande funktioner är tillgängliga i Microsoft SQL Client Managed Provider. Mer information finns i SqlClient för Entity Framework Functions.

Se även