В этой статье научимся узнаем, как работают даты в 1С. Тип Дата — это один из примитивных типов 1С 8.3. При помощи этого типа в программе 1С можно задать дату (например, 10 ноября 2019 года), время (например, 12 часов 32 минуты 45 секунд), а также дату с временем (например, 10 ноября 2019 года 12 часов 32 минуты 45 секунд). В этой статье мы научимся создавать переменные с типом дата, создавать реквизиты объектов с типом дата и работать на форме с этим типом. А также научимся выполнять элементарные операции над датами.

Создаем программно даты в 1С

Научимся программным способом создать переменную с типом дата. Сделать это можно двумя вариантам. Первый, при помощи ординарных кавычек, в которых дата задается в следующем формате:

‘ГГГГММДДЧЧММСС’

Где:

ГГГГ – цифры года даты,

ММ —  цифры месяца даты

ДД – цифры дня даты

ЧЧ – цифры часа от 0 до 23

ММ – цифры минут от 0 до 59

СС – цифры секунд от 0 до 59

Причем, дату можно задать в полном формате с минутами и секундами, а также без указания минут и секунд. То есть, вот так:

‘ГГГГММДД’.

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

‘00010101ЧЧММСС’

Рассмотрим, примеры. Создадим дату со временем, дату без времени и время с пустой датой. И также все это выведем методом Сообщить. Хотя, метод Сообщить и принимает в качестве параметра тип строка, мы можем и передать в него дату, платформа 1С автоматически её конвертирует в строку.

ПеремДатаВремя = '20190912153030';
ПеремДата      = '20190912';
ПеремВремя     = '00010101153030';

Сообщить(ПеремДатаВремя);
Сообщить(ПеремДата);
Сообщить(ПеремВремя);

И посмотрим, как это все вывелось.

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

Разберем еще один способ создания переменной с типом дата, это использование метода Дата. Этот метод имеет два варианта синтаксис:

Дата(<СтрокаДаты>)

Где:

СтрокаДаты – строка, которая задаётся в уже знакомом нам формате «ГГГГММДДЧЧММСС», принципы задания строки аналогичны принципам задания даты в ординарных кавычках.

Второй вариант

Дата(<Год>,<Месяц>,<День>,<Час>,<Минута>,<Секунда>)

Где

Год – цифра года даты,

Месяц – цифра месяца даты,

День – цифры дня даты,

Час – цифры часа

Минута – цифры минуты

Секунда – цифры секунды.

Первый три параметра являются обязательными.

Если нам нужно задать, просто дату (без времени), то будет следующий синтаксис.

Дата(<Год>,<Месяц>,<День>)

А если нужно задать время, то года, месяц и день будут равны 1:

Дата(1,1,1,<Час>,<Минута>,<Секунда>)

Переделаем предыдущий пример.

ПеремДатаВремя = Дата("20190912153030");
ПеремДата      = Дата(2019,9,12);
ПеремВремя     = Дата(1,1,1,15,30,30);

Здесь я использовал два синтаксиса метода Дата. Первый синтаксис, по сути, преобразует строку в дату (строка естественно должна быть задана по правилам). Второй синтаксис, позволяет задать дату при помощи типа число.

Реквизит с типом дата в объектах 1С

Для того, чтобы какой-то реквизит объекта 1С 8.3 был датой, достаточно указать ему соответствующий тип. Например, как мы это делаем со справочником.

Причем у любого реквизита с типом дата имеется состав даты. Это Дата, Время и Дата и время.

В зависимости от того, какой состав даты выбран, такой вид даты и можно будет указать в форме объекта.

Состав даты Дата.

Состав даты Время.

Состав даты Дата и время.

Причем, не имеет значения, какой состав даты выбран, дата запишется полностью в формате ГГГГММДДЧЧММСС. Просто в зависимости от состава даты, или время будет равняться нулю (если выбран состав даты Дата), или год, месяц, день будут равняться единицы.

Дата на управляемой форме 1С

На управляемую форме 1С можно поместить реквизит с типом дата, у которого, также, имеется возможность выбрать состав даты: Дата, Время, Дата и время.

Если мы поместим этот реквизит на форму, то он разместится в виде поля ввода.

Причем у этого поля ввода имеется справа кнопка, при нажатии на которую будет открыто окно выбора даты.

Это окно появляется в том случае, если состав даты реквизита или Дата, или Дата и время.

А отвечает за появление этой кнопки свойство поля ввода «Кнопка выбора».

Посмотрим, как записывается дата, в зависимости от значения состава даты.

Для этого у поля ввода я создам событие при изменении.

В этом событии я напишу простой код, в котором буду в сообщении выводить реквизит управляемой формы, созданный ранее.

&НаКлиенте
Процедура РеквизитДатаПриИзменении(Элемент)
    Сообщить(РеквизитДата);
