The startofyear function returns the start of the year containing the date, shifted by an offset, if provided.

Syntax ​

startofyear( Date, Offset )

Arguments ​

• Date: The input date.
• Offset: An optional number of offset years from the input date (integer, default - 0).

Returns ​

A datetime representing the start of the year for the given Date value, with the offset, if specified.

Example ​

This example returns 1,767,225,600:

print yearStart = startofyear( datetime(2025-12-01 10:10:17), 1 )