Package dev.frostlake.functions.scalar.file

Class FlGetLastModified

java.lang.Object

dev.frostlake.functions.BuiltInFunction

dev.frostlake.functions.scalar.file.FlGetLastModified

public class FlGetLastModified
extends BuiltInFunction

FL_GET_LAST_MODIFIED(file) — when the staged file was last modified.

Live-verified: the result type is TIMESTAMP_TZ(9), and the descriptor holds the moment as an RFC-1123 string in GMT, e.g. Mon, 03 Aug 2026 11:24:13 GMT, which FileDescriptor.parseLastModified(String) turns back into an Instant. NULL in, NULL out.

The DECLARED type is DateTimeType.TIMESTAMP_TZ, so SHOW FUNCTIONS reports the same RETURN TIMESTAMP_TZ the live catalog does. The VALUE is a LocalDateTime holding the UTC wall clock, because Frostlake carries every TIMESTAMP_* — NTZ, LTZ and TZ alike — as a LocalDateTime: SharedFunctionHelpers.toTemporalValue folds the zoned spellings onto it, and TYPEOF, the arithmetic layer and set operations recognise nothing else. Only the declared type differs from CURRENT_TIMESTAMP, which is copied here in every other respect.

Constructor Summary

Constructors

Constructor	Description
FlGetLastModified()

Method Summary

Modifier and Type	Method	Description
Object	evaluate(List<Object> args)	Computes the function's result over its already-evaluated argument values.
int	getMaxArgCount()	The most arguments a call to this function may pass; Integer.MAX_VALUE marks a variadic function (see BuiltInFunction.isVariadic()).
int	getMinArgCount()	The fewest arguments a call to this function may pass; fewer is an argument-count error.

Methods inherited from class dev.frostlake.functions.BuiltInFunction

approximateRejection, binaryRejection, booleanRejection, evaluate, fileRejection, geoRejection, getName, getReturnType, isVariadic, refusesMissingArgumentsByType, semiStructuredRejection, structuredRejection, temporalRejection, temporalRejection, temporalRejection, textRejection, uuidRejection, vectorRejection

Methods inherited from class java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Constructor Details

FlGetLastModified

public FlGetLastModified()

Method Details

evaluate

public Object evaluate(List<Object> args)

Description copied from class: BuiltInFunction

Computes the function's result over its already-evaluated argument values. A SQL NULL argument arrives as Java null, and returning null makes the SQL result NULL.

Specified by:

evaluate in class BuiltInFunction

Parameters:

args - the argument values, in call order

Returns:

the function's value for these arguments, or null for SQL NULL

getMinArgCount

public int getMinArgCount()

Description copied from class: BuiltInFunction

The fewest arguments a call to this function may pass; fewer is an argument-count error.

Specified by:

getMinArgCount in class BuiltInFunction

Returns:

the minimum accepted argument count

getMaxArgCount

public int getMaxArgCount()

Description copied from class: BuiltInFunction

The most arguments a call to this function may pass; Integer.MAX_VALUE marks a variadic function (see BuiltInFunction.isVariadic()).

Specified by:

getMaxArgCount in class BuiltInFunction

Returns:

the maximum accepted argument count