Перейти к основному содержимому

Календарные функции

Календарные функции​

today()​

Функция today возвращает текущую календарную дату на момент вызова функции.

Примеры:

today()
подсказка

Функция today появилась в luxmsbi-pg 9.2.20

now()​

Функция now возвращает текущее время на момент вызова функции.

Примеры:

now()
подсказка

Функция now появилась в luxmsbi-pg 9.2.20

Функция dateShift(delta, unit)​

Функция dateShift с двумя аргументами работает так же, как и функция dateShift с тремя аргументами, но при этом, значение первого аргумента dt принимается равным today().

подсказка

Функция dateShift появилась в luxmsbi-pg 9.2.20

Функция dateShift(dt, delta, unit)​

Функция dateShift вычисляет новую дату на основе исходной даты dt, смещения delta и типа смещения unit. Значение delta может быть как положительным целым, так и отрицательным целым числом. Положительные значения delta дают результирующую дату в будущем, а отрицательные - в прошлом, относительно исходной даты dt. Значения unit задаются строкой и могут быть равны:

  • d или day
  • w или week
  • m или month
  • q или quarter
  • y или year

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

Примеры:

dateShift('2020-01-01', -2, m)       // 2019-11-01
dateShift('2020-01-01', -2, 'm')     // 2019-11-01
dateShift('2020-01-01', -2, month)   // 2019-11-01
dateShift('2020-01-01', -2, 'month') // 2019-11-01

dateShift('2020-01-01', 2, 'q')      // 2020-07-01
подсказка

Функция dateShift появилась в luxmsbi-pg 9.2.20

Функция toStart(unit)​

Функция toStart с одним аргументом работает так же, как и функция toStart с двумя аргументами, но при этом, значение первого аргумента dt принимается равным today().

подсказка

Функция toStart появилась в luxmsbi-pg 9.2.20

Функция toStart(dt, unit)​

Функция toStart вычисляет новую дату на основе исходной даты dt. Функция возвращает дату начала интервала указанного с помощью аргумента unit, при этом сам интервал определяется на основе даты dt.

С помощью функции toStart легко вычислять даты начала месяца, квартала, года.

Значения unit задаются строкой и могут быть равны:

  • d или day
  • w или week
  • m или month
  • q или quarter
  • y или year

Примеры:

toStart(q) // возвращает начало текущего квартала
toStart('2024-09-23', 'y') // 2024-01-01 - начало года в который попадает 23 сентября
подсказка

Функция toStart появилась в luxmsbi-pg 9.2.20

Функция toEnd(unit)​

Функция toEnd с одним аргументом работает так же, как и функция toEnd с двумя аргументами, но при этом, значение первого аргумента dt принимается равным today().

подсказка

Функция toEnd появилась в luxmsbi-pg 9.2.20

Функция toEnd(dt, unit)​

Функция toEnd вычисляет новую дату на основе исходной даты dt. Функция возвращает дату окончания интервала указанного с помощью аргумента unit, при этом сам интервал определяется на основе даты dt.

С помощью функции toEnd легко вычислять даты конца месяца, квартала, года.

Значения unit задаются строкой и могут быть равны:

  • d или day
  • w или week
  • m или month
  • q или quarter
  • y или year

Примеры:

toEnd(q) // возвращает конец текущего квартала
toEnd('2024-09-23', 'y') // 2024-12-31 - конец года в который попадает 23 сентября
подсказка

Функция toEnd появилась в luxmsbi-pg 9.2.20

Функция bound(unit)​

Функция bound с одним аргументом работает так же, как и функция bound с двумя аргументами, но при этом, значение первого аргумента dt принимается равным today().

подсказка

Функция bound появилась в luxmsbi-pg 9.2.20

Функция bound(dt, unit)​

Функция bound возвращает интервал, вычисленный на основе исходной даты dt, длительность которого соответствует аргументу unit, при этом дата dt входит в возвращаемый интервал.

Значения unit задаются строкой и могут быть равны:

  • d или day
  • w или week
  • m или month
  • q или quarter
  • y или year

Примеры:

bound(q) // возвращает интервал для текущего квартала
bound('2024-09-23', 'y') // ['2024-01-01', '2024-12-31']
подсказка

Функция bound появилась в luxmsbi-pg 9.2.20

Функция extend(delta, unit)​

Функция extend с двумя аргументами работает так же, как и функция extend с тремя аргументами, но при этом, значение первого аргумента dt принимается равным today().

подсказка

Функция extend появилась в luxmsbi-pg 9.2.20

Функция extend(dt, delta, unit)​

Функция extend возвращает интервал, начало которого равно дате dt, а конец вычисляется относительно даты dt как смещение delta измеренное в еденицах unit. Смещение может быть как положительным, так и отрицательным.

