pip-services3-commons-node/obj/src/convert/DateTimeConverter.d.ts

Portable abstractions and patterns for Pip.Services in Node.js

/**
 * Converts arbitrary values into Date values using extended conversion rules:
 * - Strings: converted using ISO time format
 * - Numbers: converted using milliseconds since unix epoch
 *
 * ### Example ###
 *
 *     let value1 = DateTimeConverter.toNullableDateTime("ABC"); // Result: null
 *     let value2 = DateTimeConverter.toNullableDateTime("2018-01-01T11:30:00.0"); // Result: Date(2018,0,1,11,30)
 *     let value3 = DateTimeConverter.toNullableDateTime(123); // Result: Date(123)
 */
export declare class DateTimeConverter {
    /**
     * Converts value into Date or returns null when conversion is not possible.
     *
     * @param value     the value to convert.
     * @returns         Date value or null when conversion is not supported.
     */
    static toNullableDateTime(value: any): Date;
    /**
     * Converts value into Date or returns current date when conversion is not possible.
     *
     * @param value     the value to convert.
     * @returns         Date value or current date when conversion is not supported.
     *
     * @see [[toDateTimeWithDefault]]
     */
    static toDateTime(value: any): Date;
    /**
     * Converts value into Date or returns default when conversion is not possible.
     *
     * @param value         the value to convert.
     * @param defaultValue  the default value.
     * @returns             Date value or default when conversion is not supported.
     *
     * @see [[toNullableDateTime]]
     */
    static toDateTimeWithDefault(value: any, defaultValue?: Date): Date;
}