Documentation
    Preparing search index...

    Class DateTimeProperty

    A property type that manages Dates, Timestamps, and ISO date strings. It automatically parses strings and standardizes UTC conversions depending on the global RETURN_AS setting.

    const createdAt = new DateTimeProperty({
       name: 'createdAt',
       timezone: 'UTC'
    });

    createdAt.set(new Date()); // Will store as UNIX timestamp if RETURN_AS is configured
    console.log(createdAt.val());

    Hierarchy (View Summary)

    Index

    Constructors

    constructor

    Properties

    _allows _defaultValue _events _hasChanged _htmlType _id _mandatory _name _parent _protected _timezone _value AS_IS EVENT_ONCHANGE EVENT_ONDELETE RETURN_AS TYPE UNIX_TIMESTAMP

    Accessors

    allows hasChanged htmlType mandatory name protected timezone

    Methods

    _enable clone set toJSON val

    Constructors

    Properties

    Protected_allows

    _allows: string[] = []

    Protected_defaultValue

    _defaultValue: any

    Protected_events

    _events: { [key: string]: Function } = {}

    Protected_hasChanged

    _hasChanged: boolean

    Protected_htmlType

    _htmlType: PropertyHTMLType = 'off'

    Protected_id

    _id: string

    Protected_mandatory

    _mandatory: boolean = false

    Protected_name

    _name: string

    Protected_parent

    _parent: DataObjectClass<any> | undefined

    Protected_protected

    _protected: boolean = false

    Protected_timezone

    _timezone: string

    Protected_value

    _value: any = undefined
    AS_IS: string = 'asis'

    Return behavior to return the original Date object or string as is.

    EVENT_ONCHANGE: string = 'onChange'

    Event name triggered when the property value changes.

    EVENT_ONDELETE: string = 'onDelete'

    Event name triggered when the property is deleted.

    RETURN_AS: string = DateTimeProperty.AS_IS

    Global configuration determining the default format returned by val().

    TYPE: string = 'datetime'

    The string literal type identifier for this property.

    UNIX_TIMESTAMP: string = 'unix_timestamp'

    Return behavior to auto-convert dates into numeric UNIX timestamps.

    Accessors

    • get allows(): string[]

      Returns string[]

    • get hasChanged(): boolean

      Returns boolean

    • set hasChanged(val: boolean): void

      Parameters

      • val: boolean

      Returns void

    • get htmlType(): PropertyHTMLType

      Returns PropertyHTMLType

    • set htmlType(type: PropertyHTMLType): void

      Parameters

      Returns void

    • get mandatory(): boolean

      Returns boolean

    • get name(): string

      Returns string

    • get protected(): boolean

      Returns boolean

    • get timezone(): string

      Returns string

    Methods

    Protected_enable

    • _enable(value: boolean | undefined): value is true | undefined

      Parameters

      • value: boolean | undefined

      Returns value is true | undefined

    • Creates a deep clone of the current property instance, preserving its prototype chain.

      Returns any

      A new independent instance of the property.

    • Assigns a new date value. If RETURN_AS is set to unix_timestamp, strings and JS Date objects are automatically parsed and converted to UNIX timestamps (milliseconds).

      Parameters

      • value: string | number | Date

        The date string, timestamp, or Date object to assign.

      • setChanged: boolean = true

        Whether to mark the property as modified.

      Returns DateTimeProperty

      The property instance for chaining.

    • Serializes the property for JSON stringification.

      Returns any

      The raw internal value of the property.

    • Retrieves the current value of the property, or its default value if currently undefined.

      Parameters

      • transform: any = undefined

        An optional transformation function applied to the value before returning it.

      Returns any

      The raw or transformed property value.

    Settings

    Member Visibility

    On This Page

    Constructors
    Properties
    Accessors
    Methods