.. highlightlang:: us

.. index:: SetFileTime

.. _setfiletime:

SetFileTime
===========

.. us.tag  SetFileTime NOTREADYENGLISH DATETIME FILE_MISC New550

:ref:`SetFileTime` sets the date and time at which given files were created, 
last accessed and last written to.

.. function::  n = GetFileTime(svFileNames, rmDateTime)

.. us.return

**Return Value**

*n* is the number of files where the time was set successfully.

.. us.params

**Parameters**

.. uparam:: svFileNames

   *svFileNames* is a vector of complete file names.

.. uparam:: rmDateTime

   *rmDateTime* is a matrix with three columns:

   .. list-table::
      :header-rows: 0

      * - *rmDateTime[;1]*
        - date and time the file was created.
      * - *rmDateTime[;2]*
        - date and time the file was last accessed.
      * - *rmDateTime[;3]*
        - date and time the file was last written to.

   Each element can be zero if the application does not require this
   information.

.. us.history

**History**

.. list-table::
   :header-rows: 1

   * - Version
     - Description
   * - 5.2.0
     - New

.. seealso::
   :ref:`overview-files`,
   :ref:`overview-date-and-time`,
   :ref:`GetFileTime`,
   :ref:`DT_Format`,
   :ref:`FindFiles`

:sub:`id-1556054`