#1379: NumberFormatter.kt

Estructura del código

Anotaciones: param, JvmOverloads, JvmStatic, return, see

Objetos: NumberFormatter, is, is, is

Funciones (9): format, format, format, format, format, formatCurrency, formatNull, internalFormat, formatPercent

Propiedades (5): df, useLocale, amount, format, bigDecimal

Importaciones: 10 paquetes

Paquete: org.projectforge.framework.utils

Código fuente (resumido)

package org.projectforge.framework.utils

import org.projectforge.Constants
import org.projectforge.framework.persistence.user.api.ThreadLocalUserContext
import java.math.BigDecimal
import java.math.BigInteger
import java.math.RoundingMode
import java.text.DecimalFormat
import java.text.NumberFormat
import java.time.Month
import java.time.format.TextStyle
import java.util.*

object NumberFormatter {
  /**
   * @param value Formatear este valor.
   * @param pattern La cadena de formato para [DecimalFormat].
   * @param roundingMode [RoundingMode.HALF_UP] es el valor predeterminado.
   * @return El número formateado o cadena vacía si el valor es nulo.
   * @see ThreadLocalUserContext.getLocale
   */
  @JvmStatic
  @JvmOverloads
  fun format(value: Number?, pattern: String, roundingMode: RoundingMode = RoundingMode.HALF_UP): String {
    value ?: return ""
    return format(value, pattern, ThreadLocalUserContext.locale!!, roundingMode)
  }

  /**
   * @param value Formatear este valor.
   * @param pattern La cadena de formato para [DecimalFormat].
   * @param locale La configuración regional a utilizar.
   * @param roundingMode [RoundingMode.HALF_UP] es el valor predeterminado.
   * @return El número formateado o cadena vacía si el valor es nulo.
   */
  @JvmStatic
  @JvmOverloads
  fun format(
    value: Number?,
    pattern: String,
    locale: Locale,
    roundingMode: RoundingMode = RoundingMode.HALF_UP
  ): String {
    value ?: return ""
    val df = DecimalFormat.getInstance(locale) as DecimalFormat
    df.applyPattern(pattern);
    df.roundingMode = roundingMode
    return df.format(value)
  }

  /**
   * Devuelve el valor entero dado como representación de cadena.
   *
   * @param value El valor entero a convertir.
   * @param scale Escalado de la salida, nulo es el valor predeterminado, lo que significa que se usa la escala del objeto.
   * @return La representación de cadena o cadena vacía/nula, si el valor es nulo.
   */
  @JvmStatic
  fun format(value: Number?, locale: Locale): String {
    return internalFormat(value, locale = locale) ?: ""
  }

  /**
   * Devuelve el valor entero dado como representación de cadena.
   *
   * @param value El valor entero a convertir.
   * @param scale Escalado de la salida, nulo es el valor predeterminado, lo que significa que se usa la escala del objeto.
   * @return La representación de cadena o cadena vacía/nula, si el valor es nulo.
   */
  @JvmStatic
  @JvmOverloads
  fun format(value: Number?, scale: Int? = null): String {
    return internalFormat(value, scale) ?: ""
  }

  @JvmStatic
  @JvmOverloads
  fun format(month: Month, locale: Locale? = ThreadLocalUserContext.locale): String {
    val useLocale = locale ?: Locale.ENGLISH
    return month.getDisplayName(TextStyle.FULL_STANDALONE, useLocale)
  }

  /**
   * Devuelve el valor entero dado como representación de cadena (escala = 2).
   *
   * @param value El valor entero a convertir.
   */
  @JvmStatic
  @JvmOverloads
  fun formatCurrency(value: Number?, withCurrencySymbol: Boolean = false): String {
    val amount = internalFormat(value, 2) ?: return ""
    return if (!withCurrencySymbol || Constants.CURRENCY_SYMBOL.isNullOrBlank()) {
      amount
    } else {
      "$amount ${Constants.CURRENCY_SYMBOL}"
    }
  }

  /**
   * Devuelve el valor entero dado como representación de cadena.
   *
   * @param value El valor entero a convertir.
   * @param defaultValue Para valores nulos, se devolverá este valor (el valor predeterminado es "").
   * @param scale Escalado de la salida, nulo es el valor predeterminado, lo que significa que se usa la escala del objeto.
   * @return La representación de cadena o cadena vacía/nula, si el valor es nulo.
   */
  @JvmStatic
  @JvmOverloads
  fun formatNull(value: Number?, scale: Int? = null): String? {
    return internalFormat(value, scale)
  }

  private fun internalFormat(
    value: Number?,
    scale: Int? = null,
    locale: Locale = ThreadLocalUserContext.locale!!
  ): String? {
    if (value == null)
      return null
// ... (truncado, total 152 líneas)

Historial de Git

868d6abb7 2025 -> 2026
63081666f Encabezados de archivos fuente: 2024 -> 2025.
b6092df09 Derechos de autor 2023 -> 2024
ab45d51fa Derechos de autor 2001-2022 -> 2001-2023.
dcfc7c1a9 Calendario antiguo movido a submenú, ScriptingTask*, JiraUtils