Значения unit задаются строкой и могут быть равны:

  • d или day
  • w или week
  • m или month
  • q или quarter
  • y или year

Первый параметр dt может быть интервалом, в этом случае функция extend оставит начало интервала без изменений, а окончание интервала вычислит как указанное смещение относительно начала интервала.

Примеры:

extend(1, q) // возвращает интервал с началом сегодня и окончанием через 1 квартал от сегодняшней даты.

extend('2024-09-23', 1, 'y') // ['2024-09-23', '2025-09-23']

extend('2024-09-23', 300, 'day') // ['2024-09-23', '2025-07-20']
подсказка

Функция extend появилась в luxmsbi-pg 9.2.20

Функция doty(dt)​

Функция doty возвращает день года в виде целого числа. Название функции является сокращением от Day Of The Year. Параметр dt является датой или именем столбца типа дата.

Примеры:

doty('2024-01-01') // 1
doty('2024-05-09') // 130
подсказка

Функция doty появилась в luxmsbi-pg 9.2.20

Функция woty(dt)​

Функция woty возвращает неделю года в виде целого числа. Название функции является сокращением от Week Of The Year. Параметр dt является датой или именем столбца типа дата.

Примеры:

woty('2024-01-01') // 1
woty('2021-01-01') // 53
woty('2024-05-09') // 19
подсказка

Функция woty появилась в luxmsbi-pg 9.2.20

Функция moty(dt)​

Функция moty возвращает месяц года в виде целого числа. Название функции является сокращением от Month Of The Year. Параметр dt является датой или именем столбца типа дата.

Примеры:

moty('2024-01-01') // 1
moty('2024-05-09') // 5
подсказка

Функция moty появилась в luxmsbi-pg 9.2.20

Функция qoty(dt)​

Функция qoty возвращает квартал года в виде целого числа. Название функции является сокращением от Quarter Of The Year. Параметр dt является датой или именем столбца типа дата.

Примеры:

qoty('2024-01-01') // 1
qoty('2024-12-09') // 4
подсказка

Функция qoty появилась в luxmsbi-pg 9.2.20

Функция hoty(dt)​

Функция hoty возвращает полугодие года в виде целого числа. Название функции является сокращением от Half a Year Of The Year. Параметр dt является датой или именем столбца типа дата.

Примеры:

hoty('2024-01-01') // 1
hoty('2024-08-09') // 2
подсказка

Функция hoty появилась в luxmsbi-pg 9.2.20

Функция year(dt)​

Функция year возвращает год в виде целого числа. Параметр dt является датой или именем столбца типа дата.

Примеры:

year('2024-01-01') // 2024
year('2023-05-09') // 2023
подсказка

Функция year появилась в luxmsbi-pg 9.2.20

Функция isod(dt)​

Функция isod возвращает день года по стандарту ISO 8601 в виде строки. Параметр dt является датой или именем столбца типа дата. Ответ содержит и год, и день в этом году.

Примеры:

isod('2024-01-01') // 2024-001
isod('2024-05-09') // 2024-130
подсказка

Функция isod появилась в luxmsbi-pg 9.2.20

Функция isow(dt)​

Функция isow возвращает неделю года по стандарту ISO 8601 в виде строки. Параметр dt является датой или именем столбца типа дата. Ответ содержит и год, и неделю в этом году.

Примеры:

isow('2024-01-01') // 2024-W01
isow('2021-01-01') // 2020-W53
isow('2024-05-09') // 2024-W19
подсказка

Функция isow появилась в luxmsbi-pg 9.2.20

Функция isoq(dt)​

Функция isoq возвращает квартал года по стандарту ISO 8601 в виде строки. Параметр dt является датой или именем столбца типа дата. Ответ содержит и год, и квартал в этом году.

Примеры:

isoq('2024-01-01') // 2024-Q1
isoq('2024-05-09') // 2024-Q2
подсказка

Функция isoq появилась в luxmsbi-pg 9.2.20

Функция isom(dt)​

Функция isom возвращает месяц года по стандарту ISO 8601 в виде строки. Параметр dt является датой или именем столбца типа дата. Ответ содержит и год, и месяц в этом году.

Примеры:

isom('2024-01-01') // 2024-01
isom('2024-05-09') // 2024-05
подсказка

Функция isom появилась в luxmsbi-pg 9.2.20

Функция isoy(dt)​

Функция isoy возвращает год по стандарту ISO 8601 в виде строки. Параметр dt является датой или именем столбца типа дата.

Примеры:

isoy('2024-01-01') // 2024
isoy('2023-05-09') // 2023
подсказка

Функция isoy появилась в luxmsbi-pg 9.2.20