ДатаВремя

Стд::Время::ДатаВремя
Базовые типы: Форматируемое,Сравнимое

Доступность: КлиентИСервер

Локальная дата и время.

Сравнение структурное. Два экземпляра даты-времени равны, если равны их компоненты (дата, время).

Примеры

ДатаВремя{2021-07-19 13:45}

Литералы

ДатаВремя{\<дата\>\<разделитель_сегментов\>\<время\>}
- \<дата\> имеет вид: гггг-ММ-дд
- \<разделитель_сегментов\> - один из символов ` , T`
- \<время\> имеет вид: ЧЧ:мм(:cc(.ССС)?)?
ДатаВремя{} - значение по умолчанию 0001-01-01 00:00:00.000

Арифметические операции

ДатаВремя + Длительность = ДатаВремя (сложение)
ДатаВремя - Длительность = ДатаВремя (вычитание)
ДатаВремя - ДатаВремя = Длительность (вычитание)

Конструкторы

ДатаВремя

ДатаВремя(Представление: Строка)

Доступность: КлиентИСервер

Перегрузка:
ДатаВремя(Год: Число, Месяц: Число, День: Число)
ДатаВремя(Год: Число, Месяц: Число, День: Число, Час: Число, Минута: Число, Секунда: Число, Миллисекунда: Число = 0)
ДатаВремя(Дата: Дата, Время: Время)

Преобразует строковое представление Представление в соответствующий экземпляр даты-времени.

ДатаВремя

ДатаВремя(Дата: Дата, Время: Время)

Доступность: КлиентИСервер

Перегрузка:
ДатаВремя(Представление: Строка)
ДатаВремя(Год: Число, Месяц: Число, День: Число)
ДатаВремя(Год: Число, Месяц: Число, День: Число, Час: Число, Минута: Число, Секунда: Число, Миллисекунда: Число = 0)

Создает дату-время на основе переданных компонентов Дата, Время.

ДатаВремя

ДатаВремя(Год: Число, Месяц: Число, День: Число)

Доступность: КлиентИСервер

Перегрузка:
ДатаВремя(Представление: Строка)
ДатаВремя(Год: Число, Месяц: Число, День: Число, Час: Число, Минута: Число, Секунда: Число, Миллисекунда: Число = 0)
ДатаВремя(Дата: Дата, Время: Время)

Создает дату-время с нулевым временем на основе переданных компонентов Год, Месяц, День.

ДатаВремя

ДатаВремя(Год: Число, Месяц: Число, День: Число, Час: Число, Минута: Число, Секунда: Число, Миллисекунда: Число = 0)

Доступность: КлиентИСервер

Перегрузка:
ДатаВремя(Представление: Строка)
ДатаВремя(Год: Число, Месяц: Число, День: Число)
ДатаВремя(Дата: Дата, Время: Время)

Создает дату-время на основе переданных компонентов Год, Месяц, День, Час, Минута, Секунда, Миллисекунда.

Свойства

Время

ТолькоЧтение Время: Время

Доступность: КлиентИСервер

Значение времени.

Год

ТолькоЧтение Год: Число

Доступность: КлиентИСервер

Значение года.

Дата

ТолькоЧтение Дата: Дата

Доступность: КлиентИСервер

Значение Даты.

День

ТолькоЧтение День: Число

Доступность: КлиентИСервер

Значение дня.

Месяц

ТолькоЧтение Месяц: Число

Доступность: КлиентИСервер

Значение месяца.

Миллисекунда

ТолькоЧтение Миллисекунда: Число

Доступность: КлиентИСервер

Значение миллисекунд.

Минута

ТолькоЧтение Минута: Число

Доступность: КлиентИСервер

Значение минут.

Секунда

ТолькоЧтение Секунда: Число

Доступность: КлиентИСервер

Значение секунд.

Час

ТолькоЧтение Час: Число

Доступность: КлиентИСервер

Значение часа.

Методы

ВМомент

ВМомент(ЧасовойПояс: ЧасовойПояс): Момент

Доступность: КлиентИСервер

