Справка 1С/Система компоновки данных/Работа с датами и временем

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

•

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

Год [#Year]
День [#Day]
ДеньГода [#YearDay]
ДеньНедели [#WeekDay]
ДобавитьКДате [#AddToDate]
Квартал [#Q]
КонецПериода [#EndPeriod]
Месяц [#Month]
Минута [#Minute]
НачалоПериода [#BegPeriod]
Неделя [#Week]
РазностьДат [#DateDifference]
ТекущаяДата [#CurrentDate]
Секунда [#Second]
Час [#hour]

Год(Year)

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

Синтаксис:

Год(Дата)

Параметр:

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

    • Пример:

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

    День (Day)

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

    Синтаксис:

    День(Дата)

    Параметр

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

    • Пример:

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

    ДеньГода (DayOfYear [v8help://dcsui/SKD_Functions#YearDay])

    Данная функция предназначена для получения дня года из значения типа Дата. День года в норме находится в диапазоне от 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.

    Синтаксис:

    Час(Дата)

    Параметр

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

Пример:

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

см. также:
                       Язык выражений системы компоновки данных [v8help://dcsui/SKD_Lang]
                       Двуязычное представление ключевых слов системы компоновки данных [v8help://dcsui/PresentSKD]