Функции даты и времени
Приведенный ниже список содержит функции даты и времени, которые можно использовать в выражениях.
| Функция | Описание |
|---|---|
| DateAdd(Arg1, Arg2, Arg3) | Добавляет интервал к значению Date, Time или DateTime. Этот способ позволяет добавить значение типа TimeSpan или Integer, представляющее указанную часть даты или времени (например, количество дней). Если добавляется значение типа TimeSpan, необходимы два аргумента: столбцы DateTime и TimeSpan. При добавлении в часть даты или времени целого числа требуются три аргумента: Arg1 — это строка, описывающая часть для добавления; Arg2 — это число добавляемых частей; Arg3 — это столбец Date, Time или DateTime. Допустимые аргументы для Arg1: «year» или «yy» — год; «quarter» или «qq» — квартал; «month» или «mm» — месяц; «day» или «dd» — день; «week» или «wk» — неделя; «hour» или «hh» — час; «minute» или «mi» — минута; «second» или «ss» — секунда; «millisecond» или «ms» — миллисекунда. Примеры. DateAdd([Date Column], [TimeSpan Column]) DateAdd('year', 2, [Date Column]) DateAdd('month', 1, [Date Column]) |
| DateDiff(Arg1, Arg2, Arg3) | Вычисляет разность между двумя столбцами Date, Time или DateTime. Результат представляется как значение TimeSpan или как реальное значение в единицах времени (например, количество дней). Если используются два аргумента (столбец начальной даты и столбец конечной даты), то результатом будет значение TimeSpan, обозначающее полную разность. Если используются три аргумента, первым аргументом должна быть сравниваемая часть, вторым — столбец начальной даты, а третьим — столбец конечной даты. Результатом операции является действительное значение. Допустимые аргументы для Arg1: «year» или «yy» — год; «quarter» или «qq» — квартал; «month» или «mm» — месяц; «day» или «dd» — день; «week» или «wk» — неделя; «hour» или «hh» — час; «minute» или «mi» — минута; «second» или «ss» — секунда; «millisecond» или «ms» — миллисекунда. Пример. DateDiff([Order Date], [Delivery Date]) DateDiff('day', [Order Date], [Delivery Date]) Примеры см. в разделах Вычисление разницы во времени и Вычисление периодов времени. |
| DatePart(Arg1, Arg2) | Возвращает указанную часть значения Date, Time или DateTime. Arg1 — это строка, описывающая, какую часть даты нужно получить, а Arg2 — это столбец Date, Time или DateTime. Допустимые аргументы для Arg1: «year» или «yy» — год; «quarter» или «qq» — квартал; «month» или «mm» — месяц; «day of year» или «dy» — день года; «day» или «dd» — день; «year and week» или «yywk» — год и неделя; «week» или «wk» — неделя; «day of week» или «dw» — день недели; «hour» или «hh» — час; «minute» или «mi» — минута; «second» или «ss» — секунда; «millisecond» или «ms» — миллисекунда. Пример. DatePart('year', [Date Column]) |
| DateTimeNow() | Возвращает текущее системное время. Пример. DateTimeNow() Примеры см. в разделах Вычисление разницы во времени и Вычисление периодов времени. |
| Day(Arg1) | Извлекает день месяца из столбца Date или DateTime. Результатом является целое число в диапазоне от 1 до 31. Пример. Day([Date Column]) |
| DayOfMonth(Arg1) | Извлекает день месяца из столбца Date или DateTime. Результатом является целое число в диапазоне от 1 до 31. Пример. DayOfMonth([Date Column]) |
| DayOfWeek(Arg1) | Извлекает день недели из столбца Date или DateTime. Базовые данные нового столбца представляют собой целое число в диапазоне от 0 (воскресенье) до 6 (суббота), но первый день недели и формат выходных данных определяются в соответствии с региональными стандартами. Пример. DayOfWeek([Date Column]) |
| DayOfYear(Arg1) | Извлекает день года из столбца Date или DateTime. Возвращает целое число в диапазоне от 1 до 366. Пример. DayOfYear([Date Column]) |
| Days(Arg1) | Возвращает количество дней для TimeSpan в виде числа Integer в диапазоне от –10675199 до 10675199. Если аргумент является числом Integer, создается столбец TimeSpan с количеством дней в качестве входных данных. Примеры. Days([TimeSpan Column]) Days(3) |
| FiscalMonth(Arg1, Arg2) | Возвращает финансовый месяц для даты. Первым аргументом является столбец Date. Вторым аргументом (необязательным) является число месяцев, на которое необходимо сместить иерархию. Если второй аргумент не указан, используется значение свойства документа FiscalYearOffset. Формат выходных данных определяется заданными региональными стандартами. Метод FiscalMonth, когда он используется в иерархиях, отслеживает порядок сортировки месяцев, чтобы элементы визуализации отображались в правильном порядке. Например, если финансовый год заканчивается в январе, то следующий финансовый год должен начаться в феврале, как показано далее, а не в январе. Показанная на изображении иерархия построена с помощью следующего выражения: <FiscalYear([Date Column],1) NEST FiscalMonth([Date Column],1)> Примеры. FiscalMonth([Date Column], 1) FiscalMonth([Date Column]) |
| FiscalQuarter (Arg1, Arg2) | Возвращает финансовый квартал для даты (Arg1) с учетом смещения, заданного числом месяцев (Arg2). Второй аргумент указывать не обязательно. Если второй аргумент не указан, используется значение свойства документа FiscalYearOffset. Примеры. FiscalQuarter([Date Column], 1) FiscalQuarter([Date Column]) |
| FiscalYear (Arg1, Arg2) | Возвращает финансовый год для даты (Arg1) с учетом смещения, заданного числом месяцев (Arg2). Второй аргумент указывать не обязательно. Если второй аргумент не указан, используется значение свойства документа FiscalYearOffset. Примеры. FiscalYear([Date Column], 1) FiscalYear([Date Column]) |
| Hour(Arg1) | Извлекает значение часа из столбца DateTime или Time. Возвращает целое число в диапазоне от 0 до 23. Пример. Hour([Time Column]) |
| Hours(Arg1) |
Возвращает число часов для TimeSpan в виде числа Integer в диапазоне от 0 до 23. Если аргумент является числом Integer, cоздается столбец TimeSpan с количеством часов в качестве входных данных. Примеры. Hours([TimeSpan Column]) Hours(10) |
| Millisecond(Arg1) |
Извлекает значение миллисекунд из столбца DateTime или Time. Возвращает целое число в диапазоне от 0 до 999. Пример. Millisecond([Time Column]) |
| Milliseconds(Arg1) |
Возвращает количество миллисекунд для TimeSpan в виде числа Real в диапазоне от 0,0 до 999,0. Если аргумент является числом Real, создается столбец TimeSpan с количеством миллисекунд в качестве входных данных. Примеры. Milliseconds([TimeSpan Column]) Milliseconds(123.45) |
| Minute(Arg1) | Извлекает значение минут из столбца DateTime или Time. Возвращает целое число в диапазоне от 0 до 59. Пример. Minute([Time Column]) |
| Minutes(Arg1) |
Возвращает число минут для TimeSpan в виде числа Integer в диапазоне от 0 до 59. Если аргумент является числом Integer, создается столбец TimeSpan с количеством минут в качестве входных данных. Примеры. Minutes([TimeSpan Column]) Minutes(50) |
| Month(Arg1) | Извлекает значение месяца из столбца Date или DateTime. Базовыми данными нового столбца является целое число в диапазоне от 1 до 12, а формат выходных данных определяется в соответствии с региональными стандартами. Пример. Month([Date Column]) |
| Quarter(Arg1) | Извлекает значение квартала из столбца Date или DateTime. Базовыми данными нового столбца является целое число в диапазоне от 1 до 4, а формат выходных данных определяется в соответствии с региональными стандартами. Пример. Quarter([Date Column]) |
| Second(Arg1) | Извлекает значение секунд из столбца DateTime или Time. Возвращает целое число в диапазоне от 0 до 59. Пример. Second([Time Column]) |
| Seconds(Arg1) | Возвращает количество секунд для TimeSpan в виде числа Integer в диапазоне от 0 до 59. Если аргумент является числом Integer, создается столбец TimeSpan с количеством секунд в качестве входных данных. Примеры. Seconds([TimeSpan Column]) Seconds(10) |
| Today() | Возвращает текущую дату. Пример. Today() |
| TotalDays(Arg1) | Возвращает число дней для TimeSpan в виде реального значения, выраженного в полных и неполных днях. Пример. TotalDays([TimeSpan Column]) |
| TotalHours(Arg1) | Возвращает число часов для TimeSpan в виде реального значения, выраженного в полных и неполных часах. Пример. TotalHours([TimeSpan Column]) |
| TotalMilliseconds(Arg1) | Возвращает число миллисекунд для TimeSpan в виде реального значения, выраженного в полных и неполных миллисекундах. Пример. TotalMilliseconds([TimeSpan Column]) |
| TotalMinutes(Arg1) | Возвращает число минут для TimeSpan в виде реального значения, выраженного в полных и неполных минутах. Пример. TotalMinutes([TimeSpan Column]) |
| TotalSeconds() | Возвращает число секунд для TimeSpan в виде реального значения, выраженного в полных и неполных секундах. Пример. TotalSeconds([TimeSpan Column]) |
| Week(Arg1) | Извлекает значение недели из столбца Date или DateTime в виде целого числа в диапазоне от 1 до 54 (первая неделя года определяется в соответствии с заданными региональными параметрами). Пример. Week([Date Column]) |
| Year(Arg1) | Извлекает значение года из столбца Date или DateTime. Результатом является значение типа Integer. Пример. Year([Date Column]) |
| YearAndWeek(Arg1) | Извлекает значение года и недели из столбца Date или DateTime. Возвращает число типа Integer (год*100 + номер недели). Например, на основании даты 13.10.2005 будет выдано число 200541. Пример. YearAndWeek([Date Column]) |
