#1379: NumberFormatter.kt

Structure du code

Annotations : param, JvmOverloads, JvmStatic, return, see

Objets : NumberFormatter, is, is, is

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

Propriétés (5) : df, useLocale, amount, format, bigDecimal

Importations : 10 paquetages

Paquetage : org.projectforge.framework.utils

Code source (abrégé)

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 Formater cette valeur.
   * @param pattern La chaîne de format pour [DecimalFormat].
   * @param roundingMode [RoundingMode.HALF_UP] est la valeur par défaut.
   * @return Le nombre formaté ou une chaîne vide si la valeur est nulle.
   * @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 Formater cette valeur.
   * @param pattern La chaîne de format pour [DecimalFormat].
   * @param locale La locale à utiliser.
   * @param roundingMode [RoundingMode.HALF_UP] est la valeur par défaut.
   * @return Le nombre formaté ou une chaîne vide si la valeur est nulle.
   */
  @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)
  }

  /**
   * Retourne la valeur entière donnée sous forme de chaîne de caractères.
   *
   * @param value La valeur entière à convertir.
   * @param scale Mise à l’échelle de la sortie, null est la valeur par défaut (échelle de l’objet utilisée).
   * @return La représentation sous forme de chaîne ou une chaîne vide/nulle si la valeur est nulle.
   */
  @JvmStatic
  fun format(value: Number?, locale: Locale): String {
    return internalFormat(value, locale = locale) ?: ""
  }

  /**
   * Retourne la valeur entière donnée sous forme de chaîne de caractères.
   *
   * @param value La valeur entière à convertir.
   * @param scale Mise à l’échelle de la sortie, null est la valeur par défaut (échelle de l’objet utilisée).
   * @return La représentation sous forme de chaîne ou une chaîne vide/nulle si la valeur est nulle.
   */
  @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)
  }

  /**
   * Retourne la valeur entière donnée sous forme de chaîne de caractères (échelle = 2).
   *
   * @param value La valeur entière à 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}"
    }
  }

  /**
   * Retourne la valeur entière donnée sous forme de chaîne de caractères.
   *
   * @param value La valeur entière à convertir.
   * @param defaultValue Pour les valeurs nulles, cette valeur sera retournée (par défaut "").
   * @param scale Mise à l’échelle de la sortie, null est la valeur par défaut (échelle de l’objet utilisée).
   * @return La représentation sous forme de chaîne ou une chaîne vide/nulle si la valeur est nulle.
   */
  @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
// ... (tronqué, total 152 lignes)

Historique Git

868d6abb7 2025 -> 2026
63081666f En-têtes des fichiers source : 2024 -> 2025.
b6092df09 Droits d’auteur 2023 -> 2024
ab45d51fa Droits d’auteur 2001-2022 -> 2001-2023.
dcfc7c1a9 Ancien calendrier déplacé dans le sous-menu, ScriptingTask*, JiraUtils