Documentation of straddtime

Global Index (all files) (short | long) | Local contents | Local Index (files in subdir) (short | long)

Function Synopsis

FileNamewithTime = straddtime(FileNameBase)

Help text

 Add a date and time string to a string base

 This function extends a given string with the current date and time.
 The main use is in the generation of a different filename for data 
 file each time the function is called (when the minute changed).
 The given file name base can be used for specifying the topic of
 the data.

 Syntax:  FileNamewithTime = straddtime(FileNameBase)

 Input parameter:
    FileNameBase- String containing the base of the new filename

 Output parameter:
    FileNamewithTime - extended string

 Examples:

  % Extend the string/filename 'OptResult' with the current date and time
  % the result means: created at 5th of April 2000, 20:09
  >> NewName = straddtime('OptResult');
     NewName = 'OptResult_2000_Apr_05_20-09'

 See also: straddname

Cross-Reference Information