Angular Utils Converter

Librería Angular con utilidades de conversión.

Uso

Simplemente importar y utilizar las clases de conversión necesarios, por ejemplo NumberConverter para conversiones asociadas a números.
Además se puede proveer determinada configuración inicial para cada uno de los servicios de conversión. Se describe esta conversión en las siguientes secciones.

Si se necesita uasr en puntos donde no se pueden inyectar los services conversores entonces una posibilidad es declarar variables globales para los conversores y darles valor en el AppLoadService, luego en los puntos necesarios se usan las variables globales ya inicializadas en el load. Ver esta forma en proyecto https://gitlab.com/ort-activo-fijo/ort-activo-fijo-frontend.

Conversores disponibles

NumberConverter

Se puede proveer la siguiente configuración inicial mediante el token ANGULAR_NUMBER_CONVERTER_CONFIG.

interface AngularNumberConverterConfig {
    /**
     * Cantidad de decimales por defecto a usar para las utilidades de encode y decode.
     * Default 2.
     */
    defaultEncodeDecodeDecimals?: number;
    /**
     * Cantidad de decimales minima por defecto a usar en la utilidad formatNumber.
     * Default 2.
     */
    defaultMinimumFractionDigits?: number;
    /**
     * Cantidad de decimales máxima por defecto a usar en la utilidad formatNumber.
     * Default 2.
     */
    defaultMaximumFractionDigits?: number;
}

Utilidades de conversión disponibles:

• encodeNumber(value: number | null | undefined, decimals?: number): string | undefined

• decodeNumber(value: string | null | undefined, decimals?: number): number | undefined

• parseFloat(numStr: string | null | undefined): number | undefined

• roundNumber(value: number | null | undefined, roundingDecimals: number): number | undefined

• formatNumber(value: number | null | undefined, options?: ShowStringNumberOptions): string | undefined

DateConverter

Se puede proveer la siguiente configuración inicial mediante el token ANGULAR_DATE_CONVERTER_CONFIG.

interface AngularDateConverterConfig {
    /**
     * Patrón por defecto a usar para formatear fechas en la utilidad displayDate()
     * cuando se requiere transformar solo la parte de fecha.
     * Default 'dd/MM/yyyy'.
     */
    displayDatePattern?: string;
    /**
     * Patrón por defecto a usar para formatear fechas en la utilidad displayDate()
     * cuando se requiere transformar solo la parte de hora.
     * Default 'HH:mm:ss'.
     */
    displayTimePattern?: string;
    /**
     * Patrón por defecto a usar para formatear fechas en la utilidad displayDate()
     * cuando se requiere transformar toda la fecha con hora.
     * Default 'dd/MM/yyyy HH:mm:ss'.
     */
    displayDatetimePattern?: string;
}

Utilidades de conversión disponibles:

• encodeDate(value: Date | null | undefined, options?: DateFormatOptions): string | undefined

• decodeDate(value: string | null | undefined, options?: DateDecodeOptions): Date | undefined

• displayDate(value: Date | null | undefined, options?: DateFormatOptions): string | undefined

QueryStringConverter

Se puede proveer la siguiente configuración inicial mediante el token ANGULAR_QUERYSTRING_CONVERTER_CONFIG.

interface AngularQueryStringConverterConfig {
    /**
     * Nombre por defecto del campo de ordenación dentro del objeto de query params.
     * Default 'orderBy'.
     */
    defaultOrderFieldName?: string;
}

Utilidades de conversión disponibles:

• toQueryString(params: object, options?: QueryStringOptions): string