63 документа
← К списку

Работа с датами и временем

страница

Год
День
ДеньГода
ДеньНедели
ДобавитьКДате
Квартал
КонецПериода
Месяц
Минута
НачалоПериода
Неделя
РазностьДат
ТекущаяДата
Секунда
Час

Год(Year)

Данная функция предназначена для выделения года из значения типа Дата.

Синтаксис:

Год(Дата)

Параметр:

  • Дата - тип Дата.  Дата, по которой определяют год.

Пример:

ГОД(РасхНакл.Дата)

День (Day)

Данная функция предназначена для получения дня месяца из значения типа Дата. День месяца в норме находится в диапазоне от 1 до 31.

Синтаксис:

День(Дата)

Параметр

  • Дата - тип Дата.  Дата, по которой определяют дня месяца.

Пример:

ДЕНЬ(РасхНакл.Дата)

ДеньГода (DayOfYear)

Данная функция предназначена для получения дня года из значения типа Дата. День года в норме находится в диапазоне от 1 до 365(366).

Синтаксис:

ДеньГода(Дата)

Параметр

  • Дата - тип Дата.  Дата, по которой определяют день года.

Пример:

ДЕНЬГОДА(РасхНакл.Дата)

ДеньНедели (WeekDay)

Данная функция предназначена для получения дня недели из значения типа Дата. День недели в норме находится в диапазоне от 1 (понедельник) до 7(воскресенье).

Синтаксис:

ДеньНедели(Дата)

Параметр

  • Дата - тип Дата.  Дата, по которой определяют день недели .

Пример:

ДЕНЬНЕДЕЛИ(РасхНакл.Дата)

ДобавитьКДате (DateAdd)

Функция предназначена для прибавления к дате некоторой величины.

Синтаксис:

ДобавитьКДате(Выражение, ТипУвеличения, Величина)

Параметры:

  • Выражение - тип Дата. Исходная дата;
  • ТипУвеличения - тип Строка. Содержит одно из значений:
    • Минута;
    • Час;
    • День;
    • Неделя;
    • Месяц;
    • Квартал;
    • Год;
    • Декада - При выборе значения к исходной дате будет добавлено количество дней, умноженное на 10;
    • Полугодие.
  • Величина – на сколько необходимо увеличить дату. Тип Число. Дробная часть игнорируется.

Пример:

ДобавитьКДате(ДатаВремя(2002, 10, 12, 10, 15, 34), "Месяц", 1)

Результат:

12.11.2002 10:15:34

Квартал (Quarter)

Данная функция предназначена для выделения номера квартала из значения типа Дата. Номер квартала в норме находится в диапазоне от 1 до 4.

Синтаксис:

Кварта(Дата)

Параметр

  • Дата - тип Дата.  Дата, по которой определяют квартал

Пример:

КВАРТАЛ(РасхНакл.Дата)

КонецПериода (EndOfPeriod)

Функция предназначена для выделения определенной даты из заданной даты.

Синтаксис:

КонецПериода (Дата, ТипПериода)

Параметры:

  • Дата - тип Дата. Заданная дата;
  • ТипПериода - тип Строка. Содержит одно из значений:
    • Минута;
    • Час;
    • День;
    • Неделя;
    • Месяц;
    • Квартал;
    • Год;
    • Декада;
    • Полугодие.

Пример:

КонецПериода(ДатаВремя(2002, 10, 12, 10, 15, 34), "Неделя")

Результат:

13.10.2002 23:59:59

Месяц (Month)

Данная функция предназначена для выделения номера месяца из значения типа Дата. Номер месяца в норме находится в диапазоне от 1 до 12.

Синтаксис:

Месяц(Дата)

Параметр:

  • Дата - тип Дата.  Дата, по которой определяют месяц.

Пример:

МЕСЯЦ(РасхНакл.Дата)

Минута (Minute)

Данная функция предназначена для получения минуты часа из значения типа Дата. Минута часа находится в диапазоне от 0 до 59.

Синтаксис:

Минута(Дата)

Параметр

  • Дата - тип Дата.  Дата, по которой определяют минута часа.

Пример:

МИНУТА(РасхНакл.Дата)

НачалоПериода (BeginOfPeriod)

Функция предназначена для выделения определенной даты из заданной даты.

Синтаксис:

НачалоПериода(Дата, ТипПериода)

Параметры:

  • Дата - тип Дата. Заданная дата;
  • ТипПериода - тип Строка. Содержит одно из значений:
    • Минута;
    • Час;
    • День;
    • Неделя;
    • Месяц;
    • Квартал;
    • Год;
    • Декада;
    • Полугодие.

Пример:

НачалоПериода(ДатаВремя(2002, 10, 12, 10, 15, 34), "Месяц")

Результат:

01.10.2002 0:00:00

Неделя (Week)

Данная функция предназначена для получения номера недели года из значения типа Дата. Недели года нумеруются, начиная с 1.

Синтаксис:

 

Неделя(Дата)

 

Параметр

  • Дата - тип Дата.  Дата, по которой определяют номера недели.

Пример:

НЕДЕЛЯ(РасхНакл.Дата)

РазностьДат (DateDiff)

Функция предназначена для получения разницы между двумя датами.

Синтаксис:

РазностьДат(Выражение1 , Выражение2 , ТипРазности)

Параметры:

  • Выражение1 - тип Дата. Вычитаемая дата;
  • Выражение2 - тип Дата. Исходная дата;
  • ТипРазности - тип Строка. Содержит одно из значений:
    • Секунда;
    • Минута;
    • Час;
    • День;
    • Месяц;
    • Квартал;
    • Год.

Пример:

РАЗНОСТЬДАТ(ДАТАВРЕМЯ(2002, 10, 12, 10, 15, 34),
   ДАТАВРЕМЯ(2002, 10, 14, 9, 18, 06), "ДЕНЬ")

Результат:

2

ТекущаяДата (CurrentDate)

Возвращает системную дату. При компоненовке макета компоновки во всех выражениях, которые присутствуют в компоновке, функция ТЕКУЩАЯДАТА заменяется значением текущей даты.

Пример:

ТЕКУЩАЯДАТА()

Секунда (Second)

Данная функция предназначена для получения секунды минуты из значения типа Дата. Секунда минуты находится в диапазоне от 0 до 59.

Синтаксис:

Секунда(Дата)

Параметр

  • Дата - тип Дата.  Дата, по которой определяют секунды минуты.

Пример:

СЕКУНДА(РасхНакл.Дата)

Час (Hour)

Данная функция предназначена для получения часа суток из значения типа Дата. Час суток находится в диапазоне от 0 до 23.

Синтаксис:

Час(Дата)

Параметр

  • Дата - тип Дата.  Дата, по которой определяют час суток.

Пример:

ЧАС(РасхНакл.Дата)

см. также:
                       Язык выражений системы компоновки данных
Двуязычное представление ключевых слов системы компоновки данных