- DATEDIFF (Transact-SQL)
- Синтаксис
- Аргументы
- Тип возвращаемых данных
- Возвращаемое значение
- Границы, задаваемые аргументом datepart
- Remarks
- Примеры
- A. Указание столбцов в качестве начальной и конечной даты
- Б. Указание определенных пользователем переменных в качестве начальной и конечной даты
- В. Указание скалярных системных функций в качестве начальной и конечной даты
- Г. Указание скалярных вложенных запросов и скалярных функций в качестве начальной и конечной даты
- Д. Указание констант в качестве начальной и конечной даты
- Е. Указание числовых выражений и скалярных системных функций в качестве конечной даты
- Ж. Указание ранжирующих функций в качестве начальной даты
- З. Указание агрегатной оконной функции в качестве начальной даты
- И. Определение разницы между startdate и enddate в виде строковых компонентов даты
- Примеры: Azure Synapse Analytics и Система платформы аналитики (PDW)
- К. Указание столбцов в качестве начальной и конечной даты
- Л. Указание скалярных вложенных запросов и скалярных функций в качестве начальной и конечной даты
- М. Указание констант в качестве начальной и конечной даты
- Н. Указание ранжирующих функций в качестве начальной даты
- О. Указание агрегатной оконной функции в качестве начальной даты
- Database.Guide
- Categories
- How to Fix the “datediff function resulted in an overflow” Error in SQL Server
- Example
- Ошибки при работе с датой и временем в SQL Server
- Ошибка #1: Предполагать, что значения даты и времени хранятся в виде форматированных строк
- Ошибка #2: Забыть о людях, которые живут в других частях света
- Ошибка #3: Снова забыть о людях, которые живут в других частях света
- Ошибка #4: Относиться к DATETIME2 только как к более точному DATETIME
- Ошибка #5: Игнорировать округление даты/времени
- Ошибка #6: Делать лишнюю работу для удаления времени из полной даты
- Ошибка #7: Не понимать как работает функция DATEDIFF
- Ошибка #8: Небрежно относиться к условиям поиска
- Ошибка #9: Забыть о диапазонах в типах данных для даты/времени
- Ошибка #10: Не использовать преимуществ функций работы с датой и временем
DATEDIFF (Transact-SQL)
Применимо к: SQL Server (все поддерживаемые версии) База данных SQL Azure Управляемый экземпляр SQL Azure Azure Synapse Analytics Параллельное хранилище данных
Эта функция возвращает количество пересеченных границ (целое число со знаком), указанных в аргументе datepart, за период времени, указанный в аргументах startdate и enddate.
Сведения о функции, которая обрабатывает значительные отличия значений аргументов startdate и enddate, см. в статье DATEDIFF_BIG (Transact-SQL). Обзор всех типов данных и функций даты и времени в языке Transact-SQL см. в статье Типы данных и функции даты и времени (Transact-SQL).
Синтаксис
Ссылки на описание синтаксиса Transact-SQL для SQL Server 2014 и более ранних версий, см. в статье Документация по предыдущим версиям.
Аргументы
datepart
Единицы, в которых функция DATEDIFF сообщает о разнице между startdate и enddate. К часто используемым единицам datepart относятся month или second .
Значение datepart не может быть указано в переменной или в виде строки в кавычках, например ‘month’ .
В приведенной ниже таблице перечислены все допустимые значения datepart. Функция DATEDIFF принимает либо полное имя datepart, либо любое приведенное сокращение полного имени.
| Имя datepart | Сокращение datepart |
|---|---|
| year | yy, yyyy |
| quarter | qq, q |
| month | mm, m |
| dayofyear | dy, y |
| day | dd, d |
| week | wk, ww |
| hour | hh |
| minute | mi, n |
| second | ss, s |
| millisecond | ms |
| microsecond | mcs |
| nanosecond | ns |
Каждое конкретное имя аргумента datepart и сокращение этого имени datepart будут возвращать одно и то же значение.
startdate
Выражение, которое может быть разрешено в одно из следующих значений.
- date
- datetime
- datetimeoffset
- datetime2
- smalldatetime
- time
Во избежание неоднозначности используйте четырехзначную запись года. Сведения о двузначном обозначении года см. в статье Настройка параметра конфигурации сервера two digit year cutoff.
enddate
См. описание аргумента startdate.
Тип возвращаемых данных
int
Возвращаемое значение
Значение типа int, представляющее разницу между аргументами startdate и enddate в границах, определяемых аргументом datepart.
Например, SELECT DATEDIFF(day, ‘2036-03-01’, ‘2036-02-28’); возвращает значение -2, указывая на то, что 2036 – високосный год. Это означает, что, если начать со startdDate «2036-03-01» и отсчитать -2 дня, будет достигнуто значение enddate «2036-02-28».
В качестве возвращаемого значения вне диапазона для int (от –2 147 483 648 до 2 147 483 647) DATEDIFF возвращает сообщение об ошибке. Для миллисекунды максимальная разница между startdate и enddate составляет 24 дня 20 часов 31 минута и 23 647 секунд. Для секунды максимальная разница составляет 68 лет, 19 дней, 3 часа, 14 минут и 7 секунд.
Если обоим аргументам, startdate и enddate, присвоено только значение времени, а аргумент datepart не содержит значения времени datepart, то DATEDIFF возвращает значение 0.
При вычислении возвращаемого значения DATEDIFF использует компонент смещения часовых поясов для аргументов startdate или enddate.
Так как значение типа smalldatetime имеет точность до минуты, то при использовании в аргументах startdate и enddate значений типа smalldatetime секунды и миллисекунды у возвращаемых значений всегда равны 0.
Если переменной типа данных date присвоено только значение времени, в качестве недостающей части даты DATEDIFF задает значение по умолчанию: 1900-01-01 . Если переменной типа данных time или date присвоено только значение даты, в качестве недостающей части времени DATEDIFF задает значение по умолчанию: 00:00:00 . Если в одном из аргументов startdate или enddate указано только время, а в другом только дата, в качестве недостающей информации DATEDIFF задает значения по умолчанию.
Если аргументы startdate и enddate имеют разные типы данных даты, но при этом один из них имеет больше частей времени или обладает более высокой точностью, DATEDIFF присваивает значения 0 недостающим частям другого аргумента.
Границы, задаваемые аргументом datepart
Приведенные ниже инструкции имеют одинаковые значения аргументов startdate и enddate. Указанные даты являются соседними, а временная разница между ними составляет 100 наносекунд (0,0000001 секунды). Разница между аргументами startdate и enddate в каждой инструкции пересекает одну календарную или временную границу аргумента datepart. Каждое выражение возвращает значение 1.
Если аргументы startdate и enddate имеют разные значения года, но одинаковые значения календарной недели, DATEDIFF вернет 0 для части week аргумента datepart.
Remarks
Используйте DATEDIFF в предложениях SELECT
, WHERE , HAVING , GROUP BY и ORDER BY .
Функция DATEDIFF неявно приводит строковые литералы к типу datetime2. Это означает, что DATEDIFF не поддерживает формат ГЧМ (год, число, месяц) при передаче даты в виде строки. Для использования формата ГЧМ (год, число, месяц) необходимо явно привести строку к типу datetime или smalldatetime.
Указание SET DATEFIRST не влияет на DATEDIFF . DATEDIFF всегда считает воскресенье первым днем недели, чтобы обеспечить детерминизм работы функции.
DATEDIFF может переполняться с точностью до минуты или более низкой точностью, если разница между enddate и startdate представляет собой значение, выходящее за пределы диапазона, допустимого для int.
Примеры
В этих примерах выражения различного типа используются в качестве аргументов для параметров startdate и enddate.
A. Указание столбцов в качестве начальной и конечной даты
В этом примере подсчитывается количество границ дней, пересекаемых между датами в двух столбцах таблицы.
Б. Указание определенных пользователем переменных в качестве начальной и конечной даты
В этом примере в качестве аргументов startdate и enddate выступают определенные пользователем переменные.
В. Указание скалярных системных функций в качестве начальной и конечной даты
В этом примере в качестве аргументов startdate и enddate выступают скалярные системные функции.
Г. Указание скалярных вложенных запросов и скалярных функций в качестве начальной и конечной даты
В этом примере в качестве аргументов startdate и enddate выступают скалярные вложенные запросы.
Д. Указание констант в качестве начальной и конечной даты
В этом примере в качестве аргументов startdate и enddate используются символьные константы.
Е. Указание числовых выражений и скалярных системных функций в качестве конечной даты
В этом примере в качестве аргументов для enddate используются числовое выражение (GETDATE() + 1) и скалярные системные функции GETDATE и SYSDATETIME .
Ж. Указание ранжирующих функций в качестве начальной даты
В этом примере в качестве аргумента startdate. используется ранжирующая функция.
З. Указание агрегатной оконной функции в качестве начальной даты
В этом примере в качестве аргумента startdate используется агрегатная оконная функция.
И. Определение разницы между startdate и enddate в виде строковых компонентов даты
Примеры: Azure Synapse Analytics и Система платформы аналитики (PDW)
В этих примерах выражения различного типа используются в качестве аргументов для параметров startdate и enddate.
К. Указание столбцов в качестве начальной и конечной даты
В этом примере подсчитывается количество границ дней, пересекаемых между датами в двух столбцах таблицы.
Л. Указание скалярных вложенных запросов и скалярных функций в качестве начальной и конечной даты
В этом примере в качестве аргументов startdate и enddate выступают скалярные вложенные запросы.
М. Указание констант в качестве начальной и конечной даты
В этом примере в качестве аргументов startdate и enddate используются символьные константы.
Н. Указание ранжирующих функций в качестве начальной даты
В этом примере в качестве аргумента startdate. используется ранжирующая функция.
О. Указание агрегатной оконной функции в качестве начальной даты
В этом примере в качестве аргумента startdate используется агрегатная оконная функция.
Источник
Database.Guide
Categories
How to Fix the “datediff function resulted in an overflow” Error in SQL Server
This article provides a solution to a problem you may occasionally encounter while using the DATEDIFF() function in SQL Server.
If you encounter the following error:
The datediff function resulted in an overflow. The number of dateparts separating two date/time instances is too large. Try to use datediff with a less precise datepart.
It’s because the return value is too large. The DATEDIFF() function returns its result as an int data type. The reason you got this message is that the return value is too big for the int data type. Fortunately there’s an easy way to fix this.
The quickest and easiest way to fix this issue is to switch to the DATEDIFF_BIG() function. This function works exactly like DATEDIFF() , except that its return data type is a signed bigint. In other words, it can handle really big numbers.
Example
Let’s see if DATEDIFF() can tell us how many milliseconds are in a thousand years:
Maybe not. Seems there are too many milliseconds to fit into an int.
Time for the big guns. DATEDIFF_BIG() , do your stuff…
If you still get the above error message, you must be trying to return a really big number. In that case you’ll need to do at least one of the following:
- Use a shorter time period.
- Use a less precise datepart. For example, instead of trying to return the number of milliseconds, try it with just seconds.
Also note that you’ll need to be running at least SQL Server 2016 before you can use the DATEDIFF_BIG() function.
Источник
Ошибки при работе с датой и временем в SQL Server
Перевод статьи подготовлен специально для студентов курса «MS SQL Server разработчик».
Ошибка #1: Предполагать, что значения даты и времени хранятся в виде форматированных строк
Многие из ошибок, связанных с обработкой даты и времени, часто происходят из-за непонимания того, как SQL Server хранит эти значения. (Документация SQL Server здесь тоже не сильно помогает, так как не углубляется в эту тему.)
Начинающие T-SQL-разработчики часто предполагают, что значения даты/времени хранятся в человекочитаемом виде, таком как «05-07-2015 10:05:23.187». Но это не так. А если точнее, то SQL Server хранит дату/время в виде одного или нескольких целых чисел (в зависимости от типа данных). В некоторых источниках говорится, что данные хранятся в виде чисел с плавающей точкой, но это ничего не меняет (концепция остается та же самая — мы говорим хранении дат в виде чисел, а не в виде форматированных строк).
Давайте начнем с типа DATETIME . Согласно документации SQL Server, значение DATETIME хранится в виде двух целых чисел. Первое целое число представляет день, а второе — время. Диапазон дней от 1 января 1753 года до 31 декабря 9999 года. Времени — от 00:00:00.000 до 23:59:59.997. Значением по умолчанию является 1900-01-01 00:00:00.000.
Значение по умолчанию для даты особенно важно. 1 января 1900 года считается нулевым днем.
Более ранние даты представляются отрицательными целыми числами, а более поздние — положительными целыми. Например, 1 января 1899 года — это день -365, а 1 января 1901 года — день 365. Что касается времени, то SQL Server начинает с нуля и увеличивает значение для каждой 0,003 секунды после полуночи. Это означает, что время 00:00:00.003 хранится как 1, а время 00:00:01.000 как 300.
Поначалу это все может запутать, потому что при получении значения DATETIME мы видим нечто другое. Например, начнем с простой переменной DATETIME :
Как мы и ожидали, оператор SELECT возвращает значение в следующем виде:
Чтобы получить значение, которое действительно хранится, мы должны преобразовать его в тип VARBINARY :
Неудивительно, что результат теперь выглядит совсем по-другому:
Поскольку SQL Server хранит значение DATETIME в виде двух целых чисел (int), то его размер составляет 8 байт (каждое число 4 байта). Первые 4 байта (0000A491) представляют собой дату, а последние 4 байта (00A6463C) время. Зная это, мы можем использовать функцию SUBSTRING , чтобы посмотреть только дату или только время:
Теперь оператор SELECT возвращает только байты, представляющие дату:
Можем то же самое сделать для времени и преобразовать VARBINARY в INT . Давайте соберем все вместе и посмотрим как хранится исходное значение DATETIME :
В следующей таблице показаны результаты SELECT:
| DateBinary | DateInt | TimeBinary | TimeInt |
|---|---|---|---|
| 0x0000A491 | 42129 | 0x00A6463C | 10896956 |
Результаты показывают, что с 1 января 1900 года прошло 42 129 дней, а с полуночи прошло более 10 миллионов долей секунды.
Теперь давайте переведем часы примерно на 188 лет назад :
На этот раз до 1 января 1900 года было 26 327 дней, а время — более 24 миллионов тиков:
| DateBinary | DateInt | TimeBinary | TimeInt |
|---|---|---|---|
| 0xFFFF9929 | -26327 | 0x016EB86D | 24033389 |
Теперь установим дату и время по умолчанию (день 0):
Как и ожидалось, VARBINARY и INT содержат ноль:
| DateBinary | DateInt | TimeBinary | TimeInt |
|---|---|---|---|
| 0x00000000 | 0 | 0x00000000 | 0 |
Теперь, просто убедиться, что вы поняли, посмотрим еще один пример с DATETIME . К значению по умолчанию прибавляем один день и одну секунду:
На данный момент результаты должны быть вполне ожидаемыми. Дата — 1, время — 300:
| DateBinary | DateInt | TimeBinary | TimeInt |
|---|---|---|---|
| 0x00000001 | 1 | 0x0000012C | 300 |
Сейчас у вас должно быть довольно хорошее представление о том, как хранятся значения DATETIME . Однако, для других типов даты/времени SQL Server использует несколько иной подход. Давайте посмотрим на тип данных DATETIME2 , объявленный с точностью по умолчанию (7):
На этот раз наши результаты выглядят немного иначе, чем для DATETIME :
Для DATETIME2 SQL Server использует первый байт для хранения точности времени (07), последние три байта для хранения даты (EC390B), и все что между ними для хранения времени (B4854E9254), длина которого может изменяться в зависимости от указанной точности. Типы данных DATE и TIME работают аналогично. Например, сохраним это же значение в DATE :
Наши результаты совпадают с частью даты, возвращенной в предыдущем примере:
И то же самое для типа TIME :
Результаты совпадают с частью времени, возвращенной в примере с DATETIME2 :
Теперь изменим точность и значение времени:
Оператор SELECT возвращает следующие результаты:
Обратите внимание, что первый байт хранит точность (04), после него идет уже меньшее количество байтов, связанных со временем (01000000). К сожалению, логика, которую SQL Server использует для хранения даты и времени для типов DATETIME2 , DATE и TIME не так проста, как для DATETIME , и углубление в эту логику выходит за рамки данной статьи, но, по крайней мере, вы можете увидеть отдельно байты, представляющие дату и время, и получить некоторое представление о том, что происходит.
Смысл всего этого не в том, чтобы запомнить точные механизмы SQL Server, используемые для хранения даты и времени, а скорее для общего понимания того, как хранятся даты и что это не просто строки определенного формата. Понимание этого поможет вам лучше решать различные вопросы, возникающие при работе с датой/временем.
Ошибка #2: Забыть о людях, которые живут в других частях света
T-SQL может быть воспринят как универсальный язык, по крайней мере, в рамках базы данных, однако, это не касается параметров SQL Server. Довольно часто установленный экземпляр сконфигурирован так, чтобы обслуживать только локальных (местных) пользователей. Но это часто приводит к проблемам при работе с датой/временем. Хотя SQL Server хранит даты в виде одного или нескольких целых чисел, но за кулисами он часто преобразует их из целых чисел в строковые читаемые форматы и наоборот, чтобы нам не приходилось работать с датами, которые выглядят как 15481099 или как 24033389.
Для этого в SQL Server есть несколько параметров и правил, которые определяют как интерпретировать строковые значения даты/времени. Давайте посмотрим несколько примеров. В первом случае мы установим язык british (британский английский) и преобразуем значение VARCHAR в DATETIME :
Как и ожидалось, оператор SELECT возвращает следующие результаты:
Теперь давайте установим язык на US English (американский английский) и попробуем преобразовать значение:
На этот раз SQL Server возвращает ошибку:
Проблема здесь в формате даты: день-месяц-год. Это прекрасно работает, когда SQL Server сконфигурирован для языка british, но не работает для US English. Когда SQL Server, настроенный на US English, видит данные, он предполагает, что мы пытаемся передать значение 19 как месяц, а не как день. Мы можем решить эту проблему, подставив значение, которое больше соответствует ожиданиям американцев:
Теперь наш SELECT сработает отлично. Если мы изменим язык обратно на british и подставим то же значение, мы снова получим ошибку «out-of-range».
Конечно, мы могли бы изменить язык еще раз, но это не очень эффективное, если мы разрабатываем интернациональное приложение. Лучше будет, если наши значения даты/времени будут универсальными по своей природе, например, используя формат «год-месяц-день«. Например, предположим, что мы пытаемся передать значение даты/времени в данном формате с дефисами:
Этот формат считается более универсальным способом передачи данных времени и даты. В конце концов, именно в таком виде SQL Server возвращает данные. Для разделения компонент даты можно использовать тире, косую черту или точку, до тех пор, пока значения соответствуют структуре «год-месяц-день«. Однако, несмотря на универсальность формата, оператор SELECT снова возвращает ошибку:
Но посмотрите, что произойдет, если мы будем придерживаться того же языка и того же формата, но на этот раз преобразуем данные в DATETIME2 :
Теперь SELECT без проблем преобразует дату и возвращает следующий результат:
Оказывается, что формат «год-месяц-день» все еще зависит от настроек SQL Server, когда речь идет о типе данных DATETIME , но не DATETIME2 .
Если мы придерживаемся типа данных DATETIME2, то можем избежать языковой проблемы при использовании формата «год-месяц-день«, который является лучшим вариантом, при работе с SQL Server 2008 или более поздним. Но не у всех есть такая роскошь. Нам нужен формат, который будет независимым от типа и языка. По этой причине многие разработчики по умолчанию используют такой формат, как ISO 8601:
На этот раз выражение выполняется без ошибок. Используя универсальный формат для значения времени/даты, мы можем лучше гарантировать, что мы получим желаемые результаты, независимо от того где мы находимся — в Сиэтле, Кембридже или Риме.
Ошибка #3: Снова забыть о людях, которые живут в других частях света
Форматы даты — не единственное, где мы можем попасть в неприятности, когда разрабатываем приложение, которое охватывает несколько географических регионов. Также могут возникнуть проблемы с часовыми поясами, если потребуется отслеживать данные за периоды времени по нескольким регионам.
Одна из проблем заключается в том, что большинство типов даты/времени в SQL Server довольно неоднозначны. Например, у нас есть таблица, которая отслеживает события, связанные с безопасностью и одна из строк показывает событие, произошедшее 15 мая 2015 года в 3:30 утра. Это время на локальной машине? Или это время сервера? Настроен ли SQL Server, чтобы использовать время, отличное от местного? Является ли это значением в UTC? Без какого-либо механизма, обеспечивающего контекст, это значение почти бессмысленно.
Во многих случаях это не проблема, но для систем мониторинга или для критических процессов, точное время имеет важное значение. Представьте себе, если был взломан международный банк, деньги украдены со счетов, а у следователей нет возможности узнать, когда точно произошло это событие. А как насчет аналитики с учетом времени? Анализ исторических данных может стать сложным, если данные охватывают часовые пояса и нет механизма обеспечения контекста, такого как часовой пояс, в котором были введены данные.
Даже если такие механизмы и есть, реализация решений, учитывающих часовые пояса, часто зависит от разработчиков. Без единого подхода для разных приложений (а иногда и в рамках одного приложения).
К счастью, в SQL Server 2008 появился тип данных DATETIMEOFFSET , который должен сделать управление датой/временем немного проще. Этот тип хранит данные аналогично DATETIME2 с дополнительной парой байт, используемой для часового пояса (относительно UTC).
Рассмотрим следующий пример:
Системная функция SYSDATETIMEOFFSET возвращает текущую дату и время в виде DATETIMEOFFSET , что означает, что оно включает в себя дату, время и значение UTC-смещения:
В этом случае значение даты/времени отстает от UTC на семь часов, и мы окажемся на западном побережье США. Для получения только значения смещения, то можем использовать функцию DATENAME :
Как и ожидалось, SELECT возвращает только разницу с UTC:
Далее мы можем продемонстрировать, как работает тип данных DATETIMEOFFSET сравнивая его с UTC-аналогом:
Как показывают следующие результаты, дата и время UTC на семь часов опережают Тихоокеанскую (PDT) дату и время.
| UTC | PDT |
|---|---|
| 2015-05-09 00:57:37.1820000 +00:00 | 2015-05-08 17:57:37.1820000 -07:00 |
В SQL Server 2008 была добавлена системная функция SWITCHOFFSET для изменения значения DATETIMEOFFSET на другой часовой пояс:
В данном случае мы просто изменяем значение UTC-смещения с -07:00 на -05:00 при получении данных:
Очевидно, что SQL Server значительно облегчил работу с часовыми поясами, и нет причин не пользоваться этими возможностями, если вы используете SQL Server 2008 и старше. Однако существует проблема, которую SQL Server не смог решить — переход на летнее и зимнее время.
Давайте посмотрим, что происходит, когда мы сравниваем часовые пояса между Мельбурном и Сиэтлом на 1 апреля 2015 года:
На данный момент и Мельбурн, и Сиэтл находятся на летнем времени, давая нам 18-часовую разницу между датами. Однако давайте сравним 1 мая 2015 года, используя те же значения смещения UTC:
Мы снова видим разницу в 18 часов, хотя на самом деле должно быть 17, потому что Мельбурн вернулся к зимнему времени 5 апреля. Значение смещения, которое мы должны были использовать 5-го мая для Мельбурна, составляет +10:00.
Несмотря на то, что это очень простой пример, он показывает на большую проблему, связанную с отслеживанием летнего и зимнего времени по всему миру. Не во всех регионах происходит смена летнего и зимнего времени. А там, где происходит, то она не всегда бывает в одно и то же время. Кроме того, даты начала и окончания меняются от года к году. И эти даты становятся еще менее предсказуемыми из-за того, что изменяются законы, определяющие переход на летнее/зимнее время.
Добавьте к этому еще тот факт, что сами часовые пояса могут сильно различаться даже в пределах региона или страны. Например, штат Аризона в США. Большая часть штата не меняет время. Это означает, что часть года они синхронизированы с Колорадо, а остальную часть года живут как в Калифорнии.
Все это указывает на то, что вы не можете полагаться только на DATETIMEOFFSET для обеспечения надежности ваших значений даты/времени. Изменение часовых поясов и неуправляемый переход на летнее/зимнее время делают работу с часовыми поясами сложной задачей без наличия простого решения. Если ваши приложения и аналитика полагаются на точное измерение даты и времени, то приложение должно содержать логику, необходимую для обработки таких ситуаций.
Ошибка #4: Относиться к DATETIME2 только как к более точному DATETIME
Несмотря на то, что DATETIME2 появился еще в SQL Server 2008, многие разработчики не спешат его использовать и используют DATETIME по привычке, а не по каким-то другим причинам. Но, помимо большей точности, DATETIME2 имеет еще другие преимущества перед DATETIME .
Давайте начнем с того, что посмотрим на них в действии:
Тип данных DATETIME2 поддерживает до семи десятичных знаков после запятой для компонента времени, тогда как DATETIME только три. Это дает нам следующие результаты.
| DateTime2Type | DateTimeType |
|---|---|
| 2015-05-12 09:47:12.4556789 | 2015-05-12 09:47:12.457 |
Первое, на что стоит обратить внимание, это округление SQL Server’ом времени в DATETIME до ближайшей .003 секунды, т.е. значения хранятся с приращением .000, .003 или 0,007 секунды. (Прим. переводчика — на самом деле шаг 1/300 сек = 0,0033333333333333… сек, но из-за округлений получается .000, .003, .007, .010, .013, . )
В этом отношении DATETIME2 является гораздо более точным. Хотя значение и обрезается при превышении семи знаков после запятой, но округления не происходит, если значение находится в допустимых пределах. Например, .555678999 округляется до .5556790 , но значение, как .9999999 , не округляется.
Так что в этом отношении DATETIME2 также более точен, чем DATETIME . Кроме того, в отличие от DATETIME , вы можете контролировать точность DATETIME2 . Например, в следующем примере установим точность времени DATETIME2 в 3:
Как видно, значение DATETIME2 теперь включает только три десятичных разряда, так же как и DATETIME .
| DateTime2Type | DateTimeType |
|---|---|
| 2015-05-12 09:47:12.556 | 2015-05-12 09:47:12.557 |
Еще раз, часть времени DATETIME2 округляется, потому что представленное значение превысило указанную точность, но даже это округление является более точным, чем то, которое мы получаем с DATETIME . Хотя оба значения занимают три знака после запятой, SQL Server использует 7 байт для хранения DATETIME2 и 8 байт для DATETIME .
Фактически DATETIME2 использует 8 байт при точности больше 4, и только 6 байт, если точность меньше 3. C DATETIME2 вы можете получить не только большую точность, но и сэкономить место, что может быть важным работе с большими объемами данных. Тип DATETIME2 также позволяет полностью удалить знаки после запятой:
Возможность убрать знаки после запятой — это хорошо, когда вам не нужны микросекунды. Теперь наши результаты стали чище:
| DateTime2Type | DateTimeType |
|---|---|
| 2015-05-12 09:47:13 | 2015-05-12 09:47:12.557 |
Еще один важный момент при сравнении DATETIME2 и DATETIME это то, что DATETIME2 поддерживает гораздо более широкий диапазон дат (с 1 января 0001). В то время как DATETIME только с 1 января 1753 года. (Оба они ограничены 9999 годом, что, я уверен, многих успокоит).
Стоит также сказать пару слов и о типах DATE и TIME , которые предоставляют такую же точность.
Как вы можете видеть, типы DATE и TIME являются хорошим дополнением для удобной работы с датой/временем:
| DateType | TimeType |
|---|---|
| 2015-05-12 | 09:47:12.5556789 |
Конечно, в старые приложения и системы не всегда просто внедрить новые типы данных, но при создании новых систем нет причин не использовать эти типы (если только вы не работаете с версиями SQL Server меньше 2008 или с технологиями, которые не могут обрабатывать значения DATETIME2 ).
У типа DATETIME2 и других новых типов есть много преимуществ, чтобы их игнорировать, в том числе лучшее соответствие типам даты/времени .NET. И как было отмечено ранее, тип DATETIME2 более снисходителен к форматам даты/времени, которые вы передаете в базу данных. Очевидно, что пришло время избавиться от старых привычек и отказаться от DATETIME .
Ошибка #5: Игнорировать округление даты/времени
В предыдущем разделе мы затронули вопрос округления, но эта тема заслуживает большего внимания. Особенно в том, что касается DATETIME и SMALLDATETIME . Сначала давайте посмотрим, что произойдет, если мы округлим DATETIME2 :
Здесь точность DATETIME2 по умолчанию равна 7 — это количество знаков после запятой для секунд. Как видно из результатов, значение @a никак не округляется, а @b и @c округляются:
| OrigValue | StoredValue |
|---|---|
| 2015-05-12 23:32:12.1234567 | 2015-05-12 23:32:12.1234567 |
| 2015-05-12 23:32:12.123456789 | 2015-05-12 23:32:12.1234568 |
| 2015-05-12 23:59:59.999999999 | 2015-05-13 00:00:00.0000000 |
Значение @b округляется, как мы и ожидали: девять цифр сокращаются до семи цифр, а значение 123456789 округляется до 1234568 . Значение @c также подчиняется аналогичной логике. Однако, так как мы округляем вверх, то переходим к следующему дню. В обоих случаях SQL Server работает вполне предсказуемо. Хотя существует вероятность того, что значение будет увеличено до следующего дня, но оно все равно соответствует ожидаемому поведению.
Теперь давайте посмотрим, что происходит со значениями DATETIME :
Значение @a округляется в большую сторону, @b округляется в меньшую сторону, а @c переносится на следующий день:
| OrigValue | StoredValue |
|---|---|
| 2015-05-12 23:59:59.996 | 2015-05-12 23:59:59.997 |
| 2015-05-12 23:59:59.998 | 2015-05-12 23:59:59.997 |
| 2015-05-12 23:59:59.999 | 2015-05-13 00:00:00.000 |
Что удивительно в этом округлении, так это то, что значения, которые мы передаем, не превышают точности DATETIME , но округление все равно происходит. Как говорилось ранее, SQL Server хранит данные в DATETIME с шагом .000, .003 и .007 секунд. Это может стать проблемой с аналитическими отчетами, требующих высокой точности. И это еще более проблематично, когда мы не можем присвоить точное значение, потому существует вероятность того, что оно будет округлено до следующего дня.
Вероятность потерять день может показаться незначительной, но это может произойти неожиданным образом. Например, предположим, что мы хотим преобразовать значение DATETIME2 в значение DATETIME :
Поскольку исходная точность превышает то, с чем DATETIME может справиться, то происходит округление с переходом на следующий день:
| Datetime2Value | DatetimeValue |
|---|---|
| 2015-05-12 23:59:59.9986789 | 2015-05-13 00:00:00.000 |
Но мы можем столкнуться с еще более запутанными проблемами SMALLDATETIME :
Несмотря на то, что возвращаемые значения всегда показывают «00» секунд, точность у SMALLDATETIME только до ближайшей минуты,
| OrigValue | SmalldatetimeValue |
|---|---|
| 2015-05-12 23:22:22 | 2015-05-12 23:22:00 |
| 2015-05-12 23:22:30 | 2015-05-12 23:23:00 |
| 2015-05-12 23:22:52 | 2015-05-12 23:23:00 |
| 2015-05-12 23:59:52 | 2015-05-13 00:00:00 |
Округление значения @a довольно просто: эти 22 секунды округляются в меньшую сторону, поэтому значение минуты остается неизменным. Значение @b округляется в большую сторону, так как SQL Server округляет 30 секунд и более до следующей минуты. Это также относится и к значению @c . Однако, значение @d переходит на следующий день, потому что 59 минут также округляются в большую сторону, что привело к тому, что 23 часа перешли на следующий день.
Теперь посмотрим, что произойдет, если мы добавим доли секунды:
И снова мы переходим на следующий день:
Вы должны быть осторожны, когда речь идет о типах DATETIME и SMALLDATIME , так как можете получить данные, которые будут неожиданным образом влиять на ваши результаты. Если есть возможность использовать DATETIME2 , то используйте его.
Ошибка #6: Делать лишнюю работу для удаления времени из полной даты
Часто вас интересует только день без времени и вы хотите обнулить время или совсем избавиться от него. До SQL Server 2008 приходилось немного потрудиться, чтобы получить только дату, но теперь есть тип DATE , который делает нашу жизнь проще:
Здесь мы просто преобразуем значение DATETIME2 в значение DATE , и все работает отлично:
Мы можем также легко преобразовать значение DATETIME в значение DATE и получить такие же результаты:
Также можем преобразовать наше исходное значение в тип TIME :
Как и ожидалось, SELECT теперь возвращает только время:
Прежде чем мы продолжим, обязательно обратите внимание на типы данных DATE и TIME . Если в вашей конкретной ситуации они вам доступны, то используйте их и забудьте об остальной части этого раздела. Эти типы являются лучшими способами для получения даты из значений даты со временем.
Однако если у вас нет такой возможности, тогда вы должны искать другие решения. Один из вариантов заключается в следующем:
Как видите, мы преобразовываем дату сначала в строку, используя формат ISO (112), а затем обратно в DATETIME , и получаем следующий результат:
Хотя это решение работает, но оно не сделает SQL Server счастливым. Для одной или двух строк это не проблема, но представьте, если вы конвертируете миллионы строк.
Решением получше будет использование системных функций DATEADD и DATEDIFF для обнуления этих дат:
Здесь мы вычисляем количество дней между нулевым днем (1 января 1900 г.) и нашей датой. А затем добавляем разницу к нулевому дню, получая следующий результат:
В этом случае SQL Server будет счастлив, потому что он сможет воспользоваться целочисленной природой DATETIME .
Аналогичный подход заключается в том, чтобы вместо нулевого дня указать какую-то другую дату:
Здесь мы также получаем нужный нам результат, вычисляя разницу между 1 января 2001 г. и указанной датой. Самое интересное в этом подходе то, что мы можем использовать его немного для других целей. Например, мы можем получить первый день месяца для указанной даты:
Все, что мы сделали, это изменили аргумент DAY на MONTH . И получили следующий результат:
Если мы изменим дату, указанную в функции DATEADD , на один день раньше нашей базовой даты, мы можем получить последний день предыдущего месяца:
Теперь SELECT возвращает следующие результаты:
Даже если вам доступны типы DATE и TIME , то эти два последних примера могут быть удобными для получения необходимых вам данных.
Ошибка #7: Не понимать как работает функция DATEDIFF
Раз уж мы заговорили о функции DATEDIFF , то стоит присмотреться к ней повнимательнее. Если мы не будем осторожны при ее использовании, то можем получить странные результаты. Например, пытаемся определить количество минут между двумя значениями даты/времени:
В этом случае SELECT возвращает значение 1, то есть целую минуту, несмотря на то, что между этими датами разница всего в одну секунду.
То же самое произойдет, если мы попытаемся найти разницу в часах:
На этот раз SELECT показывает, что разница между значениями составляет один час, а не одну секунду.
То же самое происходит с месяцами:
Опять же, мы получаем один месяц. Если будем искать годы, то получим аналогичные результаты. Но мы все еще говорим только об одной секунде.
Проблема не в самой функции DATEDIFF , а, скорее, в нашем понимании того, как она работает. SQL Server смотрит не дальше той части даты (будь то год, месяц, час или минута), которую мы указали. Поэтому если указать месяц, то сравниваются годы и месяцы, но не более. Значения могут отличаться всего на одну секунду, но SQL Server заботят только годы и месяцы.
Один из способов это обойти — опуститься на один уровень глубже, чем нам нужно. Например, мы хотим получить количество минут между двумя значениями. Вместо этого мы можем получить количество секунд, а затем разделить на 60:
Теперь SELECT возвращает 0.0166666, а не 1, что гораздо ближе к истине.
Ошибка #8: Небрежно относиться к условиям поиска
Использование даты и времени в условиях поиска — дело тонкое и надо быть осторожным. Не проявляя должной внимательности, вы можете получить неправильные данные или, что еще хуже, что-то изменить или удалить по ошибке.
Чтобы продемонстрировать, почему это может быть проблемой, давайте создадим временную таблицу и заполним ее несколькими строками, которые содержат DATETIME2 :
Теперь попробуем выбрать строки на 7 мая 2015 года:
Как мы видим, наш запрос возвращает только одну строку, когда мы хотим видеть две:
| ColA | ColB |
|---|---|
| 103 | 2015-05-07 00:00:00.000 |
Проблема с получением данных таким образом заключается в том, что тип данных DATETIME2 , как и другие типы данных даты/времени, хранят и дату и время. Причем время часто отличается от полуночи (это когда все нули). Однако, когда мы сравниваем со значением, в котором хранится только дата без времени, то SQL Server использует полночь (00:00:00) для времени.
В результате, сравнение, подобное приведенному выше, отбрасывает все строки, кроме тех, которые соответствуют указанной дате и полуночи для времени.
Один из обходных путей — это преобразовать данные из таблицы в тип, соответствующий только дате:
Теперь SELECT возвращает результаты, которые мы хотим:
| ColA | ColB |
|---|---|
| 103 | 2015-05-07 00:00:00.000 |
| 104 | 2015-05-07 17:33:36.321 |
Проблема такого подхода заключается в том, что, как упоминалось ранее, SQL Server не любит таких преобразований. SQL Server не может ни эффективно использовать индексы, ни извлечь выгоду от целочисленной природы типов даты/времени.
Из-за этих проблем иногда обращаются к оператору BETWEEN :
На этот раз, однако, мы получаем больше строк, чем мы рассчитывали:
| ColA | ColB |
|---|---|
| 101 | 2015-05-06 22:43:55.123 |
| 102 | 2015-05-06 23:59:59.997 |
| 103 | 2015-05-07 00:00:00.000 |
| 104 | 2015-05-07 17:33:36.321 |
| 105 | 2015-05-08 00:00:00.000 |
Проблема здесь в том, что оператор BETWEEN при поиске включает начальную и конечную даты. Давайте попробуем указать только дату, которая нас интересует:
И снова SELECT возвращает только одну строку:
| ColA | ColB |
|---|---|
| 103 | 2015-05-07 00:00:00.000 |
На этот раз проблема похожа на использование WHERE ColB = ‘2015-05-07’ . Оператор WHERE обрабатывает условие на основе полного значения даты со временем, поэтому наше условие WHERE, на самом деле, выглядит следующим образом:
Конечно, это условие соответствует только одной строке. Однако, мы можем решить эту проблему, если добавим время к конечной дате.
Теперь оператор SELECT возвращает результат, который мы хотим получить:
| ColA | ColB |
|---|---|
| 103 | 2015-05-07 00:00:00.000 |
| 104 | 2015-05-07 17:33:36.321 |
Хотя этот подход отлично работает для DATETIME2 , но мы можем упростить код, используя в условии операторы сравнения:
Оператор SELECT снова возвращает нужные нам результаты, сохраняя при этом наш запрос простым. Такой подход также является лучшим способом работы с типом DATETIME .
Предположим, что мы изначально определили ColB как DATETIME и заполнили таблицу:
Теперь давайте проверим BETWEEN с указанием точного времени:
SELECT возвращает три строки:
| ColA | ColB |
|---|---|
| 103 | 2015-05-07 00:00:00.000 |
| 104 | 2015-05-07 17:33:36.320 |
| 105 | 2015-05-08 00:00:00.000 |
Такой результат получается, потому что мы сравниваем даты в BETWEEN со значением DATETIME в таблице. SQL Server округляет значения, которые мы указали в условиях поиска, чтобы соответствовать точности DATETIME . Это приводит к тому, что наша конечная дата переносится на следующий день, и в выборку попадает строка, соответствующая этому дню. Чтобы обойти это, мы можем снова обратиться к операторам сравнения:
Теперь, как мы и ожидаем, возвращается две строки:
| ColA | ColB |
|---|---|
| 103 | 2015-05-07 00:00:00.000 |
| 104 | 2015-05-07 17:33:36.320 |
Итак, использование операторов сравнения в условиях поиска остается лучшим подходом независимо от используемого типа данных для времени/даты.
Ошибка #9: Забыть о диапазонах в типах данных для даты/времени
Это может показаться очевидным, но об этом все-таки стоит сказать. Если вы конвертируете данные из одного типа даты/времени в другой, то вы должны помнить о допустимых диапазонах дат.
Мы пытаемся преобразовать значение DATETIME2 с 1623-годом в значение DATETIME . К сожалению, тип данных DATETIME поддерживает только годы с 1753 по 9999. Хотя это хорошо для тех, кто смотрит в будущее. Но не для тех, кто увлекается историей или хочет выполнять запросы, аналогичные приведенному выше, который приводит к результатам, подобным следующему:
Сообщение довольно очевидно. Тип данных DATETIME не имеет никакого отношения к 1623 году.
Тип данных SMALLDATETIME еще более ограничен:
Оператор SELECT снова вернет ошибку «out-of-range», потому что тип данных SMALLDATETIME поддерживает только годы с 1900 по 2079. При преобразовании данных из одного типа в другой обязательно учитывайте эти ограничения.
Ошибка #10: Не использовать преимуществ функций работы с датой и временем
В SQL Server 2008 добавлены отличные встроенные функции для работы с датой и временем, и было бы стыдно не воспользоваться ими в полной мере. Некоторые, однако, откроют для себя новый мир за пределами GETDATE или GETUTCDATE .
Давайте посмотрим на некоторые функции даты и времени в действии:
Как видно из результатов, у нас есть множество вариантов, из которых можно выбрать:
Функция SYSDATETIME возвращает текущую дату и время в виде DATETIME2 . Функция SYSUTCDATETIME возвращает те же данные, но в виде UTC-значения. Функция SYSDATIMEOFFSET возвращает текущую дату и время как DATETIMEOFFSET , что означает также получение UTC-смещения.
В SQL Server 2008 также улучшены функции DATENAME и DATEPART для поддержки новых типов даты/времени. Теперь они включают в себя параметры для части даты: микросекунды, наносекунды и UTC-смещение. В следующем примере показаны эти возможности, используемые в функции DATENAME :
| Microseconds | Nanoseconds | TimezoneOffset |
|---|---|---|
| 904672 | 904672200 | -07:00 |
Функция DATEPART работает практически так же:
| Microseconds | Nanoseconds | TimezoneOffset |
|---|---|---|
| 904672 | 904672200 | -420 |
Результаты довольно похожи на DATENAME , за исключением смещения, отображаемого в минутах, а не в часах.
Вы должны быть знакомы со всеми функциями даты/времени, потому что они могут повысить вашу эффективность при работе с датой/временем, особенно если вы используете новые типы даты/времени.
На этом все. Ждем ваши комментарии и приглашаем на бесплатный вебинар на тему: «Parameter sniffing в SQL Server: что это и почему возникает».
Источник