FILE.CREATED (U-SQL)
Summary
Returns the creation timestamp of the file at the specified location at compile time as a DateTime value (Kind is Unspecified
).
Syntax
DateTime? CREATED( string path ).
Parameters
path
A constant-foldable string expression.path
can be any supported file path Universal Resource Identifier (URI). Ifpath
is not constant-foldable, the errorE_CSC_USER_EXPRESSIONNOTCONSTANTFOLDABLE
is raised. Ifpath
is empty (null or the zero-length string), the errorE_CSC_USER_EMPTYFILEPATH
is raised. Ifpath
contains invalid characters, the errorE_CSC_USER_INVALIDFILENAME
is raised.
Return Value
DateTime?
The creation timestamp of path
at compile time as a DateTime value (Kind is Unspecified). Null
if path
does not exists, refers to a folder or the user has no access to it.
Examples
- The example can be executed in Visual Studio with the Azure Data Lake Tools plug-in.
- The example below uses the sample data provided with your Data Lake Analytics account. See Prepare source data for additional information.
DECLARE @filepath_good = "/Samples/Data/SearchLog.tsv";
DECLARE @filepath_bad = "/Samples/Data/zzz.tsv";
@result =
SELECT FILE.CREATED(@filepath_good) AS created_datetime_good,
FILE.CREATED(@filepath_bad) AS created_datetime_bad
FROM (VALUES (1)) AS T(dummy);
OUTPUT @result
TO "/Output/ReferenceGuide/BuiltInFunctions/SystemFunctions/FileCreated.txt"
USING Outputters.Csv();