Типы данных и функции даты и времени (Transact-SQL)

Tsql теория > Типы данных и функции даты и времени (Transact-SQL)
18.04.2013 14:07:49



Статья:

 

Функция

Синтаксис

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

Тип возвращаемых данных

Детерминизм

SYSDATETIME

SYSDATETIME ()

Возвращает значение типа datetime2(7), которое содержит дату и время компьютера, на котором запущен экземпляр SQL Server. Смещение часового пояса не включается.

datetime2(7)

Недетерминированная

SYSDATETIMEOFFSET

SYSDATETIMEOFFSET ( )

Возвращает значение типа datetimeoffset(7), которое содержит дату и время компьютера, на котором запущен экземпляр SQL Server. Смещение часового пояса включается.

datetimeoffset(7)

Недетерминированная

SYSUTCDATETIME

SYSUTCDATETIME ( )

Возвращает значение типа datetime2(7), которое содержит дату и время компьютера, на котором запущен экземпляр SQL Server. Возвращаемые дата и время отображаются в формате UTC.

datetime2(7)

Недетерминированная

Функции системной даты и времени меньшей точности

Функция

Синтаксис

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

Тип возвращаемых данных

Детерминизм

CURRENT_TIMESTAMP

CURRENT_TIMESTAMP

Возвращает значение типа datetime2(7), которое содержит дату и время компьютера, на котором запущен экземпляр SQL Server. Смещение часового пояса не включается.

datetime

Недетерминированная

GETDATE

GETDATE ( )

Возвращает значение типа datetime2(7), которое содержит дату и время компьютера, на котором запущен экземпляр SQL Server. Смещение часового пояса не включается.

datetime

Недетерминированная

GETUTCDATE

GETUTCDATE ( )

Возвращает значение типа datetime2(7), которое содержит дату и время компьютера, на котором запущен экземпляр SQL Server. Возвращаемые дата и время отображаются в формате UTC.

datetime

Недетерминированная

Функции, получающие компоненты даты и времени

Функция

Синтаксис

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

Тип возвращаемых данных

Детерминизм

DATENAME

DATENAME (datepart, date )

Возвращает строку символов, представляющую указанную часть datepart заданной даты.

nvarchar

Недетерминированная

DATEPART

DATEPART (datepart, date )

Возвращает целое число, представляющее указанный компонент datepart указанной даты date.

int

Недетерминированная

DAY

DAY (date)

Возвращает целое число, представляющее день указанной даты date.

int

Детерминированное

MONTH

MONTH ( date )

Возвращает целое число, представляющее месяц указанной даты date.

int

Детерминированное

YEAR

YEAR (date)

Возвращает целое число, представляющее год указанной даты date.

int

Детерминированная

Функции, получающие значения даты и времени из их компонентов

Функция

Синтаксис

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

Тип возвращаемых данных

Детерминизм

DATEFROMPARTS

DATEFROMPARTS (year, month, day)

Возвращает значение date, соответствующее указанному числу, месяцу и году.

date

Детерминированная

DATETIME2FROMPARTS

DATETIME2FROMPARTS ( year, month,day, hour, minute, seconds, fractions,precision )

Возвращает значениеdatetime2, соответствующее указанной дате и времени с заданной точностью.

datetime2 (precision )

Детерминированная

DATETIMEFROMPARTS

DATETIMEFROMPARTS (year, month,day, hour, minute, seconds, milliseconds)

Возвращает значениеdatetime, соответствующее указанной дате и времени.

datetime

Детерминированная

DATETIMEOFFSETFROMPARTS

DATETIMEOFFSETFROMPARTS (year,month, day, hour, minute, seconds,fractions, hour_offset, minute_offset,precision)

Возвращает значениеdatetimeoffset для указанных даты и времени с указанными смещением и точностью.

datetime (precision )

Детерминированная

SMALLDATETIMEFROMPARTS

SMALLDATETIMEFROMPARTS (year,month, day, hour, minute)

Возвращает значениеsmalldatetime, соответствующее указанной дате и времени.

smalldatetime

Детерминированная

TIMEFROMPARTS

TIMEFROMPARTS (hour, minute,seconds, fractions, precision)

Возвращает значение time, соответствующее указанному времени с установленной точностью.

time ( precision )

Детерминированная

Функции, получающие разность даты и времени

Функция

Синтаксис

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

Тип возвращаемых данных

Детерминизм

DATEDIFF

DATEDIFF ( datepart,startdate , enddate )

Возвращает количество границ datepart даты или времени, пересекающихся между двумя указанными датами.

int

Детерминированное

Функции, изменяющие значения даты и времени

Функция

Синтаксис

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

Тип возвращаемых данных

Детерминизм

DATEADD

DATEADD (datepart,number , date )

Возвращает новое значение datetime, добавляя интервал к указанной части datepart заданной датыdate.

Тип данных аргумента date

Детерминированная

EOMONTH

EOMONTH (start_date [,month_to_add ])

Возвращает последний день месяца, содержащего указанную дату, с необязательным смещением.

Возвращаемые данные имеют типstart_date илиdatetime2(7).

Детерминированная

SWITCHOFFSET

SWITCHOFFSET(DATETIMEOFFSET ,time_zone)

SWITCHOFFSET изменяет смещение часового пояса для значения DATETIMEOFFSET и сохраняет значение UTC.

datetimeoffset с точностью в долях секундDATETIMEOFFSET

Детерминированное

TODATETIMEOFFSET

TODATETIMEOFFSET (expression ,time_zone)

TODATETIMEOFFSET преобразует значение типа datetime2 в значение типа datetimeoffset. Значение datetime2 преобразуется в местное время для указанного time_zone.

datetimeoffset с точностью в долях секунд аргументаdatetime

Детерминированное

Функции, устанавливающие или получающие формат сеанса

Функция

Синтаксис

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

Тип возвращаемых данных

Детерминизм

@@DATEFIRST

@@DATEFIRST

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

tinyint

Недетерминированная

SET DATEFIRST

SET DATEFIRST {number | @number_var }

Устанавливает первый день недели в виде числа от 1 до 7.

Неприменимо

Неприменимо

SET DATEFORMAT

SET DATEFORMAT {format | @format_var }

Задает порядок составляющих даты (месяц/день/год) для ввода данных типа datetime или smalldatetime.

Неприменимо

Неприменимо

@@LANGUAGE

@@LANGUAGE

Возвращает название используемого в данный момент языка.@@LANGUAGE не является функцией даты или времени.Однако на данные, выводимые функциями даты, могут повлиять настройки языка.

Неприменимо

Неприменимо

SET LANGUAGE

SET LANGUAGE { [ N ] 'language' |@ language_var }

Устанавливает языковую среду сеанса и системных сообщений. SET LANGUAGE не является функцией даты или времени. Однако на данные, выводимые функциями даты, влияет параметр языка.

Неприменимо

Неприменимо

sp_helplanguage

sp_helplanguage[ [ @language = ]'language' ]

Возвращает сведения о формате даты всех поддерживаемых языков. sp_helplanguage не является хранимой процедурой даты или времени. Однако на данные, выводимые функциями даты, влияет параметр языка.

Неприменимо

Неприменимо

Функции, проверяющие значения даты и времени

Функция

Синтаксис

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

Тип возвращаемых данных

Детерминизм

ISDATE

ISDATE (expression)

Определяет, является ли входное выражение типа datetime илиsmalldatetime допустимым значением даты или времени.

int

Функция ISDATE детерминирована, только если используется совместно с функцией CONVERT и если заданный параметр стиля CONVERT не равен 0, 100, 9 или 109.