add extjs 6.0.1 sources

[extjs.git] / extjs / packages / core / src / data / Types.js

/**\r
 * @deprecated Please use {@link Ext.data.field.Field field types} instead.\r
 */\r
Ext.define('Ext.data.Types', {\r
    singleton: true,\r
    requires: ['Ext.data.SortTypes']\r
}, function(Types) {\r
    var SortTypes = Ext.data.SortTypes;\r
\r
    Ext.apply(Types, {\r
        /**\r
         * @property {RegExp} stripRe\r
         * A regular expression for stripping non-numeric characters from a numeric value.\r
         * This should be overridden for localization.\r
         */\r
        stripRe: /[\$,%]/g,\r
\r
        /**\r
         * @property {Object} AUTO\r
         * This data type means that no conversion is applied to the raw data before it is placed into a Record.\r
         */\r
        AUTO: {\r
            sortType: SortTypes.none,\r
            type: 'auto'\r
        },\r
\r
        /**\r
         * @property {Object} STRING\r
         * This data type means that the raw data is converted into a String before it is placed into a Record.\r
         */\r
        STRING: {\r
            convert: function(v) {\r
                var defaultValue = this.getAllowNull() ? null : '';\r
                return (v === undefined || v === null) ? defaultValue : String(v);\r
            },\r
            sortType: SortTypes.asUCString,\r
            type: 'string'\r
        },\r
\r
        /**\r
         * @property {Object} INT\r
         * This data type means that the raw data is converted into an integer before it is placed into a Record.\r
         *\r
         * The synonym `INTEGER` is equivalent.\r
         */\r
        INT: {\r
            convert: function(v) {\r
                // Handle values which are already numbers.\r
                // Value truncation behaviour of parseInt is historic and must be maintained.\r
                // parseInt(35.9)  and parseInt("35.9") returns 35\r
                if (typeof v === 'number') {\r
                    return parseInt(v, 10);\r
                }\r
                return v !== undefined && v !== null && v !== '' ?\r
                    parseInt(String(v).replace(Types.stripRe, ''), 10) : (this.getAllowNull() ? null : 0);\r
            },\r
            sortType: SortTypes.none,\r
            type: 'int'\r
        },\r
\r
        /**\r
         * @property {Object} FLOAT\r
         * This data type means that the raw data is converted into a number before it is placed into a Record.\r
         *\r
         * The synonym `NUMBER` is equivalent.\r
         */\r
        FLOAT: {\r
            convert: function(v) {\r
                if (typeof v === 'number') {\r
                    return v;\r
                }\r
                return v !== undefined && v !== null && v !== '' ?\r
                    parseFloat(String(v).replace(Types.stripRe, ''), 10) : (this.getAllowNull() ? null : 0);\r
            },\r
            sortType: SortTypes.none,\r
            type: 'float'\r
        },\r
\r
        /**\r
         * @property {Object} BOOL\r
         * This data type means that the raw data is converted into a boolean before it is placed into\r
         * a Record. The string "true" and the number 1 are converted to boolean true.\r
         *\r
         * The synonym `BOOLEAN` is equivalent.\r
         */\r
        BOOL: {\r
            convert: function(v) {\r
                if (typeof v === 'boolean') {\r
                    return v;\r
                }\r
                if (this.getAllowNull() && (v === undefined || v === null || v === '')) {\r
                    return null;\r
                }\r
                return v === 'true' || v == 1;\r
            },\r
            sortType: SortTypes.none,\r
            type: 'bool'\r
        },\r
\r
        /**\r
         * @property {Object} DATE\r
         * This data type means that the raw data is converted into a Date before it is placed into a Record.\r
         * The date format is specified in the constructor of the {@link Ext.data.Field} to which this type is\r
         * being applied.\r
         */\r
        DATE: {\r
            convert: function(v) {\r
                var df = this.getDateReadFormat() || this.getDateFormat(),\r
                    parsed;\r
\r
                if (!v) {\r
                    return null;\r
                }\r
                // instanceof check ~10 times faster than Ext.isDate. Values here will not be cross-document objects\r
                if (v instanceof Date) {\r
                    return v;\r
                }\r
                if (df) {\r
                    return Ext.Date.parse(v, df);\r
                }\r
\r
                parsed = Date.parse(v);\r
                return parsed ? new Date(parsed) : null;\r
            },\r
            sortType: SortTypes.asDate,\r
            type: 'date'\r
        }\r
    });\r
\r
    /**\r
     * @property {Object} BOOLEAN\r
     * This data type means that the raw data is converted into a boolean before it is placed into\r
     * a Record. The string "true" and the number 1 are converted to boolean `true`.\r
     *\r
     * The synonym `BOOL` is equivalent.\r
     */\r
    Types.BOOLEAN = Types.BOOL;\r
\r
    /**\r
     * @property {Object} INTEGER\r
     * This data type means that the raw data is converted into an integer before it is placed into a Record.\r
     *\r
     * The synonym `INT` is equivalent.\r
     */\r
    Types.INTEGER = Types.INT;\r
\r
    /**\r
     * @property {Object} NUMBER\r
     * This data type means that the raw data is converted into a number before it is placed into a Record.\r
     *\r
     * The synonym `FLOAT` is equivalent.\r
     */\r
    Types.NUMBER = Types.FLOAT;\r
});\r