КонецПроцедуры

Посмотрим, что вернет этот метод, когда состав даты реквизита — Дата.

Когда состав даты реквизита — Время

Когда состав даты реквизита – Дата и время

Вы убедились наглядно, что независимо от состава даты, у нас дата всегда записывается в формате ГГГГММДДЧЧММСС.

Разность дат в 1С

В 1С 8.3 имеется возможность вычитать одну дату из другой, или получать разность дат. В этом случае разность будет равна количеству секунд между датами.

Например, создадим две даты разностью в минуту, вычтем одну из другой.

Дата1 = Дата(2019,4,20,15,0,0);
Дата2 = Дата(2019,4,20,15,1,0);

Разность = Дата2 - Дата1;

Сообщить(Дата1);
Сообщить(Дата2);
Сообщить(Разность);

И посмотрим, какая разница.

Мы получили количество секунд разности между Дата2 и Дата1. Если мы вычтем наоборот.

Дата1 = Дата(2019,4,20,15,0,0);
Дата2 = Дата(2019,4,20,15,1,0);

Разность = Дата1 - Дата2;  

То поскольку Дата2 раньше на временной оси, чем Дата1, то получим разность с отрицательным знаком.

Прибавить дату 1С

Мы также, можем прибавить к дате нужное количество секунда. Делается это просто: к определенной дате, прибавляется то количество секунд, которое нам нужно.

Например, прибавим к дате минуту, час, день.

Дата1 = Дата(2019,4,20,15,0,0);
//прибавим минуту
Дата1ПлюсМинута = Дата1 + 60;
//прибавим час
Дата1ПлюсЧас    = Дата1 + 60*60;
//прибавим день
Дата1ПлюсДень   = Дата1 + 60*60*24;

Сообщить(Дата1);
Сообщить(Дата1ПлюсМинута);
Сообщить(Дата1ПлюсЧас);
Сообщить(Дата1ПлюсДень);

Посмотрим на результат:

Также можно и вычесть дату.

Дата1 = Дата(2019,4,20,15,0,0);
//вычтем минуту
Дата1МинусМинута = Дата1 - 60;
//вычтем час
Дата1МинусЧас    = Дата1 - 60*60;
//вычтем день
Дата1МинусДень   = Дата1 - 60*60*24;

Сообщить(Дата1);
Сообщить(Дата1МинусМинута);
Сообщить(Дата1МинусЧас);
Сообщить(Дата1МинусДень);

Посмотрим на результат:

Этим способом рекомендую прибавлять к датам и вычитать из дат небольшие значения (до дня), для прибавления месяцев и выше, в платформе 1С имеется способ, который будет рассмотрен в следующей статье.

Другие статьи о примитивных типах:

Пустая дата в 1С

Функции для работы с датами

Примитивный тип Строка

Примитивный тип Булево

Примитивный тип Число

Более подробно и основательно начальные вопросы программирования в 1С есть вы можете изучить в
Книга «Программировать в 1С за 11 шагов»

Изучайте программирование в 1С в месте с моей книгой «Программировать в 1С за 11 шагов»

Книга написана понятным и простым языком — для новичка.

1. Книга посылается на электронную почту в формате PDF. Можно открыть на любом устройстве!
2. Научитесь понимать архитектуру 1С;
3. Станете писать код на языке 1С;
4. Освоите основные приемы программирования;
5. Закрепите полученные знания при помощи задачника.

О том как разрабатывать под управляемым приложением 1С, читайте в книге Книга «Основы разработки в 1С: Такси»

Отличное пособие по разработке в управляемом приложении 1С, как для начинающих разработчиков, так и для опытных программистов.

1. Очень доступный и понятный язык изложения
2. Книга посылается на электронную почту в формате PDF. Можно открыть на любом устройстве!
3. Поймете идеологию управляемого приложения 1С
4. Узнаете, как разрабатывать управляемое приложение;
5. Научитесь разрабатывать управляемые формы 1С;
6. Сможете работать с основными и нужными элементами управляемых форм
7. Программирование под управляемым приложением станет понятным

Промо-код на скидку в 15% — 48PVXHeYu

Эти книги, плюс книга по программированию оперативного учета имеются в едином комплекте: комплект книг по разработке в 1С.
Только для читателей моего блога,
промо-код на скидку в 300 рублей на весь комплект: blog

Если Вам понравился этот урок, был полезен или помог решить какую-нибудь проблему, то Вы можете поддержать мой проект, перечислив любую сумму.

можно оплатить вручную:

Яндекс.Деньги — 410012882996301
Web Money — R955262494655

Вступайте в мои группы:

Вконтакте: https://vk.com/1c_prosto
Фейсбуке: https://www.facebook.com/groups/922972144448119/
ОК: http://ok.ru/group/52970839015518
Твиттер: https://twitter.com/signum2009