Преобразует данный экземпляр даты-времени в соответствующий момент в часовом поясе ЧасовойПояс. Если данный экземпляр является значением по умолчанию типа ДатаВремя (0001.01.01 00:00:00.000) будет возвращено значение по умолчанию для типа Момент (0001.01.01 00:00:00.000Z)

ВСтроку

ВСтроку(): Строка

Доступность: КлиентИСервер

Переопределение: ВСтроку

Возвращает строковое представление даты и времени в формате ISO-8601 ("гггг-ММ-дд'T'ЧЧ:мм:сс.ССС"). Пример: "2020-04-16T23:30:40.345".

ДеньГода

ДеньГода(): Число

Доступность: КлиентИСервер

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

ДеньНедели

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

Доступность: КлиентИСервер

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

ДобавитьГоды

ДобавитьГоды(Годы: Число): ДатаВремя

Доступность: КлиентИСервер

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

ДобавитьДни

ДобавитьДни(Дни: Число): ДатаВремя

Доступность: КлиентИСервер

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

ДобавитьМесяцы

ДобавитьМесяцы(Месяцы: Число): ДатаВремя

Доступность: КлиентИСервер

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

ДобавитьМиллисекунды

ДобавитьМиллисекунды(Миллисекунды: Число): ДатаВремя

Доступность: КлиентИСервер

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

ДобавитьМинуты

ДобавитьМинуты(Минуты: Число): ДатаВремя

Доступность: КлиентИСервер

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

ДобавитьСекунды

ДобавитьСекунды(Секунды: Число): ДатаВремя

Доступность: КлиентИСервер

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

ДобавитьЧасы

ДобавитьЧасы(Часы: Число): ДатаВремя

Доступность: КлиентИСервер

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

КонецГода

КонецГода(): ДатаВремя

Доступность: КлиентИСервер

Возвращает значение даты-времени, соответствующее концу года, содержащего текущую дату-время.

КонецДня

КонецДня(): ДатаВремя

Доступность: КлиентИСервер

Возвращает значение даты-времени, соответствующее концу дня, содержащего текущую дату-время.

КонецКвартала

КонецКвартала(): ДатаВремя

Доступность: КлиентИСервер

Возвращает значение даты-времени, соответствующее концу квартала, содержащего текущую дату-время.

КонецМесяца

КонецМесяца(): ДатаВремя

Доступность: КлиентИСервер

Возвращает значение даты-времени, соответствующее концу месяца, содержащего текущую дату-время.

КонецМинуты

КонецМинуты(): ДатаВремя

Доступность: КлиентИСервер

Возвращает значение даты-времени, соответствующее концу минуты, содержащей текущую дату-время.

КонецСекунды

КонецСекунды(): ДатаВремя

Доступность: КлиентИСервер

Возвращает значение даты-времени, соответствующее концу секунды, содержащей текущую дату-время.

КонецЧаса

КонецЧаса(): ДатаВремя

Доступность: КлиентИСервер

Возвращает значение даты-времени, соответствующее концу часа, содержащего текущую дату-время.

НачалоГода

НачалоГода(): ДатаВремя

Доступность: КлиентИСервер

Возвращает значение даты-времени, соответствующее началу года, содержащего текущую дату-время.

НачалоДня

НачалоДня(): ДатаВремя

Доступность: КлиентИСервер

Возвращает значение даты-времени, соответствующее началу дня, содержащего текущую дату-время.

НачалоКвартала

НачалоКвартала(): ДатаВремя

Доступность: КлиентИСервер

Возвращает значение даты-времени, соответствующее началу квартала, содержащего текущую дату-время.

НачалоМесяца

НачалоМесяца(): ДатаВремя

Доступность: КлиентИСервер

Возвращает значение даты-времени, соответствующее началу месяца, содержащего текущую дату-время.

НачалоМинуты

НачалоМинуты(): ДатаВремя

Доступность: КлиентИСервер

Возвращает значение даты-времени, соответствующее началу минуты, содержащей текущую дату-время.

НачалоСекунды

НачалоСекунды(): ДатаВремя

Доступность: КлиентИСервер

Возвращает значение даты-времени, соответствующее началу секунды, содержащей текущую дату-время.

НачалоЧаса

НачалоЧаса(): ДатаВремя

Доступность: КлиентИСервер

Возвращает значение даты-времени, соответствующее началу часа, содержащего текущую дату-время.

Представление

Представление(): Строка

Доступность: КлиентИСервер

Переопределение: Представление

Перегрузка:
Представление(Формат: Строка): Строка

Возвращает строковое представление даты-времени в формате "дд.ММ.гггг ЧЧ:мм:сс". Пример: "16.04.2020 23:30:40".

Для значения по умолчанию 0001-01-01 00:00:00.000 возвращается пустая строка.

Представление

Представление(Формат: Строка): Строка

Доступность: КлиентИСервер

Переопределение: Представление

Перегрузка:
Представление(): Строка

Возвращает строковое представление даты-времени в указанном формате Формат. Форматная строка представляет собой строку из следующих элементов:

г - краткий номер года без лидирующего нуля;
гг - краткий номер года с лидирующим нулем;
гггг - полный номер года.
К - порядковый номер квартала в году;
М - месяц в диапазоне от 1 до 12;
ММ - месяц в диапазоне от 01 до 12 (с лидирующим нулем);
МММ - краткое название месяца; Если название месяца используется вместе с днем (дд и MM), то месяц отображается в родительном падеже (если применимо). Если название месяца используется отдельно от дня - в именительном (если применимо).
ММММ - полное название месяца;
д - день месяца (цифрами) без лидирующего нуля;
дд - день месяца (цифрами) с лидирующим нулем;
ддд - краткое название дня недели;
дддд - полное название дня недели;
Д - порядковый номер дня в году;
ч - час в 12-часовом варианте без лидирующих нулей;
чч - час в 12-часовом варианте с лидирующим нулем;
Ч - час в 24-часовом варианте без лидирующих нулей;
ЧЧ - час в 24-часовом варианте с лидирующим нулем;
м - минута без лидирующего нуля;
мм - минута с лидирующим нулем;
с - секунда без лидирующего нуля;
сс - секунда с лидирующим нулем;
С - миллисекунда с точностью до сотен;
СС - миллисекунда с точностью до десятков;
ССС - миллисекунда с точностью до единиц.

Для экранирования используется символ ' (одинарная кавычка).

Для значения по умолчанию 0001-01-01 00:00:00.000 возвращается пустая строка.

СГодом

СГодом(Год: Число): ДатаВремя

Доступность: КлиентИСервер

Возвращает новый экземпляр даты-времени с указанным значением года Год.

СДнем

СДнем(День: Число): ДатаВремя

Доступность: КлиентИСервер

Возвращает новый экземпляр даты-времени с указанным значением дня День.

СДнемНедели

СДнемНедели(ДеньНедели: ДеньНедели, НачалоНедели: ДеньНедели): ДатаВремя

Доступность: КлиентИСервер

Возвращает новый экземпляр даты-времени для указанного дня ДеньНедели на той же неделе. За первый день недели берется НачалоНедели, если Undefined, то первым днем недели считается [ДеньНедели.Понедельник].

СМесяцем

СМесяцем(Месяц: Число): ДатаВремя

Доступность: КлиентИСервер

Возвращает новый экземпляр даты-времени с указанным значением месяца Месяц.

СМиллисекундой

СМиллисекундой(Миллисекунда: Число): ДатаВремя

Доступность: КлиентИСервер

Возвращает новый экземпляр даты-времени с указанным значением миллисекунд Миллисекунда.

СМинутой

СМинутой(Минута: Число): ДатаВремя

Доступность: КлиентИСервер

Возвращает новый экземпляр даты-времени с указанным значением минут Минута.

ССекундой

ССекундой(Секунда: Число): ДатаВремя

Доступность: КлиентИСервер

Возвращает новый экземпляр даты-времени с указанным значением секунд Секунда.

СЧасом

СЧасом(Час: Число): ДатаВремя

Доступность: КлиентИСервер

Возвращает новый экземпляр даты-времени с указанным значением часа Час.

Сейчас

Статический Сейчас(ЧасовойПояс: ЧасовойПояс): ДатаВремя

Доступность: КлиентИСервер

Возвращает текущую дату-время в часовом поясе ЧасовойПояс.