CKTIS / Java
BigDecimal.setScale — schaal wijzigen en afronden
Stel de schaal van een `BigDecimal` in zonder de waarde te veranderen, of kies expliciet een afrondingsmodus. Het oorspronkelijke object blijft ongewijzigd.
Versie: Java SE 21
Syntax
public BigDecimal setScale(int newScale)
public BigDecimal setScale(int newScale, RoundingMode roundingMode)
@Deprecated(since = "9")
public BigDecimal setScale(int newScale, int roundingMode)BigDecimal.setScale is een instantiemethode van java.math.BigDecimal. Een niet-negatieve schaal geeft het aantal decimalen aan; schaal -1 staat voor veelvouden van tien. Schaal is niet hetzelfde als precisie (het aantal cijfers van de ongeschaalde waarde). De methode geeft een BigDecimal terug, geen opgemaakte tekst. Het oorspronkelijke object is onveranderlijk. Gebruik daarom de teruggegeven waarde; daarvoor hoeft geen nieuw object te worden gemaakt.
setScale(int) behoudt de numerieke waarde. Bij decimale notatie kan een grotere schaal eindnullen toevoegen; bij een exacte verlaging kunnen alleen nullen verdwijnen. Als afronden nodig zou zijn, gooit de methode een ArithmeticException.
setScale(int, RoundingMode) past de gekozen modus uit java.math.RoundingMode toe als het verlagen van de schaal afronding vereist. HALF_UP kiest de dichtstbijzijnde waarde op de gewenste schaal en rondt bij gelijke afstand van nul af: 2.675 wordt 2.68 op schaal 2. UNNECESSARY vereist een exact resultaat en leidt tot een ArithmeticException als afronden nodig is.
De overload setScale(int, int) is sinds Java 9 verouderd en gooit een IllegalArgumentException als het tweede argument geen geldige afrondingsmodus aangeeft. Gebruik in nieuwe code de overload met RoundingMode. Voer een exact decimaal getal in met new BigDecimal("2.675"), niet met new BigDecimal(2.675), dat de binaire benadering van de double overneemt.
Voorbeelden
import java.math.BigDecimal;
import java.math.RoundingMode;
public class Main {
public static void main(String[] args) {
BigDecimal original = new BigDecimal("2.675");
BigDecimal padded = original.setScale(4);
System.out.println(padded.toPlainString());
System.out.println(padded.setScale(3).toPlainString());
System.out.println(original.setScale(2, RoundingMode.HALF_UP).toPlainString());
try {
original.setScale(2);
} catch (ArithmeticException e) {
System.out.println("ArithmeticException");
}
System.out.println(original.toPlainString());
}
}Resultaat
2.6750 2.675 2.68 ArithmeticException 2.675
De eerste twee regels tonen hoe een eindnul wordt toegevoegd en verwijderd zonder de waarde te veranderen. De derde toont de afronding, de vierde meldt de opgevangen uitzondering en de laatste toont de ongewijzigde oorspronkelijke waarde.
Gerelateerde lessen
- Java · Les 4 · Basis · Versie: 2
- Java · Les 6 · Basis · Versie: 2
- Java · Les 69 · Basis · Versie: 2