Udostępnij za pośrednictwem


Funkcji daty i godziny Canonical

Język Entity SQL zawiera funkcje kanoniczne daty i godziny.

Uwagi

W poniższej tabeli przedstawiono funkcje kanoniczne Data i godzina jednostki SQL. datetime jest wartością DateTime .

Function opis
AddNanoseconds(expression,number) Dodaje określone number nanosekundy do .expression

Argumenty

expression: DateTime, lub DateTimeOffsetTime.

number: Int32.

Wartość zwracana

Typ .expression
AddMicroseconds(expression,number) Dodaje określone number mikrosekundy do obiektu expression.

Argumenty

expression: DateTime, lub DateTimeOffsetTime.

number: Int32.

Wartość zwracana

Typ .expression
AddMilliseconds(expression,number) Dodaje określoną number liczbę milisekund do .expression

Argumenty

expression: DateTime, lub DateTimeOffsetTime.

number: Int32.

Wartość zwracana

Typ .expression
AddSeconds(expression,number) Dodaje określoną number liczbę sekund do elementu expression.

Argumenty

expression: DateTime, lub DateTimeOffsetTime.

number: Int32.

Wartość zwracana

Typ .expression
AddMinutes(expression,number) Dodaje określoną number liczbę minut do elementu expression.

Argumenty

expression: DateTime, lub DateTimeOffsetTime.

number: Int32.

Wartość zwracana

Typ .expression
AddHours(expression,number) Dodaje określoną number liczbę godzin do obiektu expression.

Argumenty

expression: DateTime, lub DateTimeOffsetTime.

number: Int32.

Wartość zwracana

Typ .expression
AddDays(expression,number) Dodaje określoną number liczbę dni do elementu expression.

Argumenty

expression: DateTime lub DateTimeOffset.

number: Int32.

Wartość zwracana

Typ .expression
AddMonths(expression,number) Dodaje określoną number liczbę miesięcy do elementu expression.

Argumenty

expression: DateTime lub DateTimeOffset.

number: Int32.

Wartość zwracana

Typ .expression
AddYears(expression,number) Dodaje określony number rok do elementu expression.

Argumenty

expression: DateTime lub DateTimeOffset.

number: Int32.

Wartość zwracana

Typ .expression
CreateDateTime(year,month,day,hour,minute,second) Zwraca nową DateTime wartość jako bieżącą datę i godzinę serwera w strefie czasowej serwera.

Argumenty

year, , month, day, minutehour, : Int16 i Int32.

second: Double.

Wartość zwracana

Klasa DateTime.
CreateDateTimeOffset(year,month,day,hour,minute,second,tzoffset) Zwraca nową DateTimeOffset wartość jako bieżącą datę i godzinę serwera względem uniwersalnego czasu koordynowanego (UTC).

Argumenty

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

second: Double.

Wartość zwracana

Klasa DateTimeOffset.
CreateTime(hour,minute,second) Zwraca nową Time wartość jako bieżącą godzinę.

Argumenty

hour i minute: Int32.

second: Double.

Wartość zwracana

Klasa Time.
CurrentDateTime() Zwraca wartość jako bieżącą DateTime datę i godzinę serwera w strefie czasowej serwera.

Wartość zwracana

Klasa DateTime.
CurrentDateTimeOffset() Zwraca bieżącą datę, godzinę i przesunięcie jako DateTimeOffset.

Wartość zwracana

Klasa DateTimeOffset.
CurrentUtcDateTime() Zwraca wartość jako bieżącą DateTime datę i godzinę serwera w strefie czasowej UTC.

Wartość zwracana

Klasa DateTime.
Day(expression) Zwraca część dnia z przedziału expressionInt32 od 1 do 31.

Argumenty

A DateTime i DateTimeOffset.

Wartość zwracana

An Int32.

Przykład

-- The following example returns 12.

Day(cast('03/12/1998' as DateTime))
DayOfYear(expression) Zwraca część dnia z przedziału expressionInt32 od 1 do 366, gdzie 366 jest zwracana przez ostatni dzień roku przestępnego.

Argumenty

A DateTime lub DateTimeOffset.

Wartość zwracana

An Int32.
DiffNanoseconds(startExpression,endExpression) Zwraca różnicę w nanosekundach między startExpression i endExpression.

Argumenty

startExpression, : DateTime, endExpression, DateTimeOffsetlub Time. Uwaga:startExpression i endExpression musi być tego samego typu.

Wartość zwracana

An Int32.
DiffMilliseconds(startExpression,endExpression) Zwraca różnicę w milisekundach między startExpression i endExpression.

Argumenty

