Berserk Docs
Scalar FunctionsDate & Time Functions

datetime_part

Extracts the specified part from a datetime value.

Syntax

datetime_part(part, date)

Parameters

Prop

Type

Given a dynamic field

This parameter is string-only. In permissive mode — the default — almost every field arrives as a dynamic, so passing one works because Berserk injects asstring: extract-or-null, the value when it really is a string and null otherwise, so the call yields null (a predicate yields false). A property bag or array is therefore not matched, and tostring() is never applied implicitly — use it explicitly to match a bag's JSON text, keys included. Strict mode rejects the dynamic instead of coercing it. See String coercion and the asXXX family.

Returns: int

Examples

Example 1

print datetime_part("month", datetime(2024-06-08)) // month of the Lindisfarne raid
print_0 (int)
6

Example 2

print datetime_part("year", datetime(2024-09-25)) // year of the Battle of Stamford Bridge
print_0 (int)
2024

On this page