Share via


SETSTAMP Function (File)

Sets a timestamp for a file.

[Ok :=]SETSTAMP(Name, Date [, Time])

Parameters

  • Name
    Type: Text or Code. The name of the file, including its path. When you enter the path, keep in mind these shortcuts:
    • You can omit the drive designation, if the file is located on the current drive.

    • You can omit the full path, if the file is located in the current directory.

    • You can enter only the subdirectory name, if the file is located in a subdirectory of the current directory.

  • Date
    Type: Date The date that you want stamped on the file.
  • Time
    Type: Time The time that you want stamped on the file.

Property Value/Return Value

Type: Boolean

If you omit this optional return value, a run-time error occurs if the file cannot be found. When you include the return value, you must handle any errors.

true if the timestamp was set; otherwise, false.

Example

The following example sets timestamp for that a file that is named varFileName. The date and time are set to the current date and on your computer respectively. The code example assumes that you have created the following file: 'C:\MyFolder\MyText.txt'. The following example requires that you create the following variables and text constant in the C/AL Globals window.

Variable name DataType

varFileName

Text

varDate

Date

varTime

Time

Text constant name DataType ENU value

Text000

Text

The timestamp for this file is Date: %1 Time: %2.

VarFileName := 'C:\MyFolder\MyText.txt';
varDate := TODAY;
varTime := TIME;
SETSTAMP(VarFileName, varDate, varTime);
MESSAGE(Text000, varDate, varTime);

See Also

Reference

File Data Type