startExpression, : DateTime, endExpression, DateTimeOffsetlub Time. Uwaga:startExpression i endExpression musi być tego samego typu.

Wartość zwracana

An Int32.
DiffMicroseconds(startExpression,endExpression) Zwraca różnicę w mikrosekundach między startExpression i endExpression.

Argumenty

startExpression, : DateTime, endExpression, DateTimeOffsetlub Time. Uwaga:startExpression i endExpression musi być tego samego typu.

Wartość zwracana

An Int32.
DiffSeconds(startExpression,endExpression) Zwraca różnicę w sekundach między startExpression i endExpression.

Argumenty

startExpression, : DateTime, endExpression, DateTimeOffsetlub Time. Uwaga:startExpression i endExpression musi być tego samego typu.

Wartość zwracana

An Int32.
DiffMinutes(startExpression,endExpression) Zwraca różnicę w minutach między startExpression i endExpression.

Argumenty

startExpression, : DateTime, endExpression, DateTimeOffsetlub Time. Uwaga:startExpression i endExpression musi być tego samego typu.

Wartość zwracana

An Int32.
DiffHours(startExpression,endExpression) Zwraca różnicę w godzinach między startExpression i endExpression.

Argumenty

startExpression, : DateTime, endExpression, DateTimeOffsetlub Time. Uwaga:startExpression i endExpression musi być tego samego typu.

Wartość zwracana

An Int32.
DiffDays(startExpression,endExpression) Zwraca różnicę w dniach między startExpression i endExpression.

Argumenty

startExpression, : endExpressionDateTime lub DateTimeOffset. Uwaga:startExpression i endExpression musi być tego samego typu.

Wartość zwracana

An Int32.
DiffMonths(startExpression,endExpression) Zwraca różnicę w miesiącach między startExpression i endExpression.

Argumenty

startExpression, : endExpressionDateTime lub DateTimeOffset. Uwaga:startExpression i endExpression musi być tego samego typu.

Wartość zwracana

An Int32.
DiffYears(startExpression,endExpression) Zwraca różnicę w latach między startExpression i endExpression.

Argumenty

startExpression, : endExpressionDateTime lub DateTimeOffset. Uwaga:startExpression i endExpression musi być tego samego typu.

Wartość zwracana

An Int32.
GetTotalOffsetMinutes(datetimeoffset) Zwraca liczbę minut przesunięcia datetimeoffset od GMT. Zazwyczaj wynosi to od +780 do -780 (+ lub - 13 godzin). Uwaga: ta funkcja jest obsługiwana tylko w programie SQL Server 2008.

Argumenty

Klasa DateTimeOffset.

Wartość zwracana

An Int32.
Hour(expression) Zwraca część godzinową Int32 z przedziału expression od 0 do 23.

Argumenty

A DateTime, Time i DateTimeOffset.

Przykład

-- The following example returns 22.

Hour(cast('22:35:5' as DateTime))
Millisecond(expression) Zwraca część milisekund z expressionInt32 zakresu od 0 do 999.

Argumenty

A DateTime, Time i DateTimeOffset.

Wartość zwracana

An Int32.
Minute(expression) Zwraca część minutową z przedziału expressionInt32 od 0 do 59.

Argumenty

A DateTime, Time lub DateTimeOffset.

Wartość zwracana

An Int32.

Przykład

-- The following example returns 35

Minute(cast('22:35:5' as DateTime))
Month(expression) Zwraca część miesiąca z przedziału expressionInt32 od 1 do 12.

Argumenty

A DateTime lub DateTimeOffset.

Wartość zwracana

An Int32.

Przykład

-- The following example returns 3.

Month(cast('03/12/1998' as DateTime))
Second(expression) Zwraca część sekund z expressionInt32 zakresu od 0 do 59.

Argumenty

A DateTime, Time i DateTimeOffset.

Wartość zwracana

An Int32.

Przykład

-- The following example returns 5

Second(cast('22:35:5' as DateTime))
TruncateTime(expression) Zwraca wartość , z obciętymi expressionwartościami czasu.

Argumenty

A DateTime lub DateTimeOffset.

Wartość zwracana

Typ .expression
Year(expression) Zwraca część roku jako expression .Int32YYYY

Argumenty

A DateTime i DateTimeOffset.

Wartość zwracana

An Int32.

Przykład

-- The following example returns 1998.

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

Te funkcje zostaną zwrócone null w przypadku danych wejściowych null .

Równoważne funkcje są dostępne w programie Microsoft SQL Client Managed Provider. Aby uzyskać więcej informacji, zobacz SqlClient for Entity Framework Functions.Aby uzyskać więcej informacji, zobacz SqlClient for Entity Framework Functions.

Zobacz też