44. Функции для дат

Функция

Что возвращает

тДата = ТекущаяДата();

новаяДата = ДобавитьМесяц (дата, числоМесяцев);

Текущую (системную) дату. Дату, получаемую в результате прибавления к значению параметра дата заданного вторым параметром числа месяцев. Значение параметра числоМесяцев может быть меньше нуля

нМесяца = НачМесяца(дата);

Дату начала месяца, которому принадлежит дата

кМесяца = КонМесяца(дата);

Дату конца месяца, которому принадлежит дата

нКвартала = НачКвартала(дата);

Дату начала квартала, которому принадлежит дата

кКвартала = КонКвартала(дата);

Дату конца квартала, которому принадлежит дата

нГода = НачГода(дата);

Дату начала года, которому принадлежит дата

кГода = КонГода(дата);

Дату конца года, которому принадлежит дата

нНедели = НачНедели(дата);

Дату начала недели, которой принадлежит дата

кНедели - КонНедели(дата);

Дату конца недели, которой принадлежит дата

ДатаТек = РабочаяДата ([рДата], [режимСмены]);

Устанавливает/возвращает рабочую дату, то есть дату, используемую при формировании документов и проводок в текущем сеансе. Параметр режимСмены применяется при смене рабочей даты на значение параметра рДата и установки режима смены рабочей даты в полночь. Причем если режимСмены задается равным числу

• 0, то рабочая дата в полночь не меняется;

• 1, то система предлагает изменить рабочую дату в полночь;

• 2, то рабочая дата меняется в полночь автоматически.

Если параметр режимСмены не задан, то при вызове функции РабочаяДата сохраняются заданные в системе установки режима смены. Если новое значение даты - это несуществующая дата, то рабочая дата не меняется. Рабочую дату можно также изменить, воспользовавшись в 1С:Предприятии пунктами меню Сервис- Параметры и выбрав в появившемся окне закладку Общие (см. рис. 2.1). По умолчанию рабочая и текущие даты совпадают

год = ДатаГод(дата);

Числовое значение года, которому принадлежит дата

месяц = ДатаМесяц(дата);

Номер месяца, которому принадлежит дата

число = ДатаЧисло(дата);

Номер дня месяца, заданного параметром дата

неделя = НомерНеделиГода(дата);

Номер недели года, которой принадлежит дата

деньГода = НомерДняГода(дата);

Номер дня года, заданного параметром дата

деньНедели = НомерДняНедели(дата);

Номер дня недели, заданного параметром дата (нумерация дней начинается с понедельника)

период = ПериодСтр(датаНачПериода, датаКонПериода);

Символьное представление периода, границы которого задаются значениями параметров функции. Если период - это месяц, квартал, полугодие или год, то выводится соответствующее название периода, например 1 Полугодие 2002 г.

нИнтервала = НачалоСтандартногоИнтервала

([вариант]);

Устанавливает/возвращает вариант задания начала

стандартного интервала отображения журнала документов. Параметр вариант, если он имеет тип Дата, задает дату начала интервала журнала документов. Если параметр - это символьное выражение, то оно должно вычисляться со следующими значениями: "День", "Месяц", "Квартал", "Год". Если параметр опущен или содержит неверное значение, имеющаяся в системе установка сохраняется. Начало стандартного интервала можно задать в 1С:Предприятии, обратившись к пунктам меню Сервис - Параметры и выбрав в появившемся окне закладку Журналы (рис. 2.3)

кИнтервала = КонецСтандартногоИнтервала

([вариант]);

Устанавливает/возвращает вариант задания конца стандартного интервала отображения журнала документов. Параметр вариант имеет тот же, что и для предшествующей функции, смысл с той разницей, что задает конец стандартного интервала

время = ТекущееВремя([час], [мин], [сек]);

Строку, отображающую текущее (системное) время. Если заданы параметры час, мин и сек, то функция запишет в них числовые значения соответственно часа, минут и секунд текущего времени

флаг = ВвестиПериод(нПер, кПер, заг)

Единицу, если в выведенном диалоге (рис. 2.4) задания

даты начала (нПер) и даты конца (кПер) периода нажата

кнопка ОК, или нуль, если нажата кнопка Отмена, или

клавиша Esc, или кнопка, закрывающая окно диалога.

Символьный параметр заг задает заголовок диалогового

окна

Функции преобразования типов данных

Функция	Что делает
стр = Строка(параметр);	Преобразовывает значение выражения параметр в строку. Выражение может быть датой или иметь числовой или символьный тип. В последнем случае преобразований не выполняется
чис = Число(параметр);	Преобразовывает значение выражения параметр в число. Выражение может быть датой или иметь символьный или числовой тип. В последнем случае преобразований не выполняется
Вариант 1: дат = Дата(параметр); Вариант 2: дат = Дата(год, месяц, число);	В первом варианте функция преобразовывает значение выражения параметр в значение типа Дата. Выражение может быть числовым, символьным или типа Дата. В первом случае значение выражения трактуется как число дней от Рождества Христова и преобразовывается в соответствующую дату, во втором случае строка преобразовывается в дату, в третьем преобразований не выполняется. Во втором варианте функция преобразовывает дату, заданную числовыми выражениями год, месяц, число, в значение типа Дата. Причем для задания значения параметра год используются все цифры, а не две последние