Файл.ПолучитьУниверсальноеВремяИзменения

Методы · GetModificationUniversalTime

Получает универсальное время последнего изменения файла.

Синтаксис

ПолучитьУниверсальноеВремяИзменения()
Полное описание, параметры и ограничения

Файл.ПолучитьУниверсальноеВремяИзменения (File.GetModificationUniversalTime)

Файл (File)

ПолучитьУниверсальноеВремяИзменения (GetModificationUniversalTime)

Доступен, начиная с версии 8.2.

Синтаксис:
ПолучитьУниверсальноеВремяИзменения()
Возвращаемое значение:
Тип: Дата.
Универсальное время последнего изменения файла.
Описание:

Получает универсальное время последнего изменения файла.

Доступность:

Тонкий клиент, веб-клиент, мобильный клиент, сервер, толстый клиент, внешнее соединение, мобильное приложение (клиент), мобильное приложение (сервер), мобильный автономный сервер.

Примечание:
Применим только к файлам и каталогам, которые реально существуют.
Для работы метода на веб-клиенте необходимо предварительно подключить расширение работы с файлами.
См. также:
Файл, метод НачатьПолучениеУниверсальногоВремениИзменения
Файл, метод ПолучитьУниверсальноеВремяИзмененияАсинх

Использование в версии:

Доступен, начиная с версии 8.2.

Описание изменено в версии 8.3.18.

Методическая информация

Практические примеры

Задать UTC-время изменения своему файлу

Универсальное время задаём своей датой 3 октября 2026 12:00 UTC. Не подменяем его местным временем и не изменяем часы ОС.

Где и как запускать

Полный модуль пустой управляемой формы учебной EPF; клиент Windows с разрешённым доступом к своим временным файлам.

Подготовка

  1. Создайте учебную внешнюю обработку с пустой управляемой основной формой. Создайте команду УчебныйПример и кнопку этой команды.

  2. В свойстве команды Действие выберите процедуру УчебныйПример. Вставьте полный приведённый модуль формы.

  3. Откройте EPF в тонком или толстом клиенте Windows и нажмите кнопку. Не переносите Ждать и Асинх в серверный общий модуль.

  4. Файл создаётся на компьютере клиента Windows во временном каталоге. Веб-клиент и сервер для данного модуля не используйте.

  5. Требуется разрешённый в учебной базе доступ к локальной файловой системе. Не отключайте профиль безопасности рабочей базы ради запуска.

  6. Создаётся только собственный временный файл с режимом СоздатьНовый. После ожидания операций ресурсы закрываются, точное собственное имя удаляется.

  7. Файл содержит только собственную ASCII-строку ABC123 (6 байтов без BOM). Поток записи закрывается перед чтением/изменением атрибутов.

  8. Все файлы примера создаются заново. Скрытость/readonly при очистке снимаются только у собственного файла после закрытия, затем точное имя удаляется.

  9. Не заменяйте временное имя путём конфигурации, базы, документа или загруженного вами архива. Атрибуты и время меняются только у учебного файла.

  10. Здесь обычная Процедура, без Асинх/Ждать. Модуль работает только на клиенте Windows.

&НаКлиенте
Процедура УчебныйПример(Команда)
    ИмяФайла = ПолучитьИмяВременногоФайла("bin");
    УчебныйФайл = Новый Файл(ИмяФайла);
    Если УчебныйФайл.Существует() Тогда
        ВызватьИсключение "Временное имя уже занято: чужой файл не открываем";
    КонецЕсли;
    Поток = Неопределено;
    Вид = Неопределено;
    Копия = Неопределено;
    СозданСвойФайл = Ложь;
    Попытка
        Поток = Новый ФайловыйПоток(ИмяФайла, РежимОткрытияФайла.СоздатьНовый, ДоступКФайлу.ЧтениеИЗапись);
        СозданСвойФайл = Истина;
        Буфер = ПолучитьБуферДвоичныхДанныхИзСтроки("ABC123", КодировкаТекста.UTF8, Ложь);
        Поток.Записать(Буфер, 0, Буфер.Размер);
        Поток.Закрыть();
        Поток = Неопределено;
        УчебноеUTC = Дата(2026, 10, 3, 12, 0, 0);
        УчебныйФайл.УстановитьУниверсальноеВремяИзменения(УчебноеUTC);
        ФактическоеUTC = УчебныйФайл.ПолучитьУниверсальноеВремяИзменения();
        Сообщить(ФактическоеUTC = УчебноеUTC);
        Сообщить(ТипЗнч(ФактическоеUTC) = Тип("Дата"));
        Сообщить(УчебныйФайл.Размер() = 6);
    Исключение
        Если Вид <> Неопределено Тогда
            Вид.Закрыть();
        КонецЕсли;
        Если Копия <> Неопределено Тогда
            Копия.Закрыть();
        КонецЕсли;
        Если Поток <> Неопределено Тогда
            Поток.Закрыть();
        КонецЕсли;
        Если СозданСвойФайл И УчебныйФайл.Существует() Тогда
            УчебныйФайл.УстановитьТолькоЧтение(Ложь);
            УчебныйФайл.УстановитьНевидимость(Ложь);
        КонецЕсли;
        Если СозданСвойФайл И УчебныйФайл.Существует() Тогда
            УдалитьФайлы(ИмяФайла);
        КонецЕсли;
        ВызватьИсключение;
    КонецПопытки;
    Если Вид <> Неопределено Тогда
        Вид.Закрыть();
    КонецЕсли;
    Если Копия <> Неопределено Тогда
        Копия.Закрыть();
    КонецЕсли;
    Если Поток <> Неопределено Тогда
        Поток.Закрыть();
    КонецЕсли;
    Если СозданСвойФайл И УчебныйФайл.Существует() Тогда
        УчебныйФайл.УстановитьТолькоЧтение(Ложь);
        УчебныйФайл.УстановитьНевидимость(Ложь);
    КонецЕсли;
    Если СозданСвойФайл Тогда
        УдалитьФайлы(ИмяФайла);
    КонецЕсли;
    Сообщить(Не УчебныйФайл.Существует());
КонецПроцедуры

Разбор по шагам

  1. Файл создан самим уроком; перед установкой времени закрыт записывающий поток.

  2. Дата здесь по договорённости представляет UTC, а не «12 часов в Москве».

  3. Читаем обратным универсальным методом и сравниваем именно с заданным UTC. Не записываем ничего после проверки времени.

Как проверить результат

  1. На Windows/NTFS три сравнения Истина: заданное UTC, тип Дата и размер 6.

  2. Местное время может отличаться по часовому поясу; часовой пояс и системные часы урок не меняет.

  3. Последнее сравнение Истина: собственный временный файл удалён после снятия readonly/скрытости.

Ожидаемый результат

Показан контракт универсального времени изменения файла.

На что обратить внимание

  1. Файловые системы могут иметь другую точность отметок времени; расхождение надо диагностировать, а не объявлять успехом.

  2. На Windows время раньше 1601-01-01 UTC недопустимо для данного API. Здесь дата 2026 года.

Пример не запускался в вашей базе. Перед применением проверьте его в указанном учебном контексте.

Не хотите разбираться сами?

Адаптируем это решение под вашу базу. Оценка бесплатно.

Оставить задачу

1С, 1С:Предприятие — товарные знаки ООО «1С». Сайт не является официальным представительством фирмы «1С» и не аффилирован